0.0
No release in over 3 years
Low commit activity in last 3 years
jekyll-notes is a jekyll theme for taking notes, files and direcroties automatically gets generated in submenu.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.16
~> 12.0

Runtime

 Project Readme

Jekyll-notes

Jekyll-notes is a Jekyll theme for managing notes.
Simply create _chapters folder and populate it with subfolders and notes.
The .md files with "layout: default" would appear at Notes page submenu.

Screenshot

drawing

Installing

Using gem

Gemfile

gem "jekyll-notes"

_config.yml

theme: jekyll-notes

collections:
        sections:
                output: false
        chapters:
                output: true

Run bundle install

Create _chapters folder and make .md files inside.

---
layout: default
---

Change index.markdown from layout: home to layout: default

Installing using jekyll-remote-theme

  1. Edit Gemfile
group :jekyll_plugins do
  gem "jekyll-remote-theme"
end
  1. Edit _config.yml
plugins:
  - jekyll-remote-theme

remote_theme: alexz005/jekyll-notes

collections:
        sections:
                output: false
        chapters:
                output: true
  1. Create _chapters folder and make .md files inside.

Debugging locally

Gemfile

group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
  gem "jekyll-notes", :path => "../../jekyll-notes/"
end

_config.yml

theme: jekyll-notes
collections:
        sections:
                output: false
        chapters:
                output: true

Advantages

Contents are stored in _chapters folder and any subfolder and its files are automatically seen in submenu. The notes have to mantain yaml structure though, including three dashes and layout: default.

Menu automatically generates with subfolders, isn’t it neat?

Building and testing locally

This site is using Jekyll/SCSS
bundle exec jekyll serve --port 8080

Used sources

Following were used to build this theme:

  1. Parts of theme Milidocs by Alexander Heimbuch
  2. Collapsable list Javascript code from here by Kate Morley
  3. JavaScript code to generate menu from here
  4. JavaScript code to search through the list from here
  5. Parts of startbootstrap

License

MIT license, except any copied code or parts used above.

Have you found it useful? Give me a star or fork this!