Discussion

• Concerns
  • Serve for new and experienced people
• Guidelines
  • try to be D.R.Y. (Don´t Repeat Yourself)
• References
  • TagsPlugin
  • http://trac.edgewall.org/wiki/TracPlugins
  • Boreste´s internal guidelines for (sorry no external link for this but I have exposed a page here)

Follows "Install and Configure" section proposal for NewHackTemplate.

Install and Configure

Steps to install and configure this plugin are:

1. Install
   • Manually:
     1. Download tags: tags-VV.RR.zip or grab the source from SVN.
     2. Build and install an egg from this source.
     3. Copy the '.egg' file at plugins directory (usually: /usr/lib/python2.5/site-packages/).
     4. Install - single environment: execute at '.egg' plugins directory

        $ python setup.py bdist_egg
        

     5. Install - all environments: at plugin e execute

        $ python setup.py XXXXX????
        

   • With easy_install:

     $ sudo easy_install https://trac-hacks.org/svn/nononononoono
     

2. Enable
   • Manually:
     1. Edit trac.ini file:

            [components]
            nononononoono.* = enabled
        

   • Or through web Admin interface:

         NONONOONOOONONONON
     

   • Note: Requires to be enabled individually on every single Trac environment.
3. Configure appropriately for your version of Trac. Update your trac.ini with this::

       [nononononoono]
       nononononoono_fhdfjksdh.* = true
       .....
       # if you want to personalize / translate some labels
       [mainnav]
       nononononoono.label = jkhfjshdkf
       nononononoono.href = /NONONOO
   

4. You may need to restart your web server. Example: sudo /etc/init.d/apache2 restart
5. Check if any permission is required to execute or view plugin results. Configure accordingly.
6. Test plugin functionality. At more than one Trac environment if the case.
7. Troubleshooting: TracPlugins have generic resources for plugin installation.