Changes between Version 84 and Version 85 of TagsPlugin


Ignore:
Timestamp:
Nov 20, 2015, 11:54:21 AM (8 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • TagsPlugin

    v84 v85  
    1717As an added bonus, tags are linked to the wiki entry of the same name, allowing you to describe them explicitly under the wiki entry of the same name. This allows for a flexible means for establishing the context of wiki entries. Besides this, tags also make it incredibly easy to create todo lists or indexes.
    1818
    19 Tags don't have to be predefined. As long as there are wiki entries categorized under a tag, it'll be automatically created.
    20 
    21 Tags are similar to labels in gmail, tags in the social bookmark manager del.icio.us and Flickr. They are substantially different from [http://meta.wikimedia.org/wiki/Categories Wikipedia categories], because tags are associated with wiki entries of the same name, whereas WikiMedia Categories are just indexes.
     19Tags don't have to be predefined. As long as there are wiki entries categorized under a tag, it will be automatically created.
     20
     21Tags are similar to labels in Gmail, tags in the social bookmark manager del.icio.us and Flickr. They are substantially different from [http://meta.wikimedia.org/wiki/Categories Wikipedia categories], because tags are associated with wiki entries of the same name, whereas WikiMedia Categories are just indexes.
    2222
    2323This implementation of wiki tagging is specific to [wiki:TracGuide Trac]. To stay consistent with the way Trac names wiki entries, tags are case sensitive. Trac Hacks itself makes extensive use of tagging and is a good example of their use.
     
    3030
    3131 1. Go to the wiki entry you want to tag.
    32  2. Click on ''Edit This Page''.
    33  3. Under ''Change information'', ''Tag under:'', enter the tags you want to categorize the entry under. Separate tags with spaces.
    34  4. Click ''Save changes''.
     32 1. Click on ''Edit This Page''.
     33 1. Under ''Change information'', ''Tag under:'', enter the tags you want to categorize the entry under. Separate tags with spaces.
     34 1. Click ''Save changes''.
    3535
    3636The wiki entry you edit is now categorized under the tags you specified.
     
    4343
    4444 1. Go to the wiki entry you want to ''untag''.
    45  2. Click on ''Edit This Page''.
    46  3. Under ''Change information'', ''Tag under:'', remove the tag from the list.
    47  4. Click ''Save changes''.
     45 1. Click on ''Edit This Page''.
     46 1. Under ''Change information'', ''Tag under:'', remove the tag from the list.
     47 1. Click ''Save changes''.
    4848
    4949The tag removal process for tickets is similar, and can be found under the `keywords` field.
     
    7373==== /tags handler
    7474
    75 Going to /tags under your project will show a list of all tags in the wiki. /tags/?q=<query> will show all the objects matching ''<query>'', eg [http://trac-hacks.org/tags/?q=plugin]. This accepts all the parameters that the !ListTagged macro does, eg [http://trac-hacks.org/tags?q=plugin%20or%20macro].
     75Going to /tags under your project will show a list of all tags in the wiki. `/tags/?q=<query>` will show all the objects matching ''<query>'', eg [https://trac-hacks.org/tags/?q=plugin]. This accepts all the parameters that the !ListTagged macro does, eg [https://trac-hacks.org/tags?q=plugin%20or%20macro].
    7676
    7777==== `tag:<tag>` or `tagged:<query>`
     
    122122== Download
    123123
    124 You can download the zipped source from [download:tagsplugin here].
     124You can download the zipped source from [export:tagsplugin here].
    125125
    126126== Source
    127127
    128 You can check out !TagsPlugin from [http://trac-hacks.org/svn/tagsplugin here] using Subversion, or [source:tagsplugin browse the source] with Trac.
     128You can check out !TagsPlugin from [/svn/tagsplugin here] using Subversion, or [source:tagsplugin browse the source] with Trac.
    129129
    130130== Installation
     
    139139   * Plugin: tractags-0.7 is required for Trac >= 1.0 (see #9521)
    140140      1. Manually:
    141          1. Download tags: [download:tagsplugin/tags/0.7 tags-0.7.zip] or grab
     141         1. Download tags: [export:tagsplugin/tags/0.7 tags-0.7.zip] or grab
    142142            [/svn/tagsplugin/tags/0.7 the source] from SVN.
    143143         2. [trac:wiki:TracPlugins Build and install an egg] from this source.
     
    164164revisable_realms = wiki
    165165}}}
    166  1. '''Enable''' plugin by updating your TracIni file (`..../trac.ini`) with:
     166 1. '''Enable''' plugin by updating your TracIni file (`../conf/trac.ini`) with:
    167167 {{{#!ini
    168168[components]
     
    177177    $ sudo /etc/init.d/apache2 restart
    178178    }}}
    179  1. '''Grant''' `TAGS_VIEW` and `TAGS_MODIFY` permissions to your users according to the policies that you'd like to implement. Permissions are assigned since v0.7 for a new install to anonymous and authenticated users respectively, and you'll only need to adjust that to your needs.
     179 1. '''Grant''' `TAGS_VIEW` and `TAGS_MODIFY` permissions to your users according to the policies that you like to implement. Permissions are assigned since v0.7 for a new install to anonymous and authenticated users respectively, and you will only need to adjust that to your needs.
    180180 1. '''Test''' the plugin and you should see a text control for tags in your Wiki edit page. You should also see an entry in the main navigation bar labeled ''Tags''.
    181181