kez 0.1.5

用法

添加包含文档源文件的存储库：

$ kez add myblog git@github.com:averagehuman/maths.averagehuman.org.git

建立其中定义的任何文档：

$ kez build myblog

跟踪项目：

$ kez list
+---------+------------------------+---------+--------------------------------------------------------+
| Project | Document               | Type    | Url                                                    |
+---------+------------------------+---------+--------------------------------------------------------+
| myblog  | maths.averagehuman.org | PELICAN | git@github.com:averagehuman/maths.averagehuman.org.git |
+---------+------------------------+---------+--------------------------------------------------------+

生成后，如果有根index.html，请在 浏览器窗口：

$ kez serve myblog

配置

源存储库必须有一个名为 kez.cfg包含一个或多个节，其中每个节定义 一份特殊的文件。每个节中的\u docroot\u值 应该给出相对于配置文件的目录，其中 找到文档源（默认为配置文件的 目录）。

按照惯例，双下划线键是构建元选项，而 任何其他键都是程序所必需的或有意义的选项 被要求出示文件（如狮身人面像、鹈鹕等）。

示例kez.cfg

[maths.averagehuman.org]
__doctype__ = pelican
AUTHOR = Buzz Lightyear (MSc Phd)
SITENAME = Beyond Infinity
SITEURL = blog.beyondinfinity.net
ARTICLE_URL = {date:%Y}/{date:%m}/{slug}/
ARTICLE_LANG_URL = {date:%Y}/{date:%m}/{lang}/{slug}/
PAGE_URL = {slug}/
PAGE_LANG_URL = {lang}/{slug}/
ARTICLE_SAVE_AS = {date:%Y}/{date:%m}/{slug}/index.html
ARTICLE_LANG_SAVE_AS = {lang}/{date:%Y}/{date:%m}/{slug}/index.html
PAGE_SAVE_AS = {slug}/index.html
PAGE_LANG_SAVE_AS = {lang}/{slug}/index.html

支持的文档类型

• 鹈鹕

在未来，可能是sphinx。

必需

需要以下库：

• cliff
• pelican
• peewee
• vcstools
• giturlparse.py
• watdarepo
• python-slugify
• TypedInterpolation

测试

使用python 2或python 3运行测试：

$ make test
$ make test PYVERSION=2
$ make test PYVERSION=3

python 3是默认值（如果未指定pyversion）。