我有一个多模块 Maven 项目，其中一个是文档项目，我在其中制作使用其他模块的参考指南。我试图通过使用 Maven 的站点插件和 asciidoctor-maven-plugin 来坚持 Maven 方式。

<packaging>问题是，我应该为我的 pom中的元素使用哪个值？它不是真正的 jar 或任何其他内置类型。谷歌搜索那个答案让我无处可去...... :(

请注意，maven 可以在没有指定<packaging>（默认为jar）的情况下构建站点，但我收到警告

我不想收到这个警告。

我遇到了许多演示Markdown实时预览的编辑器演示，例如：

http://daringfireball.net/projects/markdown/dingus

http://dillinger.io/

http://www.markitdown.net/markdown

http://epiceditor.com/

http://hallojs.org/demo/markdown/

但我一直无法找到太多的搜索AsciiDoc Editor live preview。

我遇到过有关设置此类功能的文章，例如：

http://asciidoctor.org/docs/editing-asciidoc-with-live-preview/

但我真的只是在做一些在线演示，那里有吗？

我想创建一篇文章，其标题页包含标题和副标题，第二页包含标题、法律声明和版权，第三页包含目录。

我用 asciidoc 编写，然后转换为 docbook，然后使用 xsltproc 和 fop 生成 pdf。全部在 centos 6.4 系统上。据我了解，我必须创建一个自定义标题页 xsl 文件来实现我想要的。我按照doccookbook创建了我的xsl。但不知何故，这并不像我想要的那样工作，我根本没有得到单独的标题页。

我的 asciidoc myreport.txt 是

然后我创建我的 xml 标题页模板 articletitlepage.xml

我把它翻译成xsl

然后我创建 myarticletitlepage.xsl 作为

然后我发出

这会生成一个pdf，它的标题有两次不同的字体大小（所以我的标题页模板是有效的）。但这一切都在一页上。我知道对于版权和法律问题，我在 asciidoc 中遗漏了一些东西（欢迎提示），但现在如果我能得到单独的页面，我会很高兴。

我想使用 asciidoc 创建一本 pdf 书。标题页应包括标题、副标题和图像。到目前为止，我找不到任何关于如何实现这一目标的文档。

Intuivly我会做类似的事情

但这只是image:images/titelimage.png[width=400]作为字幕添加。我想要的是类似的东西

有没有办法在 ascciidoc 中做到这一点？如果没有，我需要做什么才能得到这个？

主.asc：

foo.asc

酒吧.asc

main.asc呈现时，将显示以下文本：

项目

标题

• 一件事
• 事情二 === 酒吧标题

这是一个总结吧

我还尝试foo.asc在列表末尾添加一个简单的段落，看看这是否能解决问题——它没有。

有没有办法来解决这个问题？

How can I get an apostrophe at the beginning or the end of the word? This would be necessary for old-style

'Tis

instead of

It's

Or the apostrophe at the end of a word in plural, like

arguments'

Of course I could also just type

but this defeats the purpose of using markdown.

Edit: It does not seem to me that there is a defined inline quotation style with single quote at beginning and end, like

so it shouldn't be too much of a stretch?

我想将一些AsciiDoc .adoc 文件转换为 HTML 并为此使用 Gradle。

我是 Gradle 的新手。我找到了https://github.com/asciidoctor/asciidoctor-gradle-plugin 和下面是build.gradle即将做到这一点，但我的 Gradle 水平我不知道下一步该做什么

我不得不承认我是 AsciiDoc 和 ASciiDoctor 的新手......

我想要完成的是用 groovy 呈现给定的 AsciiDoc 模板（https://github.com/masch70/arc42-template-asciidoc）。我的解决方案是使用 AsciiDoctor Java 接口，它似乎是对运行 jRuby 的 AsciiDoc 的重写。到目前为止，代码运行良好：

但它似乎忽略了对我来说看起来不错的包含部分：

不是包含文件，而是呈现文件的链接。

AsciiDoctor 手册说支持包含：http ://asciidoctor.org/docs/user-manual/#include-directive ，所以问题是，我做错了什么？

鉴于此 template-docinfo.xml 文档：

这些设置将呈现带有封面的 ePub 文档：

这些设置将呈现 PDF 文档，但没有封面：

有没有办法呈现带有封面的 PDF 文档（即图像是文档的第一页）？

这个 AsciiDoc 块将创建标题和当前修订信息：

docinfo_generator将从AsciiDoc格式文档的注释块中提取此信息，然后将其嵌入到 docinfo.xml 文件中：

虽然有用，但修订历史不会包含在 asciidoc 生成的 HTML 中（它可能在 a2x 生成的 HTML 中，但我没有对此进行测试）。

我想找到一种方法将整个修订历史嵌入到 asciidoc 格式的文档中，然后（理想情况下）将其作为表格显示在所述文档的末尾。

这可能吗？