AsciiDoctor table 单元格中的多个段落
Multiple paragraphs in AsciiDoctor table cell
编辑: 由于我的问题似乎与我的设置有关,我在这里提供了一个完整的最小工作示例。
这是我的 Maven 设置 (pom.xml
):
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>foo</groupId>
<artifactId>bar</artifactId>
<version>1.0-SNAPSHOT</version>
<name>AsciiDoc Test</name>
<build>
<plugins>
<plugin>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>1.5.3</version>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj-pdf</artifactId>
<version>1.5.0-alpha.11</version>
</dependency>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj</artifactId>
<version>1.5.4</version>
</dependency>
<!-- beware, jruby 1.7.23 breaks asciidoctorj -->
<dependency>
<groupId>org.jruby</groupId>
<artifactId>jruby-complete</artifactId>
<version>1.7.21</version>
</dependency>
</dependencies>
<configuration>
<sourceDirectory>${project.basedir}/src</sourceDirectory>
</configuration>
<executions>
<execution>
<id>generate-pdf-doc</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<backend>pdf</backend>
<doctype>book</doctype>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
这是我的 AsciiDoc 来源 (src/test.adoc
):
[cols="a"]
|===
|First paragraph
second paragraph
|===
AsciiDoc 文件编译为:
mvn generate-resources
这是生成的输出 (target/generated-docs/test.pdf
)
为什么 AsciiDoc 不呈现两个段落?
其他未按预期工作的事情(每个示例将整个单元格内容推送到一个段落中):
- 明确指定
a
单元格:
|===
a|First paragraph
second paragraph
|===
- 列表:
[cols="a"]
|===
|First paragraph
* second paragraph
|===
- 作为non-heading:
[cols="1"]
|===
a|First paragraph
second paragraph
|===
来自文档:
http://asciidoctor.org/docs/user-manual/#cell
直接Asciidoctor PDF渲染暂不支持。参见 #6
这是我得到的:
含段落:
[cols="1"]
|===
a|First paragraph
second paragraph
|===
相关的是|==
和a|your cell
之间的空行
使用 HTML 渲染器:
使用 PDF 渲染器:
有名单:
它的工作原理是一样的:
[cols="1"]
|===
a|First paragraph
* second paragraph
|===
使用 HTML 渲染器:
使用 PDF 渲染器:
一个可能的解决方案可能是将 DocBook 管道与 jDocBook 一起使用,如本例 docbook-pipeline-jdocbook-example 所示。通过此设置,我得到了预期的输出:
我对 Maven 一无所知,也不使用 AsciiDoctor 进行 PDF 输出,但建议的答案可能(可能,不确定)已过时。这是另一个解决方案(对我来说适用于HTML。我在这里post是因为我在官方手册中没有找到这个语法):
|===
| Column 1 | Column 2
| Foo
| Bar
Baz
| Aaa
Bbb
| Ccc
|===
我没有在官方手册中找到任何关于这种语法的例子。语法取自此处:
相同,如果有人更喜欢 header 中的多行语法:
[cols="2"]
[options="header"]
|===
| Column 1
| Column 2
| Foo
| Bar
Baz
| Aaa
Bbb
| Ccc
|===
编辑: 由于我的问题似乎与我的设置有关,我在这里提供了一个完整的最小工作示例。
这是我的 Maven 设置 (pom.xml
):
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>foo</groupId>
<artifactId>bar</artifactId>
<version>1.0-SNAPSHOT</version>
<name>AsciiDoc Test</name>
<build>
<plugins>
<plugin>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>1.5.3</version>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj-pdf</artifactId>
<version>1.5.0-alpha.11</version>
</dependency>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj</artifactId>
<version>1.5.4</version>
</dependency>
<!-- beware, jruby 1.7.23 breaks asciidoctorj -->
<dependency>
<groupId>org.jruby</groupId>
<artifactId>jruby-complete</artifactId>
<version>1.7.21</version>
</dependency>
</dependencies>
<configuration>
<sourceDirectory>${project.basedir}/src</sourceDirectory>
</configuration>
<executions>
<execution>
<id>generate-pdf-doc</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<backend>pdf</backend>
<doctype>book</doctype>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
这是我的 AsciiDoc 来源 (src/test.adoc
):
[cols="a"]
|===
|First paragraph
second paragraph
|===
AsciiDoc 文件编译为:
mvn generate-resources
这是生成的输出 (target/generated-docs/test.pdf
)
为什么 AsciiDoc 不呈现两个段落?
其他未按预期工作的事情(每个示例将整个单元格内容推送到一个段落中):
- 明确指定
a
单元格:
|===
a|First paragraph
second paragraph
|===
- 列表:
[cols="a"]
|===
|First paragraph
* second paragraph
|===
- 作为non-heading:
[cols="1"]
|===
a|First paragraph
second paragraph
|===
来自文档: http://asciidoctor.org/docs/user-manual/#cell
直接Asciidoctor PDF渲染暂不支持。参见 #6
这是我得到的:
含段落:
[cols="1"]
|===
a|First paragraph
second paragraph
|===
相关的是|==
和a|your cell
之间的空行
使用 HTML 渲染器:
使用 PDF 渲染器:
有名单:
它的工作原理是一样的:
[cols="1"]
|===
a|First paragraph
* second paragraph
|===
使用 HTML 渲染器:
使用 PDF 渲染器:
一个可能的解决方案可能是将 DocBook 管道与 jDocBook 一起使用,如本例 docbook-pipeline-jdocbook-example 所示。通过此设置,我得到了预期的输出:
我对 Maven 一无所知,也不使用 AsciiDoctor 进行 PDF 输出,但建议的答案可能(可能,不确定)已过时。这是另一个解决方案(对我来说适用于HTML。我在这里post是因为我在官方手册中没有找到这个语法):
|===
| Column 1 | Column 2
| Foo
| Bar
Baz
| Aaa
Bbb
| Ccc
|===
我没有在官方手册中找到任何关于这种语法的例子。语法取自此处:
相同,如果有人更喜欢 header 中的多行语法:
[cols="2"]
[options="header"]
|===
| Column 1
| Column 2
| Foo
| Bar
Baz
| Aaa
Bbb
| Ccc
|===