remove
joey
parent
0e0c83146c
commit
99a95f51bf
|
|
@ -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).
|
||||
|
||||
|
|
@ -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]]
|
||||
|
|
@ -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>
|
||||
|
||||
Loading…
Reference in New Issue