Re: [PATCH 0/8] asciidoc fixups

From: brian m. carlson <sandals@crustytoothpaste.net>
Date: May 15, 2015, 02:52 UTC
Message-ID: <20150515025223.GB4665@vauxhall.crustytoothpaste.net>
In-Reply-To: <20150514042544.GA9351@peff.net>

On Thu, May 14, 2015 at 12:25:44AM -0400, Jeff King wrote:

Show 16 quoted lines

> 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">
>     &#8212; 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.

Show 6 quoted lines

> 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