用 AsciiDoc 编写的新手册

第 6 部分

Merlin Project 手册的封面

我实在不太想说出口,更不想写下来;在这个项目中,现实把我赶上了。我看了上一篇博客的日期,吓了一大跳:(link: blog/2022/01/handbook-with-asciidoc-5 text: 2022 年 1 月 14 日)。

我想坦诚相告,自那个日期以来,我在新手册上也并没有写多少。当然,我早在几个月前就已意识到这个问题,甚至尝试寻找解决方案。但遗憾的是,一切都不太奏效,我意识到自己需要支援。

于是我和 Antoni 坐下来商量,我此前已和他一起为 Hanser 出版社编写过(link: https://fachbuch.hanser-ebooks.de/ebook/bid-32541-projektmanagement-mit-merlin/inhalte/ target: _blank Text: Merlin 2 一书),我们重新搭建了这个项目。我知道这很难为情。但有时人必须识别并解决一个问题,即便自己就是那个问题。

我希望我们现在能携手在 2023 年上半年完成这本德语书,然后便可逐步将其翻译成其他语言。

主题:Ascii

Doc

项目本身没有变化,因为 Antoni 对我们的小魔法师了如指掌。标记语言 AsciiDoc 也依旧沿用。毕竟,Antoni 和 ProjectWizards 的所有其他人一样,自大约 2012 年起就一直用这种方言书写。

不过,时不时还是得查阅一下语法。在这里,Asciidoctor 的帮助模式被证明非常有用。

请在终端中输入以下内容:

asciidoctor --help syntax

作为输出,您将得到一个采用 AsciiDoc 记法的帮助页面。您甚至可以将该页面直接转换为 HTML:

asciidoctor --help syntax | asciidoctor -o syntax.html -

提示:行尾的「-」会将输出设置为标准输出(STDOUT)。
其结果是一个 HTML 页面,(link: https://www.projectwizards.net/documentation/syntax.html target: _blank text: 看起来就是这样)。

现在您还可以追加一个 open 命令:

asciidoctor --help syntax | asciidoctor -o syntax.html - && open syntax.html

这样页面就会立即在您自己的浏览器中显示出来。


好了,现在我们就来看看,接下来几周我们的进展如何。

就此,下次再见……


If you have any questions about this blog article or would like to discuss it, we look forward to your contribution in our forum.

规划项目, 让计划真正奏效。

一款管理项目计划的应用,在所有 Apple 设备上原生运行。