cont icon indicating copy to clipboard operation
cont copied to clipboard

Mkdocs basic setup + learn section

Open Ellipse0934 opened this issue 9 months ago • 4 comments

Solves #44

From the project root run a mkdocs serve for a preview.

TODO:

  • [X] Github Pages
  • ~~[ ] Examples section~~

Mkdocs vanilla is quite powerless. It can't do basic things like substitution using macros. So either we will need an extension to do this OR shift to a more modern stack. For now I will add scripts to do the hacky work. Like copying examples/*.cn -> docs/examples/*.md

Ultimately, newer standards like Asciidoc make sense but their tooling is limited at the moment.

I am also quite annoyed at them for not giving an option to disable the footer OOTB.

Ellipse0934 avatar May 14 '24 11:05 Ellipse0934