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.
