Skip to content

basil/antora-default-ui-hugo-theme

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Antora Default UI Hugo Theme

GitHub contributors GitHub stars GitHub forks MPL 2.0 License

A Hugo theme based on the Antora default UI, with full support for Asciidoctor. (Demo)

Screenshot

screenshot

Prerequisites

Before starting, ensure that you have installed Hugo and created a new site.

Also ensure that you have installed Asciidoctor.

Installation

Clone the theme repository from GitHub into your site's themes directory:

$ git clone https://github.com/basil/antora-default-ui-hugo-theme.git themes/antora-default-ui-hugo-theme

Alternatively, add the theme as a Git submodule:

$ git submodule add https://github.com/basil/antora-default-ui-hugo-theme.git themes/antora-default-ui-hugo-theme

Then, add the theme to your site's configuration file (config.toml):

theme = "antora-default-ui-hugo-theme"

For more information, consult the Hugo documentation.

Configuration

Configure the Asciidoctor attributes in your site's configuration file (config.toml) for use with this theme:

[markup]
  [markup.asciidocext]
    [markup.asciidocext.attributes]
      "icons" = "font"
      "source-highlighter" = "highlightjs"
  [markup.highlight]
    # Disable Goldmark Chroma syntax highlighter
    codeFences = false

Optionally, configure a description and keywords for the home page:

[params]
  description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
  keywords = ["foo", "bar"]

Optionally, configure a copyright message and year for the footer:

copyright = "<name>. All rights reserved."

[params]
  since = <year>

Optionally, configure a URL for use with the Edit this page feature:

[params]
  editThisPage = "https://github.com/organization/repository/edit/master/content/"

Customization

Custom CSS can be added to assets/css/custom.css.

Syntax Highlighting

This theme uses highlight.js for syntax highlighting. The version of highlight.js shipped in this theme supports all of the highlight.js common languages and AsciiDoc. To add support for additional languages, download a custom package with the desired languages and place it in assets/js/vendor/highlight.pack.js.

License

Released under the Mozilla Public License, Version 2.0 (MPL-2.0).

Acknowledgements

About

A Hugo theme based on the Antora default UI, with full support for Asciidoctor

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published