This blog can be built with the
pyblog script. The
pyblog script currently provides the following actions:
pyblog --help for more information, and
pyblog <action> --help for what the action does and how to perform the action.
pyblog is incompatible with Python 2.x, and in fact only tested on Python 3.4+.
Warning: If the link generation didin’t work use the script :
pandoc_version_switch.sh. Don’t forget to adapt the pandoc version !
Markdown features of
pyblog uses Pandoc for Markdown processing. The HTML template is located at
Beyond Pandoc’s standard Markdown to HTML conversion,
pyblog postprocesses Pandoc-generated HTML to add a few Markdown extensions and blogging-friendly HTML transforms.
Allows specifying image size in a Markdown image construct
!(). The syntax is:
height are positive integers (
xheight is optional), and
alt is the regular
alt string (either plain or with some Markdown formatting). The
alt string, as usual, is optional.
![|1920x1080| Hello, world!](http://example.com/hello.png) ![|1920| *Hey!*](http://example.com/hey.png) ![|1280x800|](http://example.com/noalt.png)
Other HTML transforms
Link images to originals
img tags are automatically converted to clickable links to their originals (with
target="_blank" so the original is opened in a new tab).
Pandoc Markdown has footnote support, but unfortunately doesn’t support backlinks. This transform inserts a backlink to the end of each footnote so that readers won’t get lost after finish reading a footnote.
The configuration files are placed in the folder config and use the toml file configuration format.
blog.toml is the configuration file who can be edited safely for confifguring the blog.
The second file
generator.toml can be modified if you know what you are doing and it used to configure the generator.