From 67274a9b6ffbb6266e253746bb257847e48e5566 Mon Sep 17 00:00:00 2001 From: Thomas De Schampheleire Date: Fri, 15 Aug 2014 15:40:37 +0200 Subject: [PATCH] manual-text: make sure URLs are displayed if a link text was provided When the asciidoc source contain URLs of the form: http://example.com[An example website] the text representation of the manual would only contain: An example website without displaying the actual URL. This patch adds an asciidoc configuration file that sets the inline macros for several URL types so that the display becomes: An example website [http://example.com] For URLs where no link text was provided, the display becomes: http://example.com which is the same as before. Signed-off-by: Thomas De Schampheleire Acked-by: Samuel Martin Reviewed-by: "Yann E. MORIN" Tested-by: "Yann E. MORIN" Signed-off-by: Thomas Petazzoni --- docs/manual/asciidoc-text.conf | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/manual/asciidoc-text.conf diff --git a/docs/manual/asciidoc-text.conf b/docs/manual/asciidoc-text.conf new file mode 100644 index 0000000000..671cf3abc5 --- /dev/null +++ b/docs/manual/asciidoc-text.conf @@ -0,0 +1,17 @@ +# Refer to following asciidoc documentation: +# http://www.methods.co.nz/asciidoc/userguide.html +# In particular sections "Macros" and "Attribute References" +# +# For hyperlinks, show 'link text [URL]' (if link text provided) or 'URL' +[http-inlinemacro] +{0=}{0? [}{name}:{target}{0?]} +[https-inlinemacro] +{0=}{0? [}{name}:{target}{0?]} +[ftp-inlinemacro] +{0=}{0? [}{name}:{target}{0?]} +[file-inlinemacro] +{0=}{0? [}{name}:{target}{0?]} +[irc-inlinemacro] +{0=}{0? [}{name}:{target}{0?]} +[mailto-inlinemacro] +{0=}{0? [}{name}:{target}{0?]}