Copyright 2020 Marcel Artz
Enfield Jekyll Theme is a gem based dark theme for Jekyll sites. It is forked from beatiful-jekyll but instead of expanding the theme's feature set, Enfield actually removes a bit of the feature set:
- removing google fonts
- removing google analytics
- removing google tagmanager
- removing disqus comments
- removing facebook comments
- disabling social shares by default
- the gem jekyll-github
- removing the light theme
But don't worry, it adds new features, too:
- adding only gem plugins that are eventually used
- adding the dark theme (based on material desgin)
- adding page for impress and privacy statement
- enhancing the way how images are presented
- adding a new color scheme for syntax highlighting
- adding a 'related posts' section at the bottom of each post
not for GitHub Pages!
Add this line to your Jekyll site's Gemfile
:
gem "enfield-jekyll-theme"
And add this line to your Jekyll site's _config.yml
:
theme: enfield-jekyll-theme
And then execute:
$ bundle
Or install it yourself as:
$ gem install enfield-jekyll-theme
for GitHub Pages
Bug reports and pull requests are welcome on GitHub at https://github.com/ma744/Enfield. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
To set up your environment to develop this theme, run bundle install
.
Your theme is setup just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve
and open your browser at http://localhost:4000
. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
When your theme is released, only the files in _layouts
, _includes
, _sass
and assets
tracked with Git will be bundled.
To add a custom directory to your theme-gem, please edit the regexp in enfield-jekyll-theme.gemspec
accordingly.
The Enfield Jekyll Theme supports some Jekyll plugins by default. Most of them can be enabled / disabled or modified in the _config.yml file without the need of touching the code.
Please have a look at Beatiful Jekyll's readme for more information on existing features that are not mentioned in this readme in order to avoid redundant informations.
setting customized canonical urls
https://github.com/jekyll/jekyll-mentions
https://github.com/jekyll/jekyll-gist
https://github.com/jekyll/jekyll-feed
https://github.com/benbalter/jekyll-relative-links
https://github.com/hendrikschneider/jekyll-analytics
Matomo is the only supported analytics service per default.
https://github.com/jekyll/jekyll-redirect-from
The theme is available as open source under the terms of the MIT License.
https://jekyllrb.com/docs/themes/
Thanks to Dean Attali for creating Beatiful Jekyll. I have chosen to fork Beatiful Jekyll to spend less time in creating a theme for my website. The great structure of the project itself was the main reason for me to choose Beatiful Jekyll as base theme for my modifications. (Just to let you know: in difference to some others it complies with most of Jekyll's naming conventions which was quite helpful :) )
- add favicon
- add theme as gem to jekyll open directory
- testing staticman comment (how does it fit to the dark theme?)
- refactor pygment_highlights.css
- add fancy file format icons to download section (I need svg that are congenial)
- refactor opg-support