On Thu, May 14, 2015 at 12:25:44AM -0400, Jeff King wrote:
> On Wed, May 13, 2015 at 10:41:31PM +0000, brian m. carlson wrote:
> > What you want here is [verse,subs=normal]. As of Asciidoctor 1.5.0,
> > this allows substitutions and markup within verse blocks. I believe old
> > versions of AsciiDoc did not render substitutions and markup in verse
> > blocks, despite claiming to, and Asciidoctor picked up that behavior.
>
> That does work for AsciiDoctor, but sadly it seems to break rendering
> for AsciiDoc, where it puts:
>
> <div class="attribution">
> — subs=normal
> </div>
>
> in the middle of the SYNOPSIS. Yuck. Is there a way to make it work
> under both? Or a way to configure AsciiDoctor verses to always use
> "subs=normal"?
Using Asciidoctor 1.5.0, it seems to work properly for me without
subs=normal. So perhaps we should just update the version used for the
site. I realize the Debian version is out of date; I've already filed a
bug.
> I actually prefer backticks in many cases, but they do come with their
> own formatting. Surely there is a way in AsciiDoctor to say "do not
> interpret this magically, but also do not format it as monospace"?
>
> I guess the nuclear option is using attributes like {litdd} everywhere
> to avoid quoting. But it makes the source so ugly and hard to read.
I opened issue 1344[0] for this. However, it looks like we can write
<refname>@+++{+++<date>+++}+++ instead of <refname>@\{<date>\} and it
will work correctly in both processors. That looks to be a workaround,
as ugly and verbose as it is.
[0] https://github.com/asciidoctor/asciidoctor/issues/1344
--
brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
Attachment:
signature.asc
Description: Digital signature