This blog can be built with the pyblog
script. The pyblog
script currently provides the following actions:
new_post
(aliases:n
,new
);touch
(aliases:t
,tou
);generate
(aliases:g
,gen
);regenerate
(aliases:r
,regen
);preview
(aliases:p
,pre
).deploy
(aliases:d
,dep
);gen_deploy
(aliases:gd
,gendep
);edit
(aliases:e
,ed
).
Run pyblog --help
for more information, and pyblog <action> --help
for what the action does and how to perform the action.
Note that pyblog
is incompatible with Python 2.x, and in fact only tested on Python 3.4+.
The theme of this blog is largely based on that of mort.ninja by Mort Yao. See this post for more details.
Self-hosted Google Web Fonts are downloaded from google-webfonts-helper, courtesy of Mario Ranftl.
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
pyblog
uses Pandoc for Markdown processing. The HTML template is
located at master/template.html
.
Beyond Pandoc's standard Markdown to HTML conversion, pyblog
postprocesses Pandoc-generated HTML to add a few Markdown extensions and
blogging-friendly HTML transforms.
Markdown extensions
Image size
Allows specifying image size in a Markdown image construct ![]()
. The
syntax is:
![|width(xheight)?| alt](src)
where width
and 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.
Examples:
![|1920x1080| Hello, world!](http://example.com/hello.png)
![|1920| *Hey!*](http://example.com/hey.png)
![|1280x800|](http://example.com/noalt.png)
See process_image_sizes
in pyblog
.
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).
See link_img_tags
in pyblog
.
Footnote backlinks
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.
Configuration
The configuration files are placed in the folder config and use the toml file configuration format.
The 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.
About
This tool has been developped by zmwangx and modified by neodarz