๐ Jekyll theme for building a personal knowledge repository and blog
MIT License
Jekyll Knowledge Base / Blog Theme that provides wiki style linking, full text search and automatically generated post organization pages.
With Gem-based themes, directories such as the assets
, _layouts
, _includes
, and _sass
are stored in the themes gem, hidden from your immediate view. Yet all of the necessary directories will be read and processed during Jekylls build process.
This allows for easier installation and updating as you don't have to manage any of the theme files. To install:
Add the following to your Gemfile
:
gem "domain-jekyll"
Fetch and update bundled gems by running the following Bundler command:
bundle
Set the theme
in your project's Jekyll _config.yml
file:
theme: domain-jekyll
To update the theme run bundle update
.
Remote themes are similar to Gem-based themes, but do not require Gemfile
changes or whitelisting making them ideal for sites hosted with GitHub Pages.
To install:
Create/replace the contents of your Gemfile
with the following:
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins
Fetch and update bundled gems by running the following Bundler command:
bundle
Add remote_theme: "Lumunix/Domain"
to your _config.yml
file. Remove any other theme:
or remote_theme:
entry.
For detailed instructions on how to configure, customize, read the theme's documentation.
Included in the repository is a docker-compose file that creates a container from the the official Jekyll Docker Image. This will allow you to setup a development environment without having to install Ruby and Jekyll manually and allow you to quickly test and preview changes.
Fork this repo. Clone it to your machine.
Install Docker/Compose. You must have Docker and Compose installed.
In the directory you downloaded the project, open terminal and run the following command docker compose up
.
You should now be able to go to your web browser and view the site Here