https://github.com/ryanabx/simple-ssg
Djot is a light markup language created by John MacFarlane, who was consequential in developing CommonMark, which is a standardized variant of Markdown.
I decided to make this simple generator because the tooling for Djot is actually quite nice. The reference parser is written in TypeScript, but there is a parser written in rust which I'm using for this project called Jotdown. One of Djot's goals is to have single-pass parsing, and the rules are much simpler than Markdown, leaving less up to interpretation. This makes writing a parser for Djot very simple compared to having to interpret edge cases in Markdown.
The syntax of Djot is very similar to Markdown, but it removes some of the inconsistencies that couldn't be removed in CommonMark. John MacFarlane has a great blog post with some of the ideas that made it into Djot, see https://johnmacfarlane.net/beyond-markdown.html.
Honestly, I was just wanting a bit more tooling for Djot. I created a Visual studio code plugin, and decided I wanted to have more fun with Djot. Since I build projects in rust, I'm thankful that Jotdown exists to take care of the parsing part for me, all I had to do was handle the conversions.
The scope of this generator is pretty simple, no table of contents, no sidebar, just raw Djot parsing. There are some nice warnings that the generator will let you know about though!
index.dj || index.djot
doesn't exist. Most sites will use index.html
as the entry point to a siteYou can also use the --no-warn
argument to turn warnings into errors, if you value having an absolutely "correct" website generated!
See more from me at https://github.com/ryanabx