AsciiDoc Website Builder

网站把AsciiDoc生成器是用Python编写一个程序，让你写的几乎纯文本（即把AsciiDoc）网站，再加上一些简单的配置文件。它的存在是为了解决从没有更新自己的网站（其中使用了大量的PHP），因为我不能很快记住副手所有我需要添加新页面的变化和特定格式的我的问题。
这里是“把AsciiDoc网站制作”的一些主要特点：
·灵活的模板系统
·博客一代
·图像库代
·sitemap.xml的一代
对把AsciiDoc·所有美味的特点
入门：
要开始使用自动白平衡，你需要建立至少一个网站在用户AWB的配置文件。这是位于〜/ .awb / awb.conf它可能是这个样子：
----
[mywebsite]
siteroot：/家庭/ ME / mywebsite
baseURL时：HTTP：//my.web.site
把AsciiDoc选项：-d书-b HTML4
----
这只是定义了已知AWB为“mywebsite”网站。选项​​有：
siteroot ::
在AWB网站的根目录。该源把AsciiDoc家住+ siteroot / SRC +，和HTML输出为+ siteroot / HTML +。
baseURL时::
该网站的根目录的URL。这用于产生sitemap.xml的。
选择把AsciiDoc ::
选择要传递给把AsciiDoc。我用此来指定除了在实施例所示的选项定制html4.conf文件。
一旦你已经配置了一个网站和一些源文件编写，只需发出命令
----
％AWB mywebsite
----
AWB只会重新生成已成为过时的HTML文件。如果不出于某种原因，该选项-r可以用来修复它。
----
％AWB -r mywebsite
----
这可以从在文件系统中的任何地方进行。 AWB从它的配置文件，知道在哪里可以读取和写入。
awbdir.conf
-----------
源代码树中的每个目录可能包含一个名为awbdir.conf的配置文件。该文件指定要使用的AWB目录特定的选项。
[DIR设置]部分
输入::
可以是'正常'，'博客'，或'画廊'之一。 “正常”是默认的。类型的含义进行说明。
名字::
该目录的描述性的名称，如在面包屑。
awbdir.conf [博客]部分
本节定义，如果该目录类型是博客使用的设置。
NUM主要岗位::
职位数显示博客的index.html页面上。
NUM最近的帖子::
的职衔数量显示在“最近的帖子”列表中，并且还种杂志的数量，在“最近的杂志”列表中显示。
[用户]部分
在这里，你可以定义你喜欢的任何选项。它可以在模板中被引用。当你想使用跨网站相同的模板，但改变它的小零件（如图像），这是很有用的。
awbdir.conf级联选项从目录到它的孩子。这是很方便的，因为孩子的目录只需要覆盖不适用父选项。唯一的例外是目录名，其中不级联

什么是此版本中的新：

• 在此更新修复最近的Python版本导致AWB在确定其配置目录的位置失败暴露了一个问题。
• 在此修复程序引入了一个新的depenendency，蟒蛇，XDG。

什么是0.3.1版本，新的：

• 在-l选项被添加到列表中的所有站点。
• 在博客文章的格式是固定使用后至今，没有修改时间。
• 在网站地图时间戳的问题是固定的。
• 在用法字符串进行了更新。
• 在空meta描述不插入。
• 在崩溃可以避免，而获得冠军的空文件。
• 在该手册被转移到一个单独的位置。
• 在命令加入。
• 在文档字符串清理已完成。

什么是0.3版本的新：

• 在这个版本是一个大的重构的最终产品
• 的0.3系列将路径稳定的1.0版本。