【发布时间】：2017-08-18 08:34:07
【问题描述】：
我需要你的帮助。
现在我正在使用 AsciiDoc 和 AsciiDoctor 创建一些手册。
我希望某些特定块上的文本更小，例如宽表、宽列表等，但不希望主文本更小。 特别是我需要根据客户的要求将宽表的文本变小。
有什么办法吗？
【问题讨论】：
标签： text-size asciidoc asciidoctor
【发布时间】：2017-08-18 08:34:07
【问题描述】：
您提到列表和表格... 关于列表，不能像AsciiDoctor Documentation中说的那样做：
不支持 属性值中不允许使用复杂的 AsciiDoc 标记，例如：
列表
多个段落
其他与空格相关的标记类型
如您所见，它提到了多个段落，因此虽然@EhmKah 答案是设置自定义样式块的正确方法，但它不会按预期在表格/列表中呈现，因为它是多段。
内置的 CSS 类语法是要走的路[small]#any phrases#
但是为了在表格中进行这项工作，在这种情况下，您必须使用 说明符 设置单元格类型，AsciiDoc 说明符表示为一个
这意味着单元格（或列）将呈现支持的 AsciiDoc 语句、属性等。
这是一个工作示例：
[frame="none",grid="none"]
|====
a| image::images\logo.png[] a|[.small]#Autor: {author}#
|====
如果您有大量行/列，则不必手动将a 应用于所有行/列。您可以通过这种方式设置需要此行为的列：
[cols="1a,2a",frame="none",grid="none"]
|====
| image::images\logo.png[] |[.small]#Autor: {author}#
|====
您可以查看其文档以了解有关 Column Formatting 的更多信息，您可以查看具有可变宽度和对齐方式的渲染表子部分以了解有关 AsciiDoc (a) 和其他说明符的更多信息。 p>
【讨论】：
-
感谢您提供详细的回答，非常有帮助。 （很抱歉我迟到了回答，我被记错了，我已经设置了）
docinfo.html + --attribute docinfo=shared
您可以将您的 CSS 修改放到一个名为 docinfo.html 的文件中：
<style>
/* Your custom CSS. */
</style>
然后构建：
asciidoctor --attribute docinfo=shared README.adoc
这使得 Asciidoctor 2.0.10 将 docinfo.html 放置在 <head> 元素的底部。
所以你可以从那里覆盖大部分默认的 Asciidoctor 样式。
那么只需了解生成的 HTML 和之前的样式定义即可覆盖它们。
对于image，另请参见：How to set a custom image height for an image in Asciidoctor?
【讨论】：
当你使用一个主题文件时，你可以像这样给它添加一个角色：
role:
mycustomfont:
font-color: #333
font-size: 10
现在您可以直接从表格单元格中引用新创建的角色：
a|[.mycustomfont]# some text #
【讨论】：
-
非常好的主意，但你能提供完整的例子吗？
我读到了一些关于
- [small] 和 [%autofit] 选项 https://github.com/asciidoctor/asciidoctor-pdf/issues/185 我从来不需要它，所以也许你试一试。
示例代码
[small]
----
should be rendered in smaller font.
----
[%autofit]
----
really long text that doesn't want to fit on a single line with the default font size, so we'll make it shrink to fit.
----
【讨论】：
-
虽然我尝试过
[small]和[%autofit]用于表格块，但它们无法工作......关于[small]，你写的方式根本不起作用。[small]#any phrases#字体变小了。 -
@macoril 您能否重复您的评论作为答案并将您的问题标记为已回答？
-
关于答案，这是一个自定义样式块和关于 @marcoil 注释，这是一个内置的 CSS 类语法。两者都是正确的，但为了能够在表格中使用它们，请查看我的答案。