diff options
| -rw-r--r-- | doc/plugins/contrib/shortcuts.mdwn | 93 | ||||
| -rw-r--r-- | doc/plugins/contrib/shortcuts/discussion.mdwn | 42 | ||||
| -rw-r--r-- | doc/plugins/contrib/shortcuts/victormoral.mdwn | 4 |
3 files changed, 0 insertions, 139 deletions
diff --git a/doc/plugins/contrib/shortcuts.mdwn b/doc/plugins/contrib/shortcuts.mdwn deleted file mode 100644 index 46fb0f763..000000000 --- a/doc/plugins/contrib/shortcuts.mdwn +++ /dev/null @@ -1,93 +0,0 @@ -[[template id=plugin name=shortcuts included=0 author="[[VictorMoral]]"]] -[[tag type/format]] -[[meta title="shortcuts (third-party plugin)"]] - -## version 0.4 - -Following the suggestions of Joey i'm rewriting the module and now the old syntax is not supported. - -The plugin process directives as - - [[shortcut deb ikiwiki "a good wiki"]] - -and transform it in - - \[a good wiki](http://packages.debian.org/ikiwiki) - -It uses a special ikiwiki page named *shortcuts.mdwn* where to extract the shortcuts definitions from one list, similar to the smileys plugin. - - * DEB http://packages.debian.org - * rfc http://www.ietf.org/rfc/rfc%s.txt - * docbook http://www.docbook.org/tdg/en/html/%s.html - -If the shortcut name is in uppercase, it is register through *hook()* function (in lowercase) as a new preprocessor directive. In the above example the ikiwiki page should be - - [[deb ikiwiki "a good wiki"]] - I need read [[shortcut rfc 14567 "this document"]] before ... - -In the URL part of the definition, a **%s** string will be replaced with the first param of the directive. If it's missing that param will be added to the end of the URL. - -By default, the module provides a few shortcuts (not preregistered): - -* deb http://packages.debian.org/%s -* wiki http://en.wikipedia.org/wiki/%s -* google http://www.google.com/search?q=%s -* dbug http://bugs.debian.org/%s -* cpan http://search.cpan.org/search?mode=dist&query=%s - -The new version can be download from [here](http://taquiones.net/files/misc/IkiWiki-Plugin-shortcuts-0.4.tar.gz). - -Joey, could be merge with your module in any form ? - -Again, my apologies for the duplicate efforts. - ----- - -Note: This plugin is different than the "shortcut" plugin now included in -ikiwiki. I'm leaving it here in case people prefer how this one works. ---[[Joey]] - -*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). - diff --git a/doc/plugins/contrib/shortcuts/discussion.mdwn b/doc/plugins/contrib/shortcuts/discussion.mdwn deleted file mode 100644 index 8f6951027..000000000 --- a/doc/plugins/contrib/shortcuts/discussion.mdwn +++ /dev/null @@ -1,42 +0,0 @@ -Ah, this is something I've been meaning to look into adding for a while. - -I think it might be a good idea to make the page that configures the -shortcuts be a regular page in the wiki, as was done with the smilies -plugin. Of course, it would need to avoid abuse since anyone could edit it -then (unless it were locked). - -The other thing that I wondered as I looked at this is, why add a new -syntax for the shortcuts? It would be less complex, and probably easier to -implement if it used an existing syntax. The shortcuts could just use a -preprocessor directive: - - \[[shortcut dbug 30303]] - -If that's not short enough, it would be possible to register a preprocessor -directive per shortcut, yeilding this syntax: - - \[[dbug 30303]] - -Unless I'm missing something and a "walf expression" is something already -standard across wikis, this approach seems cleaner and easier to learn for -ikiwiki users. - ---[[Joey]] - -Update: I've added a "shortcut" plugin that works as described above. ---[[Joey]] - -Update: Ops ! I'm late. Following your suggestions i'm rewriting my module and this morning it is functional. My apologies for don't reply. Should be discard my module ? - ---[[VictorMoral]] - -Argh, sorry for the duplicate work. - -I think that any features this module has that are not in the version I -wrote should be merged into mine, if possible. - ---[[Joey]] - -Ok, Joey. I'm working in it. I'll send a patch soon. - ---[[VictorMoral]] diff --git a/doc/plugins/contrib/shortcuts/victormoral.mdwn b/doc/plugins/contrib/shortcuts/victormoral.mdwn deleted file mode 100644 index e98231d3a..000000000 --- a/doc/plugins/contrib/shortcuts/victormoral.mdwn +++ /dev/null @@ -1,4 +0,0 @@ -I'm a Perl programmer from Madrid, Spain. I'm using Linux systems nine years ago. - -My email is <victor@taquiones.net> - |