Install Hyde theme on Jekyll version 3
Archived guide to installing the Hyde Jekyll theme and resolving compatibility issues with Jekyll 3.
Archived post: This is an old post from my previous web blog. Read the original.
It would be logic to write my first post with talk about how I started my blog by installing the Hyde Theme by Mark Otto, because I have some troubles with compatibility of this theme on jekyll 3.
So, first of all go to http://jekyllthemes.org/ and find a hyde theme (not hydeout). There is not an search on a site, so you can go directly on https://github.com/poole/hyde if you`re lazy to browse all existing themes. I will just included some official documentation here:
Built on Poole
Poole is the Jekyll Butler, serving as an upstanding and effective foundation for Jekyll themes by @mdo. Poole, and every theme built on it (like Hyde here) includes the following:
- Complete Jekyll setup included (layouts, config, 404, RSS feed, posts, and example page)
- Mobile friendly design and development
- Easily scalable text and component sizing with
remunits in the CSS - Support for a wide gamut of HTML elements
- Related posts (time-based, because Jekyll) below each post
- Syntax highlighting, courtesy Pygments (the Python-based code snippet highlighter)
Hyde features
In addition to the features of Poole, Hyde adds the following:
- Sidebar includes support for textual modules and a dynamically generated navigation with active link support
- Two orientations for content and sidebar, default (left sidebar) and reverse (right sidebar), available via
<body>classes - Eight optional color schemes, available via
<body>classes
Head to the readme to learn more.
Browser support
Hyde is by preference a forward-thinking project. In addition to the latest versions of Chrome, Safari (mobile and desktop), and Firefox, it is only compatible with Internet Explorer 9 and above.
Installation
So, clone the project from github: git clone https://github.com/poole/hyde.git and cd into downloaded folder. Check out your current version of jekyll (if you didn’t installed it yet, go to https://jekyllrb.com/) : jekyll --version For me it’s `jekyll 3.8.3
Now if you try to running a server by taping jekyll serve you will have a warning:
Deprecation: Pagination is enabled, but the
jekyll-paginategem is not included. Ensureplugins: [jekyll-paginate]is in your configuration.
And the error:
Since Jekyll 3.0, permalinks for pages in subfolders must be relative to the site source directory, not the parent directory. See the Jekyll upgrade guide. So, the permalinks are deprecated in version 3 - we can remove a line
relative_permalinks: truefrom _config.yml and add this in the end of the file:
plugins:
- jekyll-paginate
- jekyll-gist
- redcarpet
Now check out list of local gems: gem list
If you don’t have a redcarpet, you need to install it: sudo gem install redcarpet
Finally, try to run a server once again: jekyll serve and go to localhost:4000. Normally, you must see an index page of hyde theme.
If you have any troubles, post it in comments and happy coding!