Overview

Reveal-hugo is a Hugo theme for Reveal.js that simplifies the process of authoring and customizing HTML presentations. By utilizing properly-formatted Hugo content, users can easily create presentations with multiple slides. The theme requires Hugo version >= v0.93.0 for optimal compatibility. The theme’s documentation provides examples and tutorials on creating presentations, as well as showcasing different functionalities available.

Features

• Simplified authoring and customization of HTML presentations
• Ability to create presentations with multiple slides using just one markdown file
• Compatibility with Hugo version >= v0.93.0
• Customizable themes and styles
• support for additional Reveal.js plugins
• Option to use Hugo’s compile-time syntax highlighter

Installation

To install the reveal-hugo theme, follow these steps:

1. Install Hugo and create a new Hugo site.

2. Change into the directory of the new site.

3. Initialize a git repository.

4. Method 1 (recommended): Use theme as a hugo module.

   • Turn your new skeleton site into a hugo module by issuing this command from the site root:

     hugo mod init github.com/<your-username>/<your-project-name>
     

   • Declare the reveal-hugo theme module as a dependency of your site:

     hugo mod get github.com/dzello/reveal-hugo@latest
     

   • Open config.toml and add the following line:

     theme = ["github.com/dzello/reveal-hugo"]
     

5. Method 2 (traditional): Use theme as a git submodule.

   • Add the reveal-hugo theme as a submodule in the themes directory:

     git submodule add https://github.com/dzello/reveal-hugo.git themes/reveal-hugo
     

   • Open config.toml and add the following line:

     theme = "reveal-hugo"
     

6. Configure your presentation by adding more contents to the config.toml. Specify the reveal-hugo theme and register the “Reveal” output format.

7. Create a file in content/_index.md and add the required content.

8. Run the following command on the command line:

   hugo server
   

9. Navigate to the specified URL to view the presentation.

Summary

Reveal-hugo is a Hugo theme that simplifies the process of creating HTML presentations using Reveal.js. It allows users to easily create presentations with multiple slides using one markdown file. The theme offers customizable options for themes, styles, and additional Reveal.js plugins. With an installation guide provided, users can quickly get started and create their first presentation using the theme.