aboutsummaryrefslogtreecommitdiff
path: root/doc/todo/shortcut_link_text.mdwn
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-11-20 07:13:32 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-11-20 07:13:32 +0000
commit1a8cc77b375d543caef15665323ab7971f2fb83d (patch)
tree4207e1408cae58208134120c8e5cc2e4d2d89c0c /doc/todo/shortcut_link_text.mdwn
parentaf85816bbc752fea174b9f6cee44d39da28a6d9c (diff)
downloadikiwiki-1a8cc77b375d543caef15665323ab7971f2fb83d.tar
ikiwiki-1a8cc77b375d543caef15665323ab7971f2fb83d.tar.gz
web commit by JoshTriplett
Diffstat (limited to 'doc/todo/shortcut_link_text.mdwn')
-rw-r--r--doc/todo/shortcut_link_text.mdwn1
1 files changed, 1 insertions, 0 deletions
diff --git a/doc/todo/shortcut_link_text.mdwn b/doc/todo/shortcut_link_text.mdwn
new file mode 100644
index 000000000..31820836b
--- /dev/null
+++ b/doc/todo/shortcut_link_text.mdwn
@@ -0,0 +1 @@
+[[plugins/shortcut]] creates link shortcut [[PreprocessorDirective]]s, which substitute their argument into the specified shortcut URL to generate the link target, and use the argument as the link text. For example, given the example [[shortcuts]], `\[[wikipedia ikiwiki]]` generates a link to <http://en.wikipedia.org/wiki/ikiwiki>, with the link text "ikiwiki". This works well in many cases; however, for things like the `debbug` example, it simply uses the number as the link text, which does not always provide enough context to understand the link at first glance. For example, `\[[debbug 397501]]` generates a link to <http://bugs.debian.org/397501>, with just "397501" as the link text. While [[plugins/template]] provides a general solution for arbitrary cases, it would help to have a simple option via the shortcut plugin to set the link text, with a `%s` substitution. Thus, something like `\[[shortcut name=debbug url="http://bugs.debian.org/%s" desc="bug #%s"]]` might suffice on a Debian-specific wiki to indicate a bug number, while a more general wiki might use something like `\[[shortcut name=debbug url="http://bugs.debian.org/%s" desc="Debian bug #%s"]]`. \ No newline at end of file