Project

jekyll-theme-hyde

4.77
No release in over 3 years
Low commit activity in last 3 years
jekyll-theme-hydepoole/hydeHomepageDocumentationSource CodeBug Tracker
Hyde is a brazen two-column Jekyll theme that pairs a prominent sidebar with uncomplicated content.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
4,708
Stars
3,607
Forks
2,710
Watchers
65
 Releases
Current version
2.0.0
Total releases
1
First release
2016-12-19
Latest release
2016-12-19
 Issues
Open Issues
25
Closed Issues
85
Total Issues
110
Issue Closure Rate
77%
 Pull Requests
Open Pull Requests
16
Closed Pull Requests
170
Merged Pull Requests
17
Pull Request Acceptance Rate
8%
 Development
Primary Language
CSS
Licenses
MIT
Average date of last 50 commits
2014-05-12
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.13
rake
~> 12.0

Runtime

jekyll
~> 3.3
 Project Readme

Hyde

Hyde is a brazen two-column Jekyll theme that pairs a prominent sidebar with uncomplicated content. It's based on Poole, the Jekyll butler.

Hyde screenshot

Contents

  • Usage
  • Options
    • Sidebar menu
    • Sticky sidebar content
    • Themes
    • Reverse layout
  • Development
  • Author
  • License

Usage

Hyde is a theme built on top of Poole, which provides a fully furnished Jekyll setup—just download and start the Jekyll server. See the Poole usage guidelines for how to install and use Jekyll.

Options

Hyde includes some customizable options, typically applied via classes on the <body> element.

Sidebar menu

Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page's front-matter.

---
layout: page
title: About
---

Why require a specific layout? Jekyll will return all pages, including the atom.xml, and with an alphabetical sort order. To ensure the first link is Home, we exclude the index.html page from this list by specifying the page layout.

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 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>

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, add anyone of the available theme classes to the <body> element in the default.html layout, like so:

<body class="theme-base-08">
  ...
</body>

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 with a single class.

<body class="layout-reverse">
  ...
</body>

Development

Hyde has two branches, but only one is used for active development.

  • master for development. All pull requests should be submitted against master.
  • gh-pages for our hosted site, which includes our analytics tracking code. Please avoid using this branch.

Author

Mark Otto

License

Open sourced under the MIT license.

<3