第 6 部分

我实在不太想说出口,更不想写下来;在这个项目中,现实把我赶上了。我看了上一篇博客的日期,吓了一大跳:(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.