From: Thomas De Schampheleire <patrickdepinguin@gmail.com>
To: buildroot@busybox.net
Subject: [Buildroot] [PATCH 4 of 5 v3 for 2014.08] manual-text: make sure URLs are displayed if a link text was provided
Date: Wed, 13 Aug 2014 21:25:50 +0200 [thread overview]
Message-ID: <72d825eab688116985f2.1407957950@localhost> (raw)
In-Reply-To: <patchbomb.1407957946@localhost>
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 <thomas.de.schampheleire@gmail.com>
---
v3: no changes
v2:
- link to relevant documentation (which was hard to find)
- refine so that the display is identical to before when no link text is
provided.
docs/manual/asciidoc-text.conf | 17 +++++++++++++++++
1 files changed, 17 insertions(+), 0 deletions(-)
diff -r 7437dd86ef45 -r 72d825eab688 docs/manual/asciidoc-text.conf
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/manual/asciidoc-text.conf Sat Aug 09 19:42:30 2014 +0200
@@ -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?]}
next prev parent reply other threads:[~2014-08-13 19:25 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-08-13 19:25 [Buildroot] [PATCH 0 of 5 v3 for 2014.08] manual-text generation improvements Thomas De Schampheleire
2014-08-13 19:25 ` [Buildroot] [PATCH 1 of 5 v3 for 2014.08] Makefile: unconditionally include pkg-utils.mk Thomas De Schampheleire
2014-08-15 10:14 ` Samuel Martin
2014-08-13 19:25 ` [Buildroot] [PATCH 2 of 5 v3 for 2014.08] gendoc infra: use $(pkgname) instead of explicitly passing 'manual' Thomas De Schampheleire
2014-08-15 10:14 ` Samuel Martin
2014-08-15 11:04 ` Samuel Martin
2014-08-15 11:07 ` Samuel Martin
2014-09-07 12:45 ` Yann E. MORIN
2014-08-13 19:25 ` [Buildroot] [PATCH 3 of 5 v3 for 2014.08] gendoc infra: add support for asciidoc configuration files Thomas De Schampheleire
2014-08-15 10:14 ` Samuel Martin
2014-08-13 19:25 ` Thomas De Schampheleire [this message]
2014-08-15 10:14 ` [Buildroot] [PATCH 4 of 5 v3 for 2014.08] manual-text: make sure URLs are displayed if a link text was provided Samuel Martin
2014-08-13 19:25 ` [Buildroot] [PATCH 5 of 5 v3 for 2014.08] manual-text: hide image representations Thomas De Schampheleire
2014-08-15 10:15 ` Samuel Martin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=72d825eab688116985f2.1407957950@localhost \
--to=patrickdepinguin@gmail.com \
--cc=buildroot@busybox.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.