Skip to content

Commit cc69abe

Browse files
Merge pull request #875 from bk/main
Add wmk to Static Site Generators
2 parents 7b48a03 + f244283 commit cc69abe

File tree

1 file changed

+37
-0
lines changed

1 file changed

+37
-0
lines changed

src/site/generators/wmk.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
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

Comments
 (0)