Digital Edition Jekyll Theme
Create your annotations on Readux, export your volume as a Jekyll site, and start Jekyll to see your annotated digital edition.
This digital edition Jekyll site makes use of Jekyll Collections to display non-blog content. When you create a site via Readux or import annotated TEI facsimile using teifacsmile-to-jekyll, your site will include the following:
- a volume_pages collection, with content in the
- one html file per page in the volume, with files numbered sequentially
- an annotation collection, with content in the
- one markdown file per annotation; files are numbered by annotation id
- a tag data file in
_data/tags.ymlwith the tags from your annotations
- one markdown page per tag in the
tagsdirectory, for simple access to annotations by tag
The base Jekyll theme also includes placeholder introduction and credits pages, which you can edit to content to your annotated digital edition. Additional pages can be added in a similar fashion.
Note that Jekyll is generally thought of as a blogging platform. That functionality is still available here, of course, but in a somewhat suppressed fashion. If you want to add blog posts to your digital edition, feel free to do so. You will have to determine how and where to integrate them into the site, since they are not curently included.
This Jekyll project includes several options for customization.
All display customizations available in Lanyon are available, including configurable theme and various sidebar display options. See the Lanyon documentation for specifics.
This Jekyll project revises the default Lanyon sidebar logic, which automatically displays all top-level pages alphabetically. To include a page in the sidebar navigation, and to control the order, set a nav_order number in the front matter of the page you want included.
Show an open sidebar on page load by modifying the
<input> tag within the
sidebar.html layout to add the
checked boolean attribute:
Custom Page URLs
The Readux web export and the teifacsimile-to-jekyll script allow you to optionally specify which page in the Readux volume is numbered 1 in the original edition, as a convenience to generate a site with nicer urls. All of the pages before your designated page 1 will be numbered and displayed with the label "Front", but these can be customized. To override page urls, edit the front matter for each page that you want customized and modify the following fields as desired:
- title: used as the label displayed on the individual page, in the HTML header, and as previews for next and previous page links
- short_label: customize the short label prefix used on thumbnail display (default for normal pages is p.)
- number: number to be displayed with the short label on thumbnail views
- permalink: custom url for this page; note that these should always
/pages/and must have a unique value.
By default, this site is set up to embed publication information
on the home page to make your annotated edition easily citable by tools
like Zotero. To customize the citation, you
can edit the publication_info section of your
If you add a publisher or a rights statement, they will be
included in your citation.
OpenGraph and Twitter metadata
The site includes OpenGraph and Twitter card metadata for most pages. The home page uses the site title and configured home page image; if a page has images associated (i.e., volume page images), an image will be included. An excerpt will be included if available, and you can set a custom excerpt by adding one to the Jekyll front matter for any page (other than the home page).