dollgen readme

this content of this page is an automatic transclusion from the README on codeberg
dollgen is a relatively simple Static Site Generator, intended to be unbiased towards what you choose to write your site in (by default, it doesn't have any language-specific features)

rules

the core of dollgen is simple, define rules with the following:
  • included paths*
  • excluded paths*
  • output path* (recieves captures from the include glob that matched)
  • transformer that reads the input file and generates a plan to be executed
    may be created oneself or found in the integrations section
although it's *recommended* to use src/ for input files and dist/ for output files, dollgen does not care what directories you use, and will automatically create directories up to whatever output path that a rule specifies
[glob ^1 ^2]:
globs follow the syntax of capturing-glob
all paths are relative to the current working directory
[format ^1]:
format strings follow a similar syntax to rust's format strings, but simpler
given a list of captures, {n} is replaced with the n-th capture
given rule with an include src/(**)/(*).draft.*), matching path src/blog/itsfirstblog.draft.doll, format string dist/{0}/{1}.html would produce dist/blog/itsfirstblog.html

integrations

read more about integrations in their individual modules
currently present
planned
  • markdown
  • maybe MDX?
  • maybe reStructuredText? (if it wants to subject itself to that?)
  • at this point just make an issue for what you want
created:
updated:
built: