cb-oralhistory is a mix of CollectionBuilder-CSV and Oral History as Data (OHD). It's meant to serve as a starter repository for those wanting to build oral history collections with CollectionBuilder.
The current demo site features a small mix of transcripts. Item pages are generated by a CSV metadata file that includes the display_template "transcript" as a field.
Oral History as Data (OHD) provides a static web framework for users to publish and analyze coded oral history and qualitative interviews on the web.
Oral History as Data was first built in 2018, coming out of work at the University of Idaho Library's Center for Digital Inquiry and Learning (CD?L). The framework served as the foundation for several digital humanities projects, including Voices of Gay Rodeo, Idaho Queered, and CTRL+Shift.
The look for OHD is different than CollectionBuilder. Check out the a demo site to see the differences.
There is some documentation for OHD that might be helpful in this context. More fully developed documentation for this project is being developed, but there are several places linked here to get you started.
CollectionBuilder-CSV is a robust and flexible "stand alone" template for creating digital collection and exhibit websites using Jekyll and a metadata CSV. Driven by your collection metadata, the template generates engaging visualizations to browse and explore your objects. The resulting static site can be hosted on any basic web server (or built automatically using GitHub Actions).
Visit the CollectionBuilder Docs for step-by-step details for getting started and building collections!
The CollectionBuilder Docs contain detailed information about building a collection from start to finish--including installing software, using Git/GitHub, preparing digital objects, and formatting metadata. However, here is a super quick overview of the process:
- Make your own copy of this template repository by clicking the green "Use this Template" button on GitHub (see repository set up docs). This copy of the template is the starting point for your "project repository", i.e. the source code for your digital collection site!
- Prepare your collection metadata following the CB-CSV template (see our demo metadata template on Google Sheets and metadata docs). Your metadata will include links to your digital files (images, pdfs, videos, etc) and thumbnails wherever they are hosted.
- Add your metadata as a CSV to your project repository's "_data" folder (see upload metadata docs).
- Edit your project's "_config.yml" with your collection information (see site configuration docs). Additional customization is done via a theme file, configuration files, CSS tweaks, and more--however, once your "_config.yml" is edited your site is ready to be previewed.
- Generate your site using Jekyll! (see docs for how to use Jekyll locally and deploy on the web)
Please feel free to ask questions in the main CollectionBuilder discussion forum.
If you put timestamp in your transcript .CSV files (we highly recommended that you do) please make sure they use full [hh:mm:ss] notation! You may omit the hh: portion for timestamps of less than an hour, but make sure you always specify a full mm:ss notation. For example, 9-minutes 7-seconds should never be specified as [9:7] or even [9:07], the proper form is [00:09:07] but [09:07] will also work.
Handling dates in metadata can be tricky and remember that information you enter in your metadata .CSV file comes into the framework as text, not as any other data type (so there are no date type variables). This makes custom formatting of things like dates especially tricky. Consequently, you won't find a lot of date formatting in CB, for the most part it will display exactly what you entered.
This can also present difficulties if you want to sort on something like a date field. So it's recommended that you always enter dates in the form yyyy (only the year), or yyyy-mm (year and month), or yyyy-mm-dd (a complete discrete date). Doing so will ensure that your dates make sense when displayed AND they will sort properly too.
https://collectionbuilder.github.io/
CollectionBuilder is a project of University of Idaho Library's Digital Initiatives and the Center for Digital Inquiry and Learning (CDIL) following the Lib-Static methodology. Powered by the open source static site generator Jekyll and a modern static web stack, it puts collection metadata to work building beautiful sites.
The basic theme is created using Bootstrap. Metadata visualizations are built using open source libraries such as DataTables, Leafletjs, Spotlight gallery, lazysizes, and Lunr.js. Object metadata is exposed using Schema.org and Open Graph protocol standards.
Questions can be directed to [email protected]
CollectionBuilder documentation and general web content is licensed Creative Commons Attribution-ShareAlike 4.0 International.
This license does NOT include any objects or images used in digital collections, which may have individually applied licenses described by a "rights" field.
CollectionBuilder code is licensed MIT.
This license does not include external dependencies included in the assets/lib directory, which are covered by their individual licenses.