Story is a Hugo theme built for technical writers and speakers who want a clean website to showcase their writing and slide presentations. This static-site theme takes Markdown content and produces responsive pages for blogs, essays, single pages, and RemarkJS-powered slide decks, with built-in mathematics, music notation, and search.
What is Story?
Story is a Hugo theme for showcasing writing and presentations, created by Baron Schwartz. It runs on Hugo, the static site generator, and converts Markdown source files into a complete website with blog posts, essays, presentation slides, and a search page. The theme is no longer actively maintained; the author encourages forking the repository to adapt it further.
Key Features
Story packs many features into a single theme for users who invest effort in their sites. Here are the capabilities documented in the project:
- Responsive typography for print and screen — Long-form content such as blogs, essays, and single pages is typeset with attention to readability, both on displays and when printed.
- RemarkJS slide support — Presenters can write slides with RemarkJS, turning Markdown into HTML presentations that live alongside the rest of the site.
- KaTeX math typesetting — LaTeX-formatted math can be embedded in pages and is rendered client-side with KaTeX, with no separate build step.
- LunrJS-powered search — A built-in search page lets visitors search the site without an external search provider; LunrJS runs entirely in the browser.
- abcjs music notation — Musical scores can be written in ABC notation and typeset automatically via abcjs.
- Markdown enhancements — Extra, backwards-compatible Markdown features allow control over image behavior, such as resizing or floating images using CSS classes.
- Demo site for exploration — A demo site accompanies the theme and can be launched locally with Hugo to explore the features and documentation.
Who is it for?
Story targets technical writers and speakers, including software engineers and open source developers, who want a website for their technical work. These users often write detailed engineering blog posts or give conference talks, and Story gives them a single theme that handles both long-form articles and slide decks.
What can you do with Story?
With Story, users can create a site that combines blogging, slide decks, math, and music notation. Specific use cases include:
- Technical bloggers: Publish long-form essays and software engineering posts using Markdown, with optional KaTeX math for formulas.
- Conference speakers: Build and host HTML slides with RemarkJS, integrating them into the same site as the blog.
- Open source maintainers: Document a project or personal site using Hugo's static site generation and the theme's built-in search.
- Educators and musicians: Add musical notation to any page using abcjs ABC notation, which renders as sheet music in the browser.
FAQ
Frequently asked questions about Story's capabilities and maintenance status:
Is Story still actively maintained?
No, Story is no longer actively maintained. The original author, Baron Schwartz, encourages forking the repository, so individuals can continue to develop the theme on their own.
Does Story support LaTeX math?
Yes, Story integrates KaTeX for LaTeX math typesetting. You can embed math expressions in your Markdown content and they will be rendered in the browser.
Can Story show presentations?
Yes, Story includes support for RemarkJS slides. You can write slide decks in Markdown and view them as HTML presentations within the site.
Does Story have a search feature?
Yes, Story includes a built-in search page powered by LunrJS. LunrJS runs in the browser, so no server-side search engine is required.
Where can I get Story?
Story is hosted on GitHub, and the original author encourages forking. You can download the theme and build it with Hugo.
