使用 asciidoc / markdown 输入、html / pdf 输出发布工具链答案

【问题标题】：Publishing toolchain with asciidoc / markdown input, html / pdf output使用 asciidoc / markdown 输入、html / pdf 输出发布工具链
【发布时间】：2012-07-10 12:04:00
【问题描述】：

我看到this有关发布工具链的相关问题，但我知道最近很多人为制作发布工具链做了很多工作。

我发现的一个很好的例子是来自 akosma 的 this project。

Avdi Grimm 在this project 中分享了他与 org-mode 的工作

我知道还有（应该）很多人。

我正在寻找的是一个发布工具链

asciidoc / markdown / Textile / org-mode 或 Latex 输入。我不想要 xml 输入
pdf AND html 输出，epub 输出对我来说不是必需的。

我能做什么

latex / html / css / js 中的作者模板。再次，没有 xml。
读写 ruby 和 shell 脚本

【问题讨论】：

使用pandoc。不过，它不是 Ruby。
是的 pandoc 是很棒的转换器，或者 dblatex .. 但我正在寻找的是更多“准备使用”的脚本 + css + 乳胶模板（如果有的话），把你的 markdown / asciidoc，并转换他们以 pdf / html 格式制作闪亮的文档。我正在使用 Adrian 的模板。但是问有没有类似的。
Pandoc 包含所有输出类型的默认模板。顺便还有红宝石绑定：rdoc.info/github/alphabetum/pandoc-ruby github.com/alphabetum/pandoc-ruby

标签： ruby pdf markdown publishing asciidoc

【解决方案1】：

看看 asciidoc，这是 O'Reilly 开始使用的，它是 DocBook 的一个令人耳目一新的突破。我使用 asciidoc，工具和支持有些不足，但有人致力于创建更好的替代方案（不涉及 Python 和现有的 Docbook 管道）。

看看这个：https://github.com/runemadsen/asciidoc

EDIT 1/6/13：您还真的需要查看 AsciiDoctor。来自 RedHat 的 Dan Allen 已经在这个特殊的包和 Ryan Waldron 上花费了很多时间。我期待 AsciiDoctor 能带来伟大的成就，因为它开始成为一系列重要的 AsciiDoc 文档工作的基础。

【讨论】：

非常感谢，当我问这个问题时，我确实看到了那个存储库，但从未尝试过。很高兴看到人们积极地工作，并且有一个以此为基础的最终产品。我一定会尽快尝试。
感谢您将我指向 asciidoctor。我真的很喜欢原生 ruby，不幸的是文档仍然缺乏。
使用 Asciidoctor 一段时间后，我发现它非常棒，于是我将它推荐给我们的 techdocs 团队并帮助他们将我们的文档迁移到其中。谢谢！这篇小帖子可以节省大量时间。
使用 asciidoctor 也有一段时间了。自从我提出问题以来，他们取得了很大进展。这个link 和这个link 对任何感兴趣的人都特别有用。