Replace docsify with jekyll

[hamoid]

docsify

A JavaScript tool that generates documentation websites on the fly. It does not generate static html files. Instead, it loads and parses Markdown files and displays them as a website.

Requires JavaScript, harder to search. There's 9 pull requests about docsify updates.

jekyll

A Ruby tool that converts Markdown into static html files. Integrated into GitHub.

---

Currently a docker image with docsify is used. Even if GitHub provides Jekyll, a docker image of Jekyll would be good for local testing.

A vague list of tasks:

• read https://github.com/envygeeks/jekyll-docker/blob/master/README.md Maybe this tutorial helps. GitHub pages seems to use Jekyll version 3.9.0. docker pull jekyll/jekyll Copy https://github.com/openrndr/orml/blob/master/docs/run.sh
• delete src/main/resources/docsify and replace with jekyll docker
• rename? port? delete? src/main/kotlin/org/openrndr/dokgen/
• update https://github.com/openrndr/dokgen/blob/master/src/main/kotlin/org/openrndr/dokgen/GradlePlugin.kt
• update README.md
• what theme / css to use? same as ORML?
• add front matter to all markdown files
• update all .kt files adding fun main() and unifying style
• make dev branch become main branch so the source code of the guide is easier to find and to contribute to. The produced content should be in a new generated branch.
• test and deploy

ORML

The https://github.com/openrndr/orml repo already uses jekyll and can be used as inspiration. Here the result: https://orml.openrndr.org/ See:

• https://github.com/openrndr/orml/blob/master/.github/workflows/markdown-to-jekyll.yml
• https://github.com/openrndr/orml/blob/master/build.gradle.kts
• https://github.com/openrndr/orml/tree/master/buildSrc