如何将asciidoctor引用块替换从普通更改为逐字显示?

时间:2018-08-02 15:32:54

标签: asciidoc asciidoctor

= Quote Block Example
:icon: font

This example is used to illustrate a use case for callouts within quote blocks and engage the asciidoctor community in providing an answer for how to accomplish that. The question is how does one change the substitution method for quote blocks from "normal" to "verbatim"?

== Example Quote Block With Attempted Callouts

[quote,The Declaration of Independence,subs="verbatim,attributes"]
____
When in the Course of human events it becomes necessary for one people to dissolve the political bands which have connected them with another and to assume among the powers of the earth, the separate and equal station to which the *Laws of Nature and of Nature's God* <1>
entitle them, a decent respect to the opinions of mankind requires that they should declare the causes which impel them to the separation.

We hold these truths to be self-evident, that all men are created equal, that they are endowed by their Creator with certain unalienable Rights, that among these are Life, Liberty and *the pursuit of Happiness*. <2>
— That to secure these rights, Governments are instituted among Men, deriving their just powers from the consent of the governed, — That whenever any Form of Government becomes destructive of these ends, it is the Right of the People to alter or to abolish it, and to institute new Government, laying its foundation on such principles and organizing its powers in such form, as to them shall seem most likely to effect their Safety and Happiness.
____
<1> Implies the founders believed in link:https://en.wikipedia.org/wiki/Natural_law[Natural law]
<2> The current American cultural conception of "Happiness" link:http://www.patheos.com/blogs/mercynotsacrifice/2013/07/05/property-and-the-pursuit-of-happiness/[tends more toward self-centeredness] which doesn't lead to true happiness at all.

运行上述源代码的asciidoctor转换时,quote块内的标注无法呈现,而quote块后的标注则按预期呈现。命令行输出返回以下错误:

$ asciidoctor quote_block_callouts.adoc
asciidoctor: WARNING: quote_block_callouts.adoc: line 16: no callout found for <1>
asciidoctor: WARNING: quote_block_callouts.adoc: line 17: no callout found for <2>

这种行为是可以预期的,因为它与asciidoctor.org的《 AsciiDoc写作指南》的Building blocks in AsciiDocs部分中记录的替换模式一致,但是如您所见,我希望传递subs =“ verbatim,attributes” quote块的参数可能提供我需要的解决方案。我已经对如何更改报价块的替换模式进行了大量研究,但还没有找到任何文章描述如何进行此操作。我确实在某处看到了一个参考,尽管我不记得在哪里,但是说可以在asciidoctor配置文件中完成。

预先感谢asciidoctor社区可以为找到该问题的解决方案提供任何帮助。

0 个答案:

没有答案