summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/contrib/shortcuts.mdwn47
1 files changed, 47 insertions, 0 deletions
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).
+