Hyde is a brazen two-column hugo theme based on the Jekyll theme of the same name. It pairs a prominent sidebar with uncomplicated content.
To give you a running start this installation puts a fully configured starter repo into your Git account and sets it up in a content manager / CMS.
Forestry Starter-Kit:
Import this project into Forestry
To install Hyde as your default theme, first install this repository in the themes/ directory:
$ cd themes/
$ git clone https://github.com/spf13/hyde.git
Second, specify hyde as your default theme in the config.toml file. Just add the line
theme = "hyde"
at the top of the file.
Hyde includes some customizable options, typically applied via classes on the <body> element.
Create a list of nav links in the sidebar by assigning "menu=main" in the front matter, like so:
TOML
theme = "hyde" [Menus] main = [ {Name = "Github", URL = "https://github.com/username/"}, {Name = "LinkedIn", URL = "https://www.linkedin.com/in/username/"} ]
YAML
theme: "hyde" menus: main: - name: Github url: https://github.com/username/ - name: LinkedIn url: https://www.linkedin.com/in/username/
Customise the describe of your page using description, like so:
TOML
theme = "hyde" [params] description = "Your custom description"
YAML
theme: hyde params: description: Your custom description
By default Hyde ships with a sidebar that affixes it's content to the bottom of the sidebar. You can optionally disabled this by removing the .sidebar-sticky class from the sidebar's .container. Sidebar content will then normally flow from top to bottom.
<!-- Default sidebar --> <div class="sidebar"> <div class="container sidebar-sticky"> ... </div> </div> <!-- Modified sidebar --> <div class="sidebar"> <div class="container"> ... </div> </div>
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).
There are eight themes available at this time.
To use a theme, add the themeColor variable under params, like so:
TOML
theme = "hyde" [params] themeColor = "theme-base-09"
YAML
theme: hyde params: themeColor: theme-base-09
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.
To reverse page orientation, add the layoutReverse variable under params, like so:
TOML
theme = "hyde" [params] layoutReverse = true
YAML
theme: hyde params: layoutReverse: true
Add a file to assets/css/custom.css in your Hugo project and it will be appended to the CSS bundle.
You can optionally enable a comment system powered by Disqus for the posts. Simply add the variable disqusShortname to your config file.
TOML
disqusShortname = "spf13"
YAML
disqusShortname: spf13
Note: Previous version 1.0 the Disqus shortname had to be defined inside the
[params]block.
Google Analytics can be enabled by assigning your tracking code to the googleAnalytics variable in the config file:
TOML
googleAnalytics = "Your tracking code"
YAML
googleAnalytics: Your tracking code
Mark Otto
Steve Francia
Open sourced under the MIT license.
<3