wiki:AcronymsPlugin

Version 9 (modified by Ryan J Ollos, 13 years ago) (diff)

Additional clarifications, as described in http://trac-hacks.org/ticket/4532#comment:3

Auto-generated acronyms from a table in a Wiki page

Notice: This plugin is unmaintained and available for adoption.

Description

Automatically generates HTML acronyms from definitions in tables in a Wiki page (AcronymDefinitions by default).

Acronyms are in the form <acronym>[<id>] and are defined in a table with four columns:

Acronym, Description [, URL [, ID URL]]

Only the first two columns are required.

URL can be the name of a wiki page, the name of which does not have to be CamelCase and can even be a subpage (e.g. MyPage/MySubPage), or an external resource. If an <id> is provided, the ID URL is used and any occurrences of the symbol $1 in the description and the ID URL are substituted with the <id>.

Rows starting with ||' are ignored.

Bugs/Feature Requests

Existing bugs and feature requests for AcronymsPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from [download:acronymsplugin here].

Source

You can check out AcronymsPlugin from here using Subversion, or browse the source with Trac.

Configuration

Create a Wiki page holding your acronym definitions in the way described above (for example Acronyms).

In trac.ini add the following section to make the plugin aware of this storage page:

[acronym]
page = Acronyms

Example

The following acronym definition table:

||'''Acronym'''||'''Description'''        ||'''URL'''                    ||'''ID URL'''||
||RFC          ||Request For Comment $1   ||http://www.ietf.org/rfc.html ||http://www.ietf.org/rfc/rfc$1.txt||
||RFC2316      ||Request For Comment 2316 ||Rfc2316                      || ||

Has the following effect:

RFC becomes

    <a href="http://www.ietf.org/rfc.html">
     <acronym title="Request For Comment">
      RFC
     </acronym>
    </a>

RFC2315 becomes

    <a href="http://www.ietf.org/rfc/rfc2315.txt">
     <acronym title="Request For Comment 2315">
      RFC 2315
     </acronym>
    </a>

RFC2316 becomes

    <a href="Rfc2316">
     <acronym title="Request For Comment 2316">
      RFC2316
     </acronym>
    </a>

Recent Changes

16764 by rjollos on 2017-08-26 02:53:36
TracAcronyms 0.2: Fix typo
16397 by rjollos on 2017-03-25 09:37:00
Remove obsolete "0.9" code
14820 by rjollos on 2015-07-20 04:38:06
0.2: Require Trac >= 0.11.
(more)

Author/Contributors

Author: athomas
Maintainer: athomas
Contributors: