From 296117a0f1ac3dc3b2dd82e8284dedb67bab3f54 Mon Sep 17 00:00:00 2001 From: joey Date: Tue, 10 Oct 2006 14:32:03 +0000 Subject: web commit by VictorMoral: presentation of a new ikiwiki plugin --- doc/contrib/shortcuts.mdwn | 47 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 doc/contrib/shortcuts.mdwn (limited to 'doc/contrib') diff --git a/doc/contrib/shortcuts.mdwn b/doc/contrib/shortcuts.mdwn new file mode 100644 index 000000000..eb13bb106 --- /dev/null +++ b/doc/contrib/shortcuts.mdwn @@ -0,0 +1,47 @@ +[[template id=plugin name=shortcuts included=0 author="[[VictorMoral]]"]] +[[tag type/format]] + +*shortcuts* is a plugin for make external links easy in a ikiwiki page. +It filter the raw source code, searching *wafl expresions* and replacing it +for ikiwiki links and not for html links. + +*Note: my apologies for my poor english, my mother language is the spanish. +Any corrections are welcome :-).* + +In the source page you need include the expresions as: + + For my {wiki:UPS} APC i need the {deb:apcupsd} package installed. You can + found {google:apc linux|many positive responses}. + +and after filter this is the result: + + For my [UPS](http://en.wikipedia.org/wiki/UPS) i need the + [apcupsd](http://packages.debian.org/). You can found + [many positive responses](http://www.google.com/search?q=apc+linux). + +If you need escape a walf expression prefix with a backslash character as in: + + This is a \{cpan:example}. + +This module is inspired in Kwiki::Shortcuts with minor diferences. The wafl +expresions are strings between braces with the following elements: + +* one name (followed by one colon character) +* one o many search terms +* an optional text for the link + +The plugin provides some predefined shortcuts, and it can use a external +definitions file. This file is named *shortcuts.conf* by default, but it can +be set with the *shortcuts* parameter and configuration variable. + +The next shortcuts are predefined: + +- google: http://www.google.com/search?q= +- deb: http://packages.debian.org/ +- dbug: http://bugs.debian.org/ +- cpan: http://search.cpan.org/search?mode=dist&query= +- wiki: http://en.wikipedia.org/wiki/ + +Use the external Perl module: URI::Escape and it can be found +[here](http://taquiones.net/files/misc/IkiWiki-Plugin-shortcuts-0.3.tar.gz). + -- cgit v1.2.3