Posted by oddhack on Apr 08, 2021; 2:40am
URL: https://discuss.asciidoctor.org/Should-attribute-expansion-be-suppressed-in-the-Name-section-of-a-manpage-document-tp8583.html

Is there a reason attribute expansion is performed differently in the 'Name' section of the following document depending on whether it's processed with default or 'manpage' document type?

= attribs(3)
:value: fnord

== Name

Name - value is {value}

== Synopsis

Synopsis - value is {value}                

When run through 'asciidoctor -b html5 -d manpage', the output of the 'Name' section looks like:

Name - value is {value}

When run through 'asciidoctor -b html5', the output looks (as intended) like:

Name - value is fnord

I don't see any obvious reason in Generate Manual Pages from AsciiDoc that attribute expansion would not be performed in the first case - am I missing something documented? If not, is there a workaround?

asciidoctor 2.0.12, Ruby 2.5.3