26 | | See generic instructions in Trac:TracPlugins#InstallingaTracPlugin. |
27 | | |
28 | | === Enable === |
29 | | |
30 | | If you need to enable the plugin in the trac.ini, use: |
31 | | {{{ |
32 | | [components] |
33 | | goodies.* = enabled |
34 | | }}} |
35 | | |
36 | | == Usage == |
37 | | |
38 | | There are 3 new macros that can be used to conveniently display all the newly introduced markup. |
39 | | |
40 | | Simply copy&paste the following wiki snippet somewhere into your Wiki (e.g. in WikiFormatting): |
41 | | |
42 | | Note:: the argument below - between '( )' - is the number of columns to be used in the displayed table. |
43 | | |
44 | | === Smileys === |
45 | | {{{ |
46 | | [[ShowSmileys(5)]] |
47 | | }}} |
48 | | |
49 | | === Entities === |
50 | | {{{ |
51 | | [[ShowEntities(4)]] |
52 | | }}} |
53 | | |
54 | | For the entities, only the named ones are shown. |
55 | | |
56 | | For help on using the numerical entities, see for example those [http://home.tiscali.nl/t876506/entitiesTips.html tips]. |
57 | | |
58 | | === Symbols === |
59 | | {{{ |
60 | | [[ShowSymbols(5)]] |
61 | | }}} |
62 | | |
63 | | == Bugs/Feature Requests == |
| 28 | == Bugs/Feature Requests |
72 | | If you have any new issue of feature request, create a |
73 | | [http://trac-hacks.org/newticket?component=WikiGoodiesPlugin&owner=cboos new ticket]. |
74 | | |
75 | | == More about UNC path support == |
76 | | |
77 | | Turning off the UNC paths transformation might be seen as a |
78 | | [http://kb.mozillazine.org/Links_to_local_pages_don%27t_work security measure] |
79 | | and if someone can demonstrate that this feature presents |
80 | | a security risk, I'll disable it by default in future releases. |
81 | | But here, the "file:" links are user-oriented and can't possibly be embedded |
82 | | in a <img> tag or Javascript code, so I don't really see what could be the risk, |
83 | | and I think it's OK to enable this feature by default. |
84 | | |
85 | | Firefox doesn't do anything with the `file:` links, but |
86 | | users can use the [http://locallink.mozdev.org/ LocalLink] plugin |
87 | | ([https://addons.mozilla.org/en-US/firefox/addon/281 install]). |
88 | | |
89 | | Alternatively, I use the ''"Open Link in Ext.App."'' contextual menu entry provided |
90 | | by the [http://ietab.mozdev.org/ IETab] plugin |
91 | | ([https://addons.mozilla.org/en-US/firefox/addon/1419 install]), |
92 | | and this works great. |
93 | | |
94 | | Chrome has also its own [https://chrome.google.com/webstore/detail/jllpkdkcdjndhggodimiphkghogcpida LocalLinks] plugin, which was modeled after the Firefox extension. |
95 | | |
96 | | |
97 | | === Local Paths === |
98 | | |
99 | | Using IETab within Firefox even allows you to use links local paths |
100 | | (say, `S:\Public\File.txt`) by using the equivalent UNC path `\\?\S:\Public\File.txt`, |
101 | | which is recognized as a link by the plugin and will be opened correctly by IETab |
102 | | ''"Open Link in Ext.App."''. |
103 | | Note that S:\Public\File.txt itself isn't recognized as a link (and probably |
104 | | will never be, as that will conflict with one letter InterTrac prefixes) and |
105 | | that the `file:///?/` file link produced by the plugin are ''not'' |
106 | | understood by IE7 or IETab plugin ''"Open Link in IE Tab"'' (I haven't tested the !LocalLink plugin). |
107 | | |
108 | | == Source code & Download == |
| 38 | == Download and Source |
120 | | === Recent Changes === |
| 50 | == Installation |
| 51 | |
| 52 | See generic instructions in Trac:TracPlugins#InstallingaTracPlugin. |
| 53 | |
| 54 | If you need to enable the plugin in the `trac.ini` file, use: |
| 55 | {{{#!ini |
| 56 | [components] |
| 57 | goodies.* = enabled |
| 58 | }}} |
| 59 | |
| 60 | == Usage |
| 61 | |
| 62 | There are 3 new macros that can be used to conveniently display all the newly introduced markup. |
| 63 | |
| 64 | Simply copy&paste the following wiki snippet somewhere into your Wiki (e.g. in WikiFormatting): |
| 65 | |
| 66 | Note:: the argument below - between '( )' - is the number of columns to be used in the displayed table. |
| 67 | |
| 68 | === Smileys |
| 69 | |
| 70 | {{{ |
| 71 | [[ShowSmileys(5)]] |
| 72 | }}} |
| 73 | |
| 74 | === Entities |
| 75 | |
| 76 | {{{ |
| 77 | [[ShowEntities(4)]] |
| 78 | }}} |
| 79 | |
| 80 | For the entities, only the named ones are shown. |
| 81 | |
| 82 | For help on using the numerical entities, see for example those [http://home.tiscali.nl/t876506/entitiesTips.html tips]. |
| 83 | |
| 84 | === Symbols |
| 85 | |
| 86 | {{{ |
| 87 | [[ShowSymbols(5)]] |
| 88 | }}} |
| 89 | |
| 90 | == More about UNC path support |
| 91 | |
| 92 | Turning off the UNC paths transformation might be seen as a [http://kb.mozillazine.org/Links_to_local_pages_don%27t_work security measure] and if someone can demonstrate that this feature presents a security risk, I'll disable it by default in future releases. |
| 93 | 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. |
| 94 | |
| 95 | Firefox doesn't do anything with the `file:` links, but users can use the [http://locallink.mozdev.org/ LocalLink] plugin |
| 96 | ([https://addons.mozilla.org/en-US/firefox/addon/281 install]). |
| 97 | |
| 98 | Alternatively, I use the ''"Open Link in Ext.App."'' contextual menu entry provided by the [http://ietab.mozdev.org/ IETab] plugin |
| 99 | ([https://addons.mozilla.org/en-US/firefox/addon/1419 install]) and this works great. |
| 100 | |
| 101 | Chrome has also its own [https://chrome.google.com/webstore/detail/jllpkdkcdjndhggodimiphkghogcpida LocalLinks] plugin, which was modeled after the Firefox extension. |
| 102 | |
| 103 | === Local Paths |
| 104 | |
| 105 | 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."''. |
| 106 | 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). |
| 107 | |
| 108 | == Recent Changes |