Programming Quotes is a minimal Hugo boilerplate that demonstrates reveal-hugo, a Reveal.js theme for Hugo, by shipping a ready-to-edit slide deck filled with programming quotes and a live demo on Netlify.
What is Programming Quotes?
Programming Quotes is a demo presentation and boilerplate repository for the reveal-hugo theme, which brings Reveal.js slides into Hugo sites. It takes one markdown file — content/_index.md — as its input and renders it as a browser-based, arrow-key-navigable slide deck. The project runs on the Hugo static site generator and the Reveal.js HTML presentation framework, and it was published by dzello, the developer behind reveal-hugo. The repository is intentionally dead-simple: there are no build tools beyond Hugo itself, no JavaScript configuration, and no extra dependencies beyond the theme submodule.
Key Features
The following features are directly visible in the repository structure and its documentation.
- Reveal.js slides in Hugo — Every markdown section in content/_index.md becomes a slide rendered through reveal-hugo's integration with Reveal.js.
- Submodule-based theme — The reveal-hugo theme is included as a git submodule, so cloning with --recurse-submodules pulls everything needed for the demo to run.
- Live demo included — A deployed version of the slides is hosted at programming-quotes.netlify.com so you can preview the output before cloning.
- Dead-simple setup — Only three commands are required to run locally: clone with submodules, run hugo server, and open localhost:1313.
- Single content file — All slides live in one markdown file (content/_index.md), making the structure easy to inspect and adapt.
- Hugo-based static output — The final presentation is a set of static HTML files, so it can be hosted anywhere Hugo sites are deployed, including Netlify, GitHub Pages, or any static server.
Who is it for?
The target audience is anyone wanting to see reveal-hugo in action with minimal effort.
- Hugo developers who want a minimal, working example of how reveal-hugo structures slides and builds a Reveal.js presentation.
- Technical speakers who already use Hugo for a blog or site and need a quick way to produce a slide deck from markdown for conferences or meetups.
- Open-source learners who want to study a small, real-world repository that combines Hugo, Reveal.js, and a git submodule workflow.
Use cases
The demo can be adapted for several concrete scenarios.
- Create a quote-based presentation: Replace the programming quotes in content/_index.md with your own content and regenerate a slide deck with the same structure.
- Prototype reveal-hugo features: Use the demo as a scratchpad to experiment with Reveal.js themes, transitions, and layouts before committing to a full presentation.
- Learn Hugo submodule workflows: The repository is a practical reference for cloning and maintaining a Hugo site whose theme lives as a git submodule.
How does Programming Quotes work?
Running the demo involves four steps.
- Install Hugo using any of the methods listed in the Hugo installation docs.
- Clone the repository with git clone --recurse-submodules so the reveal-hugo theme is fetched as a submodule.
- Run hugo server from the project directory and open the local URL shown in the terminal output.
- Edit the markdown in content/_index.md and Hugo will rebuild the slides automatically.
