Using the Trac Tags Plugin on Debian ==================================== Installation ============ To enable the Tags plugin in a specific trac instance, you need to add one line to the [components] section of trac.ini: [components] tractags.* = enabled Configuration ============= Plugin configuration is done in the [tags] stanza of trac.ini. The following config variables are supported as of TracTags 0.10: revisable_realms (list): Comma-separated list of realms requiring tag change history wiki_page_link (boolean): Link a tag to the wiki page with the same name, if it exists wiki_page_prefix (string): Prefix for tag wiki page names cloud_caseless_sort (boolean): Whether the tag cloud should be sorted case-sensitive (TagCloud macro) listtagged_default_table_cols: Select columns and column order for table format (ListTagged macro) listtagged_default_format: Set default format for the handler of the `/tags` domain (ListTagged macro) listtagged_exclude_realms (list): Comma-separated list of realms to exclude from tags queries by default, unless specifically included using 'realm:' in a query (ListTagged macro) listtagged_items_per_page (integer): Number of tagged resources displayed per page of tag query results requested by `ListTagged` macros and from `/tags` (ListTagged macro) ticket_fields (list): List of ticket fields to expose as tags ignore_closed_tickets (boolean): Do not collect tags from closed tickets query_exclude_wiki_templates (boolean: Whether tagged wiki page templates should be queried complete_field: Ticket field to which a drop-down tag list should be attached ticket_help: If specified, 'keywords' label on ticket view will be turned into a link to this URL ticket_help_newwindow (boolean): If true and keyworkds_help specified, wiki page will open in a new window complete_matchcontains: Include partial matches in suggestion list separator: Character(s) to use as separators between tags complete_sticky_tags (list): A list of comma separated values available for input cloud_mincount (integer): Threshold to hide tags with smaller count default_table_cols: Select columns and order for table format default_format: Set the default format for the handler of the /tags domain exclude_realm (list): Comma-separated list of realms to exclude from tags queries by default, unless specifically included using 'realm:' in a query Troubleshooting =============== Tags features not showing up in your trac web UI? Here are some pointers to get you started: Permissions ----------- Remember that you need to grant TAGS_VIEW and/or TAGS_MODIFY to the relevant user account. You can do this with trac-admin. Older versions getting in the way --------------------------------- If you have had an older (non-debian-packaged) version of trac-tags installed, it might take precedence over the debian-packaged version. To fix that, Make sure you get rid of (or move out of the way) all instances of that installation. Here's one (disk-thrashing) way to look for all copies (including files from this package, so use good judgement when cleaning up!): find / -iname '*tractags*' More Info ========= For more info, please see: https://trac-hacks.org/wiki/TagsPlugin -- Daniel Kahn Gillmor , Mon, 15 Apr 2019 21:56:35 -0400