|
| 1 | +--- |
| 2 | +title: wmk |
| 3 | +repo: bk/wmk |
| 4 | +homepage: https://wmk.baldr.net |
| 5 | +language: |
| 6 | + - Python |
| 7 | +license: |
| 8 | + - MIT |
| 9 | +templates: |
| 10 | + - Mako |
| 11 | +description: A flexible and versatile static site generator |
| 12 | +--- |
| 13 | + |
| 14 | +wmk is suitable for building any small or medium-sized static website (up to a few hundred pages). |
| 15 | + |
| 16 | +### Features |
| 17 | + |
| 18 | +- The normal input format is Markdown or HTML content with YAML metadata in |
| 19 | + the frontmatter. However, via Pandoc, many other input formats are also supported, |
| 20 | + namely LaTeX, Org, RST, Textile, man, JATS, TEI, Docbook, RTF, DOCX, ODT and EPUB. |
| 21 | +- The optional Pandoc integration also gives you access to other features such |
| 22 | + as LaTeX math markup, academic citations, and non-HTML output formats. |
| 23 | +- Themeable, with a few themes already available. |
| 24 | +- Built-in Sass/SCSS support (via libsass). More extensive assets handling (e.g. |
| 25 | + using Webpack or similar) can be easily configured. |
| 26 | +- Can automatically generate a search index for use by Lunr.js. |
| 27 | +- Additional data for the site may be loaded from separate YAML files – or even |
| 28 | + (with a small amount of Python/Mako code) from other data sources such as CSV |
| 29 | + files, SQL databases or REST/graphql APIs. |
| 30 | +- "Stand-alone" templates – i.e. templates that are not used for presenting |
| 31 | + (markdown-based) content – are also rendered if present. This can e.g. be used |
| 32 | + for list pages or content based on external sources (such as a database). |
| 33 | +- Shortcodes for more expressive and extensible content. The shortcode system |
| 34 | + is considerably more powerful than that of most static site generators. For |
| 35 | + instance, among the default shortcodes are an image thumbnailer and a page |
| 36 | + list component. A shortcode is just a Mako component, so if you know some |
| 37 | + Python you can easily build your own. |
0 commit comments