2007-12-08 21:59:08 +01:00
|
|
|
[[plugins/shortcut]] creates link shortcut [[ikiwiki/PreprocessorDirective]]s,
|
2006-11-20 12:31:23 +01:00
|
|
|
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
|
2008-07-21 13:45:54 +02:00
|
|
|
the example [[shortcuts]], `\[[!wikipedia ikiwiki]]` generates a link to
|
2006-11-20 12:31:23 +01:00
|
|
|
<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,
|
2008-07-21 13:45:54 +02:00
|
|
|
`\[[!debbug 397501]]` generates a link to <http://bugs.debian.org/397501>,
|
2006-11-20 12:31:23 +01:00
|
|
|
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.
|
2008-07-21 13:45:54 +02:00
|
|
|
Thus, something like `\[[!shortcut name=debbug
|
2006-11-20 12:31:23 +01:00
|
|
|
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
|
2008-07-21 13:45:54 +02:00
|
|
|
might use something like `\[[!shortcut name=debbug
|
2006-11-20 12:31:23 +01:00
|
|
|
url="http://bugs.debian.org/%s" desc="Debian bug #%s"]]`.
|
|
|
|
|
|
|
|
|
|
> [[todo/done]] --[[Joey]]
|
