← 1.3 | 1.6 →

Release Notes for Trac 1.4 Jinja Release

Trac 1.4 is the current stable version of Trac.
These notes reflect the final status.

Highlights

• Jinja2 is the template engine, providing performance improvements over Genshi. Genshi is still supported until Trac 1.5.1 for rendering plugin templates.
• Custom navigation items can be added to the main and meta navigation (#11317).
• TracAdmin convert_db command for converting to a new database backend while preserving all environment data (#12299).
• Restyled wiki that allows toggling between narrow and full width (#12640).

Maintenance Releases

Overview

1.4.2	17 / 17

1.4.1	8 / 8

1.4	5 / 5

Tickets with release notes

Milestone: 1.4.4 (17 matches)

Ticket	Release Notes
#13129	Workaround for ref-count leak due to svn.delta.make_editor().
#13191	Allow to use length units in width, height, margin and border arguments of Image macro.
#13400	Fix javascript error when viewing non-existing wiki page.
#13415	Fix wrong redirect when tracd serves https protocol.
#13418	Respect date relative/absolute format for created and modified columns in report view.
#13455	Fix lack of "Add" dropdowns in filter form of query page.
#13463	Make compatible with utf8mb3 charset since MySQL 8.
#13465	Use hmac.compare_digest to compare password hashes.
#13467	Fix basic authention when colon characters are used in password.
#13478	Adapted PRAGMA table_info() since SQLite 3.37.
#13485	Fixed IndexError raising when project index template file has no extension. Always enable autoescape for project index template.
#13513	Fixed maximum recursion depth error raising when database connection string to MySQL has an invalid parameter.
#13515	Fixed notification failure when permission group is used in other than Cc field.
#13576	Set executable bit of CGI script files created by deploy command.
#13582	Fixed handling of util.html functions and navigation items for LazyProxy objects.
#13590	Fixed the exception not logged after starting a response.
#13574	Removed unnecessary exception handling from deploy_trac.fcgi template.
Milestone: 1.4.3 (8 matches)
Ticket	Release Notes
#13299	Removed print to console of upgraded wiki page names on TracAdmin wiki upgrade.
#13316	Fixed TICKET_CHG_MILESTONE not restricting ability to change the ticket milestone when TICKET_CHG_MILESTONE defined in [extra-permissions].
#13327	PyGIT.cat_file() handles short reads from a pipe.
#13335	Fixed authz parsing error shown only on first request after webserver startup or authz file change.
#13348	Removed unneeded form token from Roadmap preferences panel.
#13354	Fix incorrect redirection via intertrac dispatcher with & characters.
#13355	Fixed malformed html generated from unbalanced inline markups within table cell.
#13320	Fixed regression leading to Unknown Trac environment type 'Trac Environment Version 1 for CRLF line-ending.
Milestone: 1.4.2 (8 matches)
Ticket	Release Notes
#13225	Fixed [notification] ticket_subject_template and batch_subject_template cannot begin with # character.
#13281	Fixed incorrect ordering of admin panels.
#13285	Added autopreview to comment field on batch modify page. Improved styling of batch modify form.
#13290	Fixed TracAdmin resync and sync command not clearing line before printing number of revisions cached.
#13291	Templates with extension txt (e.g. ticket_notify_email.txt) are shown on the About page in the Interface Customization section.
#13305	TracAdmin config remove now removes a section when no option is specified: config remove <section> [<option>].
#13309	Removed time component from query results for custom field of format date. Only the date/datetime is shown in query results, rather than the decorated text on/at %(datetime).
#9227	Ticket comment containing only whitespace, which includes zero-width spaces (ZWSP), will not be saved.
Milestone: 1.4.1 (5 matches)
Ticket	Release Notes
#13040	Fixed TypeError cloning a ticket that has a time custom field. Fixed Clone button not present when Reply button not present.
#13196	Fixed malformed content of RSS feed when Genshi stream filters exist.
#13212	Fixed UnicodeDecodeError when searching a ticket link to query view with non-quickjump.
#13242	Fixed compatibility issues with Jinja2 version 2.11.
#13241	Reject inf and nan for auto preview timeout user preference.

Trac 1.4: Detailed User Visible Changes

Component: admin/console (5 matches)

Ticket	Release Notes
#10656	Added TracAdmin ticket delete_comment command.
#11419	Traceback is not shown when existing resource is added using TracAdmin (e.g. trac-admin $env milestone add <milestone>.
#12242	The TracAdmin permission add command is atomic when operating on a list of permissions. If the user already possesses one of the permissions, a warning will be printed and the other permissions in the list will be granted. If one of the permissions raises a TracError (e.g. not a valid action), none of the permissions in the list are granted.
#12891	Removed repostype and repospath arguments from TracAdmin initenv command. All cached repositories are synchronized on environment creation.
#12966	The installed wiki pages are not printed to the console when creating an environment with trac-admin initenv. The information is logged at INFO level to $ENV/log/trac.log. The new default is INFO level file logging to $ENV/log/trac.log.
Component: admin/web (2 matches)
Ticket	Release Notes
#11341	Milestone admin page can be accessed by a user possessing MILESTONE_ADMIN. TICKET_ADMIN is required to set the default ticket milestone and default retarget milestone.
#12814	Added help links to documentation on various pages.
Component: attachment (1 match)
Ticket	Release Notes
#12870	Added TracAdmin attachment move command.
Component: database backend (3 matches)
Ticket	Release Notes
#12299	Added TracAdmin convert_db command, which migrates a database to the same or new environment while changing the database backend.
#12496	PostgreSQL version is shown in System Information table of the About Trac and error reporting pages. The minimum PostgreSQL version is now 9.1.0.
#12821	​PyMySQL is the supported MySQL library, with support dropped for ​MySQL-python.
Component: general (10 matches)
Ticket	Release Notes
#633	Relative font sizes are used in Trac CSS stylesheets.
#11317	Added configurable features to the navigation: Entries can be added to the navigation Entries provided by Trac and plugins can be moved the between meta and main navigation New permission attribute for controlling visibility of the entry
#12649	Fixed case-insensitive usernames in AuthzPolicy, a regression introduced in Trac 1.2.
#12719	Added a new permission policy for the ticket system (DefaultTicketPolicy): Authenticated user with TICKET_APPEND or TICKET_CHGPROP can modify description of ticket they reported. Renamed ReadonlyWikiPolicy to DefaultWikiPolicy. Modified LegacyAttachmentPolicy to allow authenticated users to delete their own attachments.
#12914	Improved wording of ticket edit conflict message. Fixed conflict not highlighted when comment is edited.
#12970	The auto preview timeout value can be configured for a session through the User Interface preferences page.
#13032	Fixed PostgreSQL server version reported incorrectly for version ≥ 10.
#13116	Improved styling of wiki and ticket pages.
#13122	Changed Genshi requirement to 0.7 or later.
#13165	Fixed "Environment needs to be upgraded" message when an exception is raised from plugin.
Component: i18n (1 match)
Ticket	Release Notes
#12348	Fixed now button in jQuery timepicker not using session timezone preference.
Component: notification (2 matches)
Ticket	Release Notes
#12205	Ticket changes can be used to format the email subject template. changes is the dictionary returned from Ticket.get_change.
#12808	Permission groups in the CC list are resolved to the users that are members of the group.
Component: query system (2 matches)
Ticket	Release Notes
#11723	TICKET_BATCH_MODIFY grants TICKET_MODIFY.
#12223	Report sort order is preserved when changing Max items per page.
Component: rendering (1 match)
Ticket	Release Notes
#12639	The template engine used by Trac is now ​Jinja2. Genshi templates rendering in plugins will be supported until Trac 1.5.1.
Component: report system (3 matches)
Ticket	Release Notes
#11837	Default values for TracReports dynamic variables can be specified in the SQL query itself, inside SQL comments.
#12230	Report dynamic variables are autocompleted in the preferences form.
#12704	Fixed TypeError when report is saved with an empty Query.
Component: roadmap (2 matches)
Ticket	Release Notes
#3776	Added autopreviews to all textareas that accept wiki markup.
#12666	The path /milestone redirects to /roadmap even when a user doesn't have MILESTONE_VIEW.
Component: ticket system (15 matches)
Ticket	Release Notes
#8778	The TICKET_CHG_MILESTONE action is used internally to grant/deny changing the ticket milestone. DefaultPermissionPolicy grants the action when the user has MILESTONE_VIEW for the milestone. See the cookbook for details on implementing fine-grained access control for changing the ticket milestone.
#10735	The tracopt.ticket.clone optional component makes it possible to clone a ticket starting from one of its comment, which can be useful to create "sub-tickets".
#11649	Added description field to ticket enums: Priorities, Resolutions, Severities, Ticket Types. The description can be edited on the admin page.
#11865	Workflow macro can render files from the repository.
#12590	Added max_size attribute to text and textarea custom fields.
#12642	Ticket preview is disabled when there are no workflow actions. The default reset action is not added if there is no new state in the workflow.
#12706	Redirect to the query module after deleting a ticket. If the deleted ticket is in the list of results from the last query, the last query is displayed, otherwise the default query is displayed.
#12725	Ticket comment edits are validated. ITicketManipulators are called and [ticket] max_comment_size is enforced. Added ticket warnings above the preview.
#12736	Empty Comment field is not displayed when viewing diff of a comment.
#12794	The version release date is shown in the title of the Version link of the ticket box.
#12842	The authenticated user is used as the reporter when cloning a ticket.
#12843	The cloned ticket description is quoted when cloning a ticket.
#13057	Replaced term deleted in ticket property changes with removed, in order to unify terminology.
#13093	TICKET_EDIT_CC is required for editing the CC list as a text field for the new ticket form.
#13133	Ticket change entry for default value of custom field is not added to existing tickets when a new custom field is added.
Component: timeline (1 match)
Ticket	Release Notes
#12721	Timeline Ticket updates filter is enabled by default and the filter value defaults to enabled.
Component: version control (3 matches)
Ticket	Release Notes
#12090	Repository cannot be added from the admin page if a repository of the same name is already defined in the [repositories] section of trac.ini.
#12653	Improve interoperability on Windows with the Windows subsystem for Linux (WSL). Repository paths stored as Windows paths will be converted at runtime to the equivalent POSIX paths if needed.
#12771	trac-svn-hook can be configured using the ​hook script environment configuration, available in Subversion 1.8 and later.
Component: version control/log view (1 match)
Ticket	Release Notes
#13038	Improved robustness of error reporting, fixing some cases in which the error reporting screen would fail to be rendered. [trac] use_chunked_encoding is enabled by default for improved page rendering performance.
Component: web frontend/tracd (1 match)
Ticket	Release Notes
#12611	Added HTTPS protocol support to tracd.
Component: wiki system (9 matches)
Ticket	Release Notes
#10454	Respect spacing within inline code style in the wiki
#12265	Absolute path to wiki page can be passed in the template argument by prefixing path with / (e.g. /TheTemplate). This is useful for plugins and links that wish to use a template that shouldn't be visible in the templates dropdown of the wiki new page form. Relative paths are still prefixed with PageTemplates/.
#12640	Restyled the wiki and allow toggling the page between narrow and full width.
#12716	Added comment edit link to wiki diff view.
#12784	No Changes is shown in side-by-side wiki diff mode when there are no differences.
#12873	Fixed duplicate HTML id attributes on page when more than one wiki toolbar.
#12899	TracGuide wiki pages are set readonly when creating an environment.
#13069	Added link to wiki diff view on delete confirmation page.
#13117	The BR macro takes an optional "clear" parameters, which adds the corresponding CSS styling (i.e. [[br(clear:left)]] generates the HTML <br style="clear: left"/>, same thing for "right" or "clear"). Note that [[br(clear)]] stands for [[br(clear:both)]].

Developer-visible changes

A detailed view of the API changes since 1.2.x can be found in TracDev/ApiChanges/1.4.

Code Name

The 0.11 release was dubbed "Genshi" and 0.12 "Babel", after the names of the Python packages that became closely associated to these Trac versions. Therefore, it seems appropriate to name 1.4 "Jinja".