thot 1.1.0

快速入门

运行 thot –quickstart mysite 以创建名为 mysite 的目录，其中包含基本的网站骨架。该脚本将询问一系列关于作者姓名等问题。

quickstart 遵循可选参数 -t <shortname>，其中“shortname”是已识别模板引擎的简称。例如，无额外插件的情况下使用 mako 或 jinja2。

运行 thot 命令以生成站点。该命令会查找具有 .htm/.html, .xml, .rst 和 .md/.markdown 扩展名的文件并进行解析。以点或下划线开头的目录和文件将被忽略。其余的将进行复制。生成的站点将在 _output 目录中可用。

基础知识

在您的站点 templates 目录中放置或编辑模板。您可以通过“template: “关键字分配页面模板 self（即无）或任何其他模板。

每个页面由一个标题和一个内容部分组成，顺序如下。它看起来像这样

title: Hello World
template: post.mak

This is the content. Hello World!

标题 使用 YAML 格式化。您可以通过变量 page 在内容中访问它。例如，使用 Mako 通过 ${ page[‘title’] } 或 Jinja2 通过 {{ page.title }}。

内容 可以是任何东西，从纯文本到 html，再到标记，由文件扩展名确定。尽管内容将受到您选择的模板引擎的渲染，但您可以选择不使用它。

您可以在 _config.yml 中找到默认时区和其他设置，该文件以 YAML 格式解析。

Thot 可以利用…

• LaTeX 进行数学渲染。需要 dvipng 和 utf8x（Gentoo：dev-texlive/texlive-latexextra）。启用 RST 指令 math 用于公式（可选属性 label）和 eq 用于链接到标记的公式。

• Pyphen 和 Wordaxe 用于服务器端断字。