如何从 ASCIIDoc 文件构建网站？答案

【问题标题】：How to build a website from ASCIIDoc-files?如何从 ASCIIDoc 文件构建网站？
【发布时间】：2016-02-02 14:39:14
【问题描述】：

有没有一种简单的方法可以通过 ASCIIDoc 文件生成带有菜单的网站...？

假设我有几个 ASCII-Doc 文件：

chapter-1.asciidoc
chapter-2.asciidoc
chapter-3.asciidoc
chapter-4.asciidoc

我还有一个网站骨架，其中包含文件的“主要内容”以外的所有内容

<html>
<head>
</head>
<body>
<a href="chapter-1.asciidoc">
<a href="chapter-2.asciidoc">
<a href="chapter-3.asciidoc">
<a href="chapter-4.asciidoc">

CONTENT SHOULD GO HERE

</body>
</html>

现在我想生成 4 个 html 文件，其中包含渲染的 HTML 命令，将其放置到网站 Skeleton 的副本中（这里替换 CONTENT SHOULD GO HERE）

有没有允许这样的工具？

【问题讨论】：

标签： html converter asciidoc

【解决方案1】：

最好的办法是使用 Middleman、awestruct、jekyll 等。 Asciidoc（python impl）和 Asciidoctor（ruby 或 javascript impls 或 java 包装器 AsciidoctorJ）都不能开箱即用。另一种方法是使用上述实现之一并调用 API 来呈现 asciidoc 文档，然后吐出呈现的内容。

【讨论】：