Stog is a static web site compiler. It is able to
handle blog posts as well as regular pages or any XML document in general.
The main features are:
- generate static XML/HTML documents: easy to deploy, fewer security problems,
- handling of blog posts, with dates, topics, keywords and associated RSS feeds,
- no new syntax,
- based on a XML rewrite engine allowing the applicatioh of substitutions
(rewrite rules) on some tags. Some substitutions are pre-defined, and others can be
defined in your documents or added by plugins. Content can then be written
with semantic tags,
- support multi-language sites,
- a lot of predefined functions can be used to handle
sectioning, table of contents, verified cross-references, ...,
- OCaml code can be interpreted at compilation time and the result
included in the generated documents, which is nice to write tutorials on
OCaml libraries, like here,
- some plugins ease the inclusion of
graphviz graphs,
and pictures generated by Aysmptote
or LaTeX,
- a markdown plugin converts markdown sources,
- developed in OCaml
and can be extended with OCaml plugins,
but there is no need to know about OCaml to use Stog.
Since release 0.12.0, Stog can be used
to compile a single file to admittedly publish HTML files where PDF was used
(think about math articles, for example).
Since release 0.13.0,
a preview server can be used,
watching for changes and updating the page in your browser when you save source
files.
Examples of web sites generated by Stog:
- the Stog site (you're on it!),
- Introduction to OCaml (in french),
- Gagallium,
- Vlmc-suffix-tries,
- Various software websites with documentations:
Chamo,
OCaml-Stk,
OCaml-RDF,
Erssical,
Ocf,
Xtmpl,
Higlo.
- The SNESUP Bourgogne website (in french),
- Oranadoz (in french),
- Maxence Guesdon's website,
- Détain-et-Bruant's website.
Stog is developped on Framagit.
See the page for details about downloading and installing.
Stog is released under GPL v3.
Files in the doc/.stog/templates/ and share
directories are released in the public domain; feel free to use
them for your own site.