Story is a beautiful Hugo theme. Hugo is a static website
generator, which builds websites by rendering
Markdown content into templates from themes like
Story. The resulting site is fast, secure, and easy to build and maintain.
Story is a responsive theme that supports blogs, with many extra features such
as presentations, math and music typesetting, and search. The Story design
philosophy prioritizes simplicity and elegance, so it can be sophisticated
and powerful at the same time.
Story has a lot of features, but most are optional and have smart defaults!
This page is an introduction to Story, with links to further pages that go into
more details. There’s also a listing of features that either don’t need
a separate documentation page, or just don’t have full documentation yet.
Feature flags, which are called classes in the markup, control many of Story’s features.
You can enable and disable them in your site config, or in an individual post’s front matter.
This article documents Story’s feature flags.
Story supports author profiles, so you can highlight your bio.
It’s possible to set this globally for the entire site, or individually for each
piece of content. Or you can set a global default and override it on individual
pieces of content.
Scroll to the bottom of any page on this site to see how author profiles are
styled.
Story can automatically transform images into figures with captions.
It can also add captions to tables.
And it adds features and styling to both images and tables.
This article is a demo of Story’s features for figures, tables, and captions.
Lionel VICTOR is an applied cryptography engineer and an enthusiastic
Story user. He started augmenting the original Hugo’s Story theme
with his own derivative called “Story-Customized”.