Changes between Version 5 and Version 6 of Trac Plugins


Ignore:
Timestamp:
Feb 14, 2023, 8:45:17 AM (22 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Trac Plugins

    v5 v6  
    77== Plugin discovery
    88
    9 From the user's point of view, a plugin is either a single .py file or a package (.egg or .whl). Trac looks for plugins in Python's `site-packages` directory, the [TracIni#GlobalConfiguration global shared] `plugins` directory and the [TracEnvironment project environment] `plugins` directory. Plugins installed to the project environment `plugins` directory are enabled, unless explicitly disabled in the `[components]` section of the `trac.ini` file.  Plugins installed elsewhere must be explicitly enabled in the [[TracIni#components-section| [components] ]] section of the `trac.ini` file.
     9A plugin is either a single .py file or a package (.egg or .whl). Trac looks for plugins in Python's `site-packages` directory, the [TracIni#GlobalConfiguration global shared] `plugins` directory and the [TracEnvironment project environment] `plugins` directory. Plugins installed to the project environment `plugins` directory are enabled, unless explicitly disabled in the `[components]` section of the `trac.ini` file.  Plugins installed elsewhere must be explicitly enabled in the [TracIni#components-section "[components]"] section of the `trac.ini` file.
    1010
    1111== Installing a Trac plugin
    … …  
    1515=== For a single project
    1616
    17 Packages built for a single project must use the egg
    18 format, as the wheel format (described below) is not
    19 supported by the setuptools loading mechanism. Build the `egg` file from the plugin source:
     17Packages built for a single project must use the egg format, as the wheel format (described below) is not supported by the setuptools loading mechanism. Build the `egg` file from the plugin source:
    2018
    2119* Checkout or download and unpack the source.
    22 * Change to the directory containing `setup.py`.
    23 * Run:
     20* Change to the directory containing `setup.py` and run:
    2421 {{{#!sh
    2522$ python setup.py bdist_egg
    … …  
    5249==== From PyPI
    5350
    54 Some plugins, such as [th:TagsPlugin TracTags], can be installed directly from [https://pypi.org PyPI] using `pip`:
     51Some plugins, such as [https://trac-hacks.org/wiki/TagsPlugin TracTags], can be installed directly from [https://pypi.org PyPI] using `pip`:
    5552{{{#!sh
    5653$ pip install TracTags