编年史 - 云端在线

程序：

您的姓名

编年史 - 一个简单的博客编译器。

概要

编年史 [选项]

路径选项：

--comments 指定可选注释目录的路径。
--config 指定要读取的配置文件。
--input 指定要使用的输入目录。
--output 指定要将输出写入的目录。
--theme-dir 指定主题模板的路径。
--theme 指定要使用的主题。
--pattern 指定要使用的文件模式。
--url-prefix 指定直播博客的前缀。
--sitemap-prefix 指定站点地图的前缀。

博客条目选项：

--format 指定条目的格式，HTML/textile/markdown。

构建前和构建后命令：

--pre-build 指定在构建博客之前要执行的命令。
--post-build 指定构建博客后要执行的命令。
--pre-filter 用于在 HTML 转换之前过滤每个博客条目的命令。
--post-filter 用于在 HTML 转换后过滤每个博客条目的命令。

排序选项：

--recent-dates-first 在存档视图中首先显示最近的条目。
--recent-tags-first 在标签视图中首先显示最近的条目。

计数选项：

--entry-count=N 要在索引上显示的帖子数。
--rss-count=N 要包含在 RSS 索引提要中的帖子数。

可选功能：

--author 指定作者的电子邮件地址
--comment-days 指定接受评论的帖子的最大年龄。
--date-archive-path 在存档中包含日期。
--force 强制从博客主题复制静态文件。
--lang 指定用于格式化日期的语言。
--lower-case 小写所有输出的文件名。
--no-archive 不创建存档页面。
--no-cache 不要使用可选的 memcached 功能，即使可用。
--no-calendar 不要在索引上使用可选的日历。
--no-comments 不允许发表评论。
--no-sitemap 不生成站点地图。
--no-tags 不生成任何标签页。
--no-xrefs 不产生任何交叉引用。

帮助选项：

--help 显示此脚本的帮助信息。
--manual 阅读此脚本的手册。
--verbose 显示有用的调试信息。
--version 显示版本号并退出。

关于我们

Chronicle 是一个简单的工具来转换文本文件的集合，
位于单个目录中，进入由静态组成的博客
HTML 文件。

它仅支持所需的最少功能
有用：

* 标记支持。

* RSS 支持。

*档案支持。

明显的不足是：

* 缺乏对即时评论的支持。

* 缺乏 pingback/trackback 支持。

话虽如此，它是一个健壮、稳定和有用的系统。

博客 FORMAT

我们处理的文本文件的格式对输出至关重要
页。 每个条目应如下所示：

标题：这是博文的标题
日期：2 年 2007 月 XNUMX 日
标签：一、二、三、长标签

您的条目文本在此处。

注意：头部必须与条目的主体至少分开一个
单空行。

在这个例子中，我们可以看到条目本身已经被前缀
带有一个小标题。 条目标题包含三个可选行，
如果这些不存在，那么有描述的合理默认值
联络一位教师

输出日期的格式可以通过使用
B<--lang> 命令行选项（或匹配的“lang=french”选项
配置文件），但条目本身的日期应在
英语。

标题：描述帖子的标题。 如果不存在，则使用条目的文件名
反而。 也可以使用“主题：”。
主题：这是“标题：”的同义词。
日期：发布帖子的日期。 如果不存在，则使用文件的创建时间
代替。
发布：此标头从所有条目中删除，并由编年史假脱机程序使用
脚本。
标签：应与条目关联的任何标签，以逗号分隔。

条目的格式假定为 HTML，但是有支持
用于以纺织和降价格式编写您的条目。

条目的格式通过 B<--format> 参数指定，或
通过您的chroniclerc文件中的“格式：foo”设置。

假定条目的格式是全局的； 这是你所有的条目
将假定为相同的格式。 但是你可以添加一个
“格式：foo”伪标头到特定条目，如果你想写
不同格式的特定条目。

为了灵活处理条目，每个博客条目将
通过过滤脚本B
这允许您在单个位置修改此处理。 这个
脚本允许在之前和之后通过过滤器更新条目
转换为 HTML。 有关更多详细信息，请参阅联机帮助页
那个脚本。

配置

软件的配置最少，一般执行
通过命令行参数。 但是可以保存设置
在文件全局 /etc/chroniclerc 或每个用户中 ~/.chroniclerc
文件中。

如果您愿意，可以将另一个配置文件的名称传递给
带有 B<--config> 标志的脚本。 这将在阅读后
前两个文件，并且可以覆盖存在的任何设置。

配置文件包含如下几行：

输入 = /home/me/blog

输出 = /var/www/blog

格式 = 降价

未知的键将被忽略。

不是必须的 缓存

为了加速大型博客的重建，编译器可能会使用本地
Memcached 守护进程（如果已安装且可用）。

要安装它，请在 Debian GNU/Linux 系统下运行：

APT-get的更新
apt-get 安装 memcached libcache-memcached-perl

您可以使用 --no-cache 禁用此缓存行为，并查看
效果与--verbose。

不是必须的 日历

如果“HTML::CalendarMonthSimple”模块可用，每个博客都会
包含索引当前月份的简单月视图。

要禁用此功能，请使用“--no-calendar”调用程序。

不是必须的 评论

包含在编年史代码中，您应该找到该文件
cgi-bin/comments.cgi。

该文件旨在将提交的评论写入本地
您的网络服务器的文件系统。 如果你安装它，并编辑
您应该能够包含脚本开头的路径
在您的博客中发表评论。

简而言之，您需要做三件事：

安装CGI脚本并在开始时编辑路径。
将输出评论复制到您的本地博客源。
使用 --comments=./path/to/comments 再次运行此脚本

这应该包括静态输出中的注释。 更多的
文件“评论”中提供了明确的说明
包含在发行版中。

使用 onworks.net 服务在线使用编年史