Version 18 (modified by 14 years ago) (diff) | ,
---|
Wiki Goodies for Trac
Description
This plugin extends the Trac Wiki in several ways:
- Support for displaying smileys, as in MoinMoin, with a few exceptions (no flags, "priority" smileys are renamed {p1} instead of {1} in order to be compatible with report: shorthand links)
- HTML 4.0 entities (named entities and numerical entities)
- Automatic replacement of common text idioms by their corresponding symbols (e.g. arrows, fractions, etc.)
- Simplified markup for single words:
*this* /is/ _important_
becomes this is important - Replace <name@domain> with "mailto:" links (obfuscated if needed) (0.11 only - though that's now in Trac core)
- Replace
... UNC paths with "file:///" links (0.11 only)
Each feature can be disabled individually if needed.
More about UNC path support
Turning off the UNC paths transformation might be seen as a security measure and if someone can demonstrate that this feature presents a security risk, I'll disable it by default in future releases. But here, the "file:" links are user-oriented and can't possibly be embedded in a <img> tag or Javascript code, so I don't really see what could be the risk, and I think it's OK to enable this feature by default.
Firefox doesn't do anything with the file:
links, but
users can use the LocalLink plugin
(install).
Alternatively, I use the "Open Link in Ext.App." contextual menu entry provided by the IETab plugin (install), and this works great.
Local Paths
Using IETab within Firefox even allows you to use links local paths
(say, S:\Public\File.txt
) by using the equivalent UNC path \\?\S:\Public\File.txt
,
which is recognized as a link by the plugin and will be opened correctly by IETab
"Open Link in Ext.App.".
Note that S:\Public\File.txt itself isn't recognized as a link (and probably
will never be, as that will conflict with one letter InterTrac prefixes) and
that the file:///?/
file link produced by the plugin are not
understood by IE7 or IETab plugin "Open Link in IE Tab" (I haven't tested
the LocalLink plugin).
Bugs/Feature Requests
Existing bugs and feature requests for WikiGoodiesPlugin are here.
Known Issues
No results
If you have any new issue of feature request, create a new ticket.
Installation
Download
Download the zipped source:
Trac Version | Zip |
0.9.3 and above, 0.10 | [download:wikigoodiesplugin/0.9] |
0.11 | [download:wikigoodiesplugin/0.11] |
Checkout
You can check out the source for WikiGoodiesPlugin from Subversion at http://trac-hacks.org/svn/wikigoodiesplugin or browse the code from within Trac (recommended!).
Enabling The Plugin
See generic instructions in Trac:TracPlugins#InstallingaTracPlugin.
If you need to enable the plugin in the trac.ini, use:
[components] goodies.* = enabled
Example
There are 3 new macros that can be used to conveniently display all the newly introduced markup.
Simply copy&paste the following wiki snippet somewhere into your Wiki (e.g. in WikiFormatting):
=== Additional Goodies === ==== Smileys ==== [[ShowSmileys(5)]] ==== Entities ==== [[ShowEntities(4)]] ==== Symbols ==== [[ShowSymbols(5)]]
(the argument is the number of columns to be used in the displayed table)
For the entities, only the named ones are shown. For help on using the numerical entities, see for example those tips.
See Also
The EmoticonsPlugin also provides support for smileys, and is a little bit more lightweight than this plugin.
Author/Contributors
Author: cboos
Contributors: