This is the documentation home for authors writing content on this site. It covers everything you need to create posts — from plain Markdown articles to interactive visual essays with zoomable images, maps, video, and text-driven interactions.
New here? Start with the Authors Guide — it walks you through creating, previewing, and publishing your first post entirely from GitHub’s web interface. If you are brand new to GitHub and Markdown as well, the Authoring a Visual Narrative tutorial assumes no prior experience at all and takes you from creating a GitHub account to publishing a first essay.
The guides are organized in the order most authors need them:
| Guide | What it covers | |—|—|
| PHL Authoring a Visual Narrative | The Plant Humanities Lab classroom workflow, sandbox repository, review, and publishing process |
| Authoring a Visual Narrative | A start-to-finish tutorial for first-time authors — no GitHub, Jekyll, or Markdown experience assumed |
| Entreluma Overview | What Entreluma is, what it adds, and how it is enabled |
| Authors Guide | Creating, previewing, and publishing a post step by step |
| Preview Setup | Editor setup, GitHub connection, bookmarklet, and preview boundaries |
| Formatting Tips | Controlling viewer size, position, and text wrapping |
The Entreluma Editor is a browser-based Markdown editor for Entreluma posts: live preview, viewer-tag autocomplete, drag-and-drop media, and GitHub sync. One central editor serves every Entreluma repository; sign in with GitHub when you need private-repository access or want to commit changes.
Viewers are the interactive elements you add to a post with a simple include tag. The Viewers Overview lists them all at a glance; each then has its own reference page:
| Guide | Viewer |
|---|---|
| Image Viewer | Zoomable, pannable high-resolution images (incl. Wikimedia Commons and IIIF) |
| Map Viewer | Interactive maps with markers, overlays, and fly-to actions |
| Image Compare Viewer | Before/after image slider with alignment tools |
| YouTube Viewer | Clean video previews with timed playback actions |
| Vimeo Viewer | Vimeo poster previews, expanded playback, and timed playback actions |
| Network Viewer | Node-and-edge relationship diagrams from simple CSV data |
| Iframe Viewer | Embed any external web page or widget |
| Entity Info Popups | Contextual popups powered by Wikidata |
| Guide | What it covers |
|---|---|
| Action Links | The complete reference for making text trigger viewer actions |
| Display Modes | Flat pages vs. the two-column scrollytelling layout |
The Troubleshooting Guide covers the most common problems — a viewer that shows nothing, an action link that does nothing, images that don’t update — and how to fix them.
Most content authors do not need to understand HTML, CSS, or JavaScript.
If you are comfortable writing basic Markdown and copying small snippets of example code, you have all the technical background required. The examples in these guides are meant to be copied directly into your own posts and adapted.
This site is built on the Chirpy Jekyll theme. Chirpy provides the publishing engine — layouts, navigation, typography, tags, and categories — and Entreluma adds the interactive storytelling layer on top. For theme-level topics not covered here (site configuration, favicons, advanced typography), see the official Chirpy documentation.
A start-to-finish guide for participants creating interactive visual narratives on the Plant Humanities Lab platform. Covers what Entreluma is and where it came from, the GitHub workflow you'll use to draft and publish, the Markdown you'll write, and every Entreluma viewer the platform offers.
A start-to-finish guide for students creating their first interactive visual narrative on an Entreluma site. Covers what Entreluma is and where it came from, the GitHub workflow you'll use to draft and publish, the Markdown you'll write, and every Entreluma viewer the platform offers.
An introduction to Entreluma — a Markdown-first framework for adding interactive viewers and text-driven media interactions to a Jekyll + Chirpy site. This overview explains Entreluma origins, how it fits into the existing architecture, and how it is enabled and configured for individual posts.
A practical guide for writing, previewing, and publishing Entreluma posts with the Entreluma Editor and GitHub. It explains front matter, media folders, asset references, preview, and publishing.
Set up the Entreluma Editor for live preview, GitHub access, and one-click opening from GitHub.
Tips for formatting Entreluma posts.
A one-page tour of every Entreluma viewer — what each one does, when to use it, and where to find its full reference guide.
How to use the Entreluma image viewer in your Markdown posts.
How to use the Entreluma map viewer in your Markdown posts.
How to use the Entreluma Image Compare viewer in your Markdown posts.
How to use the Entreluma YouTube viewer in your Markdown posts.
How to use the Entreluma network viewer to draw node-and-edge relationship diagrams from simple CSV data in your Markdown posts.
How to use the Entreluma Vimeo viewer in your Markdown posts.
How to embed external web pages, exhibits, and widgets in your Markdown posts with the Entreluma iframe viewer.
How to create rich information popups using Wikidata entities in Entreluma.
The complete reference for action links — the Markdown links that let your text zoom images, fly maps, and play video segments.
How Entreluma posts can be presented — as a traditional flat page or as a two-column scrollytelling layout — and how to choose and configure each mode.
Fixes for the most common problems authors hit — blank viewers, action links that do nothing, images that won't update, and popups that never load.