[RFC/NOPATCHv3 2/4] doc: add linkgit macros for asciidoctor
- From
Felipe Contreras <felipe.contreras@gmail.com>
- Date
- Jun 18, 2021, 20:30 UTC
- Message-ID
- <20210618203057.790320-3-felipe.contreras@gmail.com>
- In-Reply-To
- <20210618203057.790320-1-felipe.contreras@gmail.com>
From: "brian m. carlson" <sandals@crustytoothpaste.net>
We also need to update the code that tells Asciidoctor how to format our linkgit macros so that it can output proper code for man pages. Be careful to reset the font to the previous after the change. In order to do so, we must reset to the previous after each font change so the previous state at the end is the state before our inserted text, since troff only remembers one previous font. We insert \e before each font-change backslash so Asciidoctor doesn't convert them into \*(rs, the reverse solidus character, and instead leaves them as we wanted them.
Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net> --- Documentation/asciidoctor-extensions.rb | 2 ++ 1 file changed, 2 insertions(+)
diff --git a/Documentation/asciidoctor-extensions.rb b/Documentation/asciidoctor-extensions.rb index d906a00803..620b3d7a88 100644 --- a/Documentation/asciidoctor-extensions.rb +++ b/Documentation/asciidoctor-extensions.rb @@ -15,6 +15,8 @@ module Git "#{target}(#{attrs[1]})</ulink>" elsif parent.document.basebackend? 'html' %(<a href="#{prefix}#{target}.html">#{target}(#{attrs[1]})</a>) + elsif parent.document.basebackend? 'manpage' + %(\e\\fB#{target}\e\\fP\e\\fR(#{attrs[1]})\e\\fP) elsif parent.document.basebackend? 'docbook' "<citerefentry>\n" \ "<refentrytitle>#{target}</refentrytitle>" \
-- 2.32.0