tastytea/hugo-theme-nocolor
Archived
1
0
Fork 0
Code Issues Pull Requests Releases Activity
[MOVED to codeberg] Hugo theme with no predefined colors and minimal styling. https://codeberg.org/tastytea/hugo-theme-nocolor
This repository has been archived on 2024-09-02. You can view files and clone it, but cannot push or open issues or pull requests.
55 Commits 1 Branch 8 Tags 662 KiB
HTML 85.5%
CSS 14.5%
f0812e3ab8
Go to file
tastytea f0812e3ab8
Add <hr> between menus and content.
2020-12-29 02:26:52 +01:00
archetypes Add toc options to AsciiDoc archetype. 2020-12-27 20:51:01 +01:00
assets Move CSS from static/assets/ to assets/. 2020-12-28 20:30:34 +01:00
images Add screenshot. 2020-12-28 20:35:27 +01:00
layouts Add <hr> between menus and content. 2020-12-29 02:26:52 +01:00
.editorconfig Add EditorConfig. 2019-11-20 23:52:38 +01:00
CODE_OF_CONDUCT.adoc Add COC and contributing guidelines. 2019-11-20 23:45:46 +01:00
CONTRIBUTING.adoc Add COC and contributing guidelines. 2019-11-20 23:45:46 +01:00
LICENSE Add LICENSE. 2019-11-20 22:40:09 +01:00
README.adoc Add section about syntax highlighting with AsciiDoc. 2020-12-28 18:56:45 +01:00
theme.toml Fix original author info. 2020-12-28 20:43:31 +01:00

README.adoc

nocolor

nocolor is a Hugo theme with no predefined colors and minimal styling. It is based on Slick.

Features

  • Supports taxonomies of tags, categories and series with their own pages.

  • RSS Feed with complete entries.

  • Open Graph, Schema.org and Twitter Cards support.

  • Fully customizable menu entries.

  • No JavaScript, no bundled fonts, no external requests.

  • Ability to inject own CSS file.

Installation

git submodule add --branch main https://schlomp.space/tastytea/hugo-theme-nocolor.git themes/nocolor
echo 'theme = "nocolor"' >> config.toml

Update with git submodule update --remote. If you don’t keep your blog in a git repository, install it with git clone https://schlomp.space/tastytea/hugo-theme-nocolor.git themes/nocolor or unpack the archive into themes/nocolor.

Configuration & Modification

Please take a look at the configuration example for Slick. It is valid for nocolor too.

You can add things to the end of the <head> section by overwriting the partial template extra-head.html or above the footer by overwriting extra_foot.html. The common way to do it is to create layouts/partials/extra_head.html or layouts/partials/extra_foot.html, respectively.

Syntax highlighting with Asciidoctor

If you want source code highlighting with AsciiDoc, you’ll need pygmentize from the package pygments. Set this in your config file:

config.toml
pygmentsCodefences = true
pygmentsCodeFencesGuessSyntax = false
pygmentsUseClasses = true

Run pygmentize -L styles for a list of available styles and generate a CSS file:

pygmentize -f html -S <style> -a .highlight \
           | grep -v '^[^\.]' | sed -E 's/ \.(\w+) \{/ \.tok-\1 {/' > static/syntax.css

And add :source-highlighter: pygments at the top of your posts, below the front matter. Make sure to include the generated CSS file.

Good to know

Table of contents are only written when the word count exceeds 400 and the toc field in your content’s front matter is set to true. See the Hugo documentation for details. You can overwrite the template by adding the file layouts/partials/toc.html to your blog.