THIS REPO HAS MOVED

https://codeberg.org/adot/xmark

ITS MUCH BETTER

xMark

A WIP "HighLy opINionAtED" static site/doc generator. Totaly unusable (for now)

Loosly based on mdBook and does use its code in some places.

Prior Art/Reference material

• mdBook
• GitHub Docs
• fasterthanlime's new site
• tavianator.com
• tumblelog
• jekyll
• hugo
• asciidoctor
• ninja
• https://joshwcomeau.com/css/full-bleed/
• doctave
• https://github.com/squidfunk/mkdocs-material
• https://lab.hakim.se/progress-nav/
• https://lord.io/blog/2020/spreadsheets/ (esp futher reading)
• https://github.com/google/docsy
• https://markentier.tech/posts/2020/10/wrote-javascript-to-avoid-javascript/
• https://github.com/slatedocs/slate
• https://docsify.js.org/
• mdx (spec)
• https://design.gitlab.com/ (git)

Drawing forms

• penrose
• graphviz
• ditaa
• plantUML
• draw.io?
• tikz?
• libfsm?
• kgt?
• metapost?
• gnuplot?
• pyplot?
• Any of the other formats suported by adoc
• https://github.com/ivanceras/svgbob
• https://github.com/reanimate/reanimate
• https://github.com/kinnison/pikchr

Outputs

• HTML
• PDF?

Inputs

• Markdown
• Asciidoc? (spec proposal)

Other ideas

• Use ninja or salsa for incremental
• Use nix/meson to manage a bunch of deps(drawing gens)
• Use mdx (currently v-early days)
• Use asciidoc spec also early

License

xmark is released under the terms of the GNU General Public License version 3. See LICENSE.