emitting link URLs in a2x -f manpage

17 views
Skip to first unread message

Suraj N. Kurapati

unread,
Jul 31, 2010, 9:55:52 PM7/31/10
to asciidoc
Hello,

I want `a2x -f manpage` to emit link URLs (in addition to emitting
link text, as it currently does). The emitting of link URLs seems
to have been disabled by default as of Version 7.0.3 (2005-12-01):

"Modified ./doc/manpages.xsl so only URL content is displayed in
manpages."
http://www.methods.co.nz/asciidoc/CHANGELOG.html#_version_7_0_3_2005_12_01

How can I re-enable the emitting of link URLs with the modern a2x?
Do I create a new *.xsl file and pass `-a stylesheet=my_manpage.xsl`
to a2x? If so, will my XSL file conflict with the default one?

Thanks for your consideration.

Rainer Müller

unread,
Aug 1, 2010, 9:57:02 PM8/1/10
to asci...@googlegroups.com, Suraj N. Kurapati
On 2010-08-01 03:55 , Suraj N. Kurapati wrote:
> How can I re-enable the emitting of link URLs with the modern a2x?
> Do I create a new *.xsl file and pass `-a stylesheet=my_manpage.xsl`
> to a2x? If so, will my XSL file conflict with the default one?

I am not using a2x, but asciidoc and xsltproc. The attached manpage.xsl
imports the default docbook processing for man pages and then also adds
a "External References" section at the end containing all the links.
This has the style of footnotes, so it does not disturb reading.

HTH,
Rainer

manpage.xsl

Suraj Kurapati

unread,
Aug 10, 2010, 8:48:46 PM8/10/10
to Rainer Müller, asci...@googlegroups.com
On Sun, Aug 1, 2010 at 6:57 PM, Rainer Müller <rai...@codingfarm.de> wrote:
> On 2010-08-01 03:55 , Suraj N. Kurapati wrote:
>> How can I re-enable the emitting of link URLs with the modern a2x?
>
> I am not using a2x, but asciidoc and xsltproc. The attached manpage.xsl
> imports the default docbook processing for man pages and then also adds
> a "External References" section at the end containing all the links.

Thank you! I was able to use your stylesheet successfully:

asciidoc -o man.xml -d manpage -b docbook man.txt
mkdir -p man/man1
xsltproc -o man/man1/inochi.1 manpage.xsl man.xml

Cheers.

Reply all
Reply to author
Forward
0 new messages