Oral History (as) Data

Analyze and publish coded oral history and qualitative interviews

Common Issues

Common Issues

The Website Isn’t Showing Up!

This problem is usually caused by having the wrong settings in the “URL settings” section of the _config.yml.

Check the variables provided and make sure that the url and baseurl are correctly formatted.

More in the documentation

My Audio/Video File isn’t Connected

  • Check the markdown file for your transcript.
    • Is the correct AV Source designated?
    • if it is, is the source in lowercase? It needs to be!
  • Check the AV ID and see if that matches the ID you are trying to connected. Soundcloud has a specific way of connecting, and we need either a full link or relative link (if the mp3 is stored on the website).
  • Check the permissions on your file.
    • For instance, YouTube videos need to be either unlisted or public for the tool to access them.

More on connecting AV files here.

My transcript pages aren’t showing up

  • Is your CSV file correctly formatted?
    • check this by going to the file on the GitHub.com website and seeing if it shows up on the page in a table.
    • if it doesn’t, and you get an error message from GitHub about the CSV, check the line it references and try to fix it.
  • Is the content in the right format and listed in the right columns?
    • The content needs to be in the words field.

More on setting up your transcript CSVs correctly here.

The Visualization and/or browsing dropdown isn’t working

  • make sure you have a filters.csv file in your _data\ folder.
  • make sure that file is correctly formatted.
  • make sure that the shorthand codes you use in your transcript CSV match up with the information in that file.

More on setting up your filters.csv correctly here.

Other Problems