It's easy to create a theme, you just have to create a new folder. To start using your theme,modify the
theme setting in your site's
theme: ./src # or from a npm package # call `saber-theme-simple`: theme: simple
A theme should have following folder structure:
. ├── saber-browser.js # optional ├── saber-node.js # optional └── layouts # required
Theme layouts are populated under
$theme/layouts directory and this directory is required, layouts in
$projectRoot/layouts will still work and take higher priority.
There are already a number of themes available for you to play with. If you decide to make your own theme, feel free to create a pull request adding it here!
- Minima - Port of the default Jekyll theme by egoist.
- Tailsaw - Port of the Jigsaw starter theme by krmax44.
- Paper - A simple theme like a paper by geekplux.
- Ume - An elegant blog theme by iCyris.
We are also working on adding a page on this site to showcase all the themes.
If you are using a theme from npm and wish to modify it to better suit your needs, you might want to eject it. This will copy over its source code to
./theme, allowing you to edit it.
The above command will use the files from
node_modules, but if you want the source code from the repository instead, add the
--git flag. This will clone the theme's Git repository as a submodule, which adds the benefits of easier upgradability, contribution to the upstream code and better version control management.