Edgewall Software

Changes between Version 30 and Version 31 of 1.3/TracUpgrade


Ignore:
Timestamp:
Aug 20, 2019, 11:12:00 PM (5 years ago)
Author:
Ryan J Ollos
Comment:

Fix formatting issues in ReST conversion. Refs #12835.

Legend:

Unmodified
Added
Removed
Modified
  • 1.3/TracUpgrade

    v30 v31  
    103103* [https://trac-hacks.org/wiki/NavAddPlugin NavAddPlugin]: see TracNavigation
    104104* [https://trac-hacks.org/wiki/FlexibleAssignToPlugin FlexibleAssignToPlugin]: subclass `ConfigurableTicketWorkflow` and override `get_allowed_owners`
    105 * [https://trac-hacks.org/wiki/TracMigratePlugin TracMigratePlugin]: Use TracAdmin `convert_db`  command
     105* [https://trac-hacks.org/wiki/TracMigratePlugin TracMigratePlugin]: Use the `trac-admin` [TracAdmin#ChangingDatabaseBackend convert_db command]
    106106
    107107The plugins should be removed when upgrading Trac to 1.4.
     
    109109===== Jinja2 is the new template engine
    110110
    111 In Trac itself, all the content is now generated by using the Jinja2 template engine.
    112 You may want to verify that your plugins are compatible with this change.
     111Content is now generated by using the Jinja2 template
     112engine. You may want to verify that your plugins are
     113compatible with this change.
    113114(TODO: expand...)
    114115
    115 If you customized the Trac templates, or the site.html template, you'll need to adapt that as well.
     116If you customized the Trac templates, or the `site.html`
     117template, you'll need to adapt that as well.
    116118(TODO: expand...) See [#CustomizedTemplates]
    117119
     
    224226==== Upgrading from older versions of Trac #OlderVersions
    225227
    226 For upgrades from versions older than Trac 0.12, refer first to [trac:wiki:0.12/TracUpgrade#SpecificVersions].
    227 
    228 For upgrades from versions older than Trac 0.10, refer first to [trac:wiki:0.10/TracUpgrade#SpecificVersions].
     228For upgrades from versions older than Trac 0.12, refer first to [trac:wiki:0.12/TracUpgrade#SpecificVersions TracUpgrade for 0.12].
     229
     230For upgrades from versions older than Trac 0.10, refer first to [trac:wiki:0.10/TracUpgrade#SpecificVersions TracUpgrade for 0.10].
    229231
    230232== Known Issues
     
    232234=== Customized Templates
    233235
    234 Trac supports customization of its templates by placing copies of the templates in the `<env>/templates` folder of your [TracEnvironment environment] or in a common location specified in the [[TracIni#GlobalConfiguration| [inherit] templates_dir]] configuration setting. If you choose to customize the templates, be aware that you will need to repeat your changes on a copy of the new templates when you upgrade to a new release of Trac (even a minor one), as the templates will evolve. So keep a diff around.
     236Trac supports customization of its templates by placing copies of the templates in the `<env>/templates` folder of your [TracEnvironment environment] or in a common location specified in the [TracIni#GlobalConfiguration  inherit.templates_dir] configuration setting. If you choose to customize the templates, be aware that you will need to repeat your changes on a copy of the new templates when you upgrade to a new release of Trac (even a minor one), as the templates will evolve. So keep a diff around.
    235237
    236238The preferred way to perform TracInterfaceCustomization is a custom plugin doing client-side !JavaScript transformation of the generated output, as this is more robust in case of changes: we usually won't modify an element `id` or change its CSS `class`, and if we have to do so, this will be documented in the [trac:TracDev/ApiChanges] pages.