doc/shortcuts.mdwn

   1 [[!if test="enabled(shortcut)"
   2      then="This wiki has shortcuts **enabled**."
   3      else="This wiki has shortcuts **disabled**."]]
   4
   5 Some examples of using shortcuts include:
   6
   7         \[[!google foo]]
   8         \[[!wikipedia War_of_1812]]
   9         \[[!debbug 12345]]
  10         Check the \[[!google ikiwiki desc="google search for %s"]].
  11
  12 This page controls what shortcut links the wiki supports.
  13
  14 * [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]]
  15 * [[!shortcut name=archive url="http://web.archive.org/*/%S"]]
  16 * [[!shortcut name=gmap url="https://maps.google.com/maps?q=%s"]]
  17 * [[!shortcut name=gmsg url="https://groups.google.com/groups?selm=%s"]]
  18 * [[!shortcut name=wikipedia url="https://en.wikipedia.org/wiki/%W"]]
  19 * [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]]
  20 * [[!shortcut name=wiktionary url="https://en.wiktionary.org/wiki/%s"]]
  21 * [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian bug #%s"]]
  22 * [[!shortcut name=deblist url="https://lists.debian.org/debian-%s" desc="debian-%s@lists.debian.org"]]
  23 * [[!shortcut name=debpkg url="http://packages.debian.org/%s"]]
  24 * [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]]
  25 * [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]]
  26 * [[!shortcut name=debmsg url="https://lists.debian.org/msgid-search/%s"]]
  27 * [[!shortcut name=debrt url="https://rt.debian.org/Ticket/Display.html?id=%s"]]
  28 * [[!shortcut name=debss url="http://snapshot.debian.org/package/%s/"]]
  29   * Usage: `\[[!debss package]]` or `\[[!debss package/version]]`.  See <http://snapshot.debian.org/> for details.
  30 * [[!shortcut name=debwiki url="https://wiki.debian.org/%s"]]
  31 * [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]]
  32 * [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]]
  33 * [[!shortcut name=gnomebug url="https://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]]
  34 * [[!shortcut name=linuxbug url="https://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]]
  35 * [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]]
  36 * [[!shortcut name=gnulist url="https://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]]
  37 * [[!shortcut name=marcmsg url="http://marc.info/?i=%s"]]
  38 * [[!shortcut name=marclist url="http://marc.info/?l=%s"]]
  39 * [[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]]
  40 * [[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]]
  41 * [[!shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]]
  42 * [[!shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]]
  43 * [[!shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]]
  44 * [[!shortcut name=iki url="http://ikiwiki.info/%S/"]]
  45 * [[!shortcut name=ljuser url="http://%s.livejournal.com/"]]
  46 * [[!shortcut name=rfc url="https://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]]
  47 * [[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]]
  48 * [[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]]
  49 * [[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]]
  50 * [[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]]
  51 * [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]]
  52 * [[!shortcut name=imdb url="http://imdb.com/find?q=%s"]]
  53 * [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]]
  54 * [[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]]
  55 * [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]]
  56 * [[!shortcut name=cve url="https://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]]
  57 * [[!shortcut name=flickr url="https://secure.flickr.com/photos/%s"]]
  58 * [[!shortcut name=man url="http://linux.die.net/man/%s"]]
  59 * [[!shortcut name=ohloh url="https://www.ohloh.net/p/%s"]]
  60 * [[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]]
  61 * [[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %s"]]
  62 * [[!shortcut name=ubupkg url="http://packages.ubuntu.com/%s"]]
  63 * [[!shortcut name=mozillazinekb url="http://kb.mozillazine.org/%s"]]
  64 * [[!shortcut name=freebsdwiki url="http://wiki.freebsd.org/%s"]]
  65 * [[!shortcut name=hackage url="http://hackage.haskell.org/package/%s"]]
  66
  67 To add a new shortcut, use the `shortcut`
  68 [[ikiwiki/directive]]. In the url, "%s" is replaced with the
  69 text passed to the named shortcut, after [[!wikipedia url_encoding]]
  70 it, and '%S' is replaced with the raw, non-encoded text.
  71 Additionally, `%W` is replaced with the text encoded just right for
  72 Wikipedia. The optional `desc` parameter controls the description of
  73 the link.
  74
  75 Remember that the `name` you give the shortcut will become a new
  76 [[ikiwiki/directive]].  Avoid using a `name` that conflicts
  77 with an existing directive.  These directives also accept a `desc`
  78 parameter that will override the one provided at definition time.
  79
  80 If you come up with a shortcut that you think others might find useful,
  81 consider contributing it to the [shortcuts page on the ikiwiki
  82 wiki](http://ikiwiki.info/shortcuts/), so that future versions of
  83 ikiwiki will include your shortcut in the standard underlay.