getzola / hyde

Port of https://github.com/poole/hyde to Zola
MIT License
78 stars 51 forks source link

hyde

Hyde is a brazen two-column Zola based on the Jekyll theme of the same name that pairs a prominent sidebar with uncomplicated content.

Hyde screenshot

Contents

Installation

First download this theme to your themes directory:

cd themes
git clone https://github.com/getzola/hyde.git

and then enable it in your config.toml:

theme = "hyde"

Options

Sidebar menu

Set a field in extra with a key of hyde_links:

[extra]
hyde_links = [
    {url = "https://google.com", name = "Google.com"},
    {url = "https://google.fr", name = "Google.fr"},
]

Each link needs to have a url and a name.

Sticky sidebar content

By default Hyde ships with a sidebar that affixes it's content to the bottom of the sidebar. You can optionally disable this by setting hyde_sticky to false in your config.toml.

Themes

Hyde ships with eight optional themes based on the base16 color scheme. Apply a theme to change the color scheme (mostly applies to sidebar and links).

Hyde in red

There are eight themes available at this time.

Hyde theme classes

To use a theme, set the hyde_theme field in config.toml to any of the themes name:

[extra]
hyde_theme = "theme-base-08"

To create your own theme, look to the Themes section of included CSS file. Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors.

Reverse layout

Hyde with reverse layout

Hyde's page orientation can be reversed by setting hyde_reverse to true in the config.toml.