If you just want to read - this might look better: https://oliver.bestwalter.de.

3rd party packages in packages are git submodules, so cloning this repo completely means:

$ git clone --recurse-submodules <url of this repo>

add submodules later after normal clone:

$ git submodule update --init.

update submodules:

$ git submodule update --remote <repo name>

add new plugin:

$ git submodule add <repo url>
$ git commit -am 'add <repo name>
$ git push origin master

The officially recommended way is weird and the way lektor deals with plugins is extra weird. I work from a local lektor clone with my own little server wrapper to be make it easier to debug and modify.

$ cd /path/to/here
$ pip install tox
$ tox -e dev

All things worth doing are accessible via tox:

$ tox -av

shows what's on offer

• created with

  • Lektor
  • (some articles) Jupyter notebooks
  • old skool sass
  • no javascript

• served via Github Pages

• helpful tools

  • google webfonts helper (TTF versions need to be downloaded extra from somewhere else though :()
  • name that color
  • interactive CSS tools
  • color blender
  • pygments, pygmentize

The inbuilt pygments plugin has a bug (creates wrong class name 'highlight' instead of 'hll'). For now I use my own stylesheet with adapted class name.

Hint: list themes with pygmentize -L and generate css files with pygmentize -S <theme name> -f html > <file name>.css

When getting LoadError: cannot load such file -- rb-fsevent run:

gem install rb-fsevent

• https://iamvdo.me/en/blog/css-font-metrics-line-height-and-vertical-align
• https://font-display.glitch.me/
• https://www.w3.org/Style/Examples/007/units.en.html

Code is under MIT license and content is CC BY-NC-SA 4.0. If code is integrated that has a different license the license is included in the source here and their license apply.