= Release Notes for Trac [milestone:0.12] ''Babel'' Release =
[[PageOutline(2-3)]]

'''Preliminary Note:''' Trac 0.12 is still in development, though we're getting nearer to a  release date

== Highlights == 
 * [trac:wiki:TracL10N Localization] of Trac in dozens of languages, using [http://babel.edgewall.org Babel].
 * [TracRepositoryAdmin Multiple Repository Support] per environment
 * Improved Wiki, more powerful syntax and nicer user interface with 
   automatic preview in side-by-side editing mode
 * Improved Ticket user interface, with editable comments and automatic preview


== Detailed User Visible Changes ==

=== Wiki ===
 * Wiki user interface
   - show ''Latest Modified by ...'' link on the lower right side of the page
   - show path on the upper left side of the page
   - improved wiki preview
     - normal mode, with editor on top of the preview
     - side-by-side mode with editor on the left side of the preview,
       with automatic preview as you type
   - attachments are listed in a collapsed section
 * [wiki:0.12/WikiFormatting WikiFormatting] improvements:
   - lists can now start right at the beginning of a line
   - improved WikiCreole compatibility
   - better '>' quote support (arbitrary wiki text can now be quoted and rendered correctly)
   - much improved pipe-based syntax for [wiki:0.12/WikiFormatting#Tables tables] 
     (support for headings, column spans, cell alignment)
   - added several new [wiki:0.12/WikiProcessors wiki processors]
     - `#!td` and `#!th` for building complex tables with arbitrary wiki content
     - `#!htmlprocessor` for embedding HTML comments in rendered pages
   - more direct help for macros (`[[?]]` gives a short list of all macros and `[[macro?]]` 
     provides help for the given ''macro'')

=== Ticket System ===

 - comments are now editable (a.k.a. #454)
 - nicer comment preview (positioned closer the the comment editor, 
   no longer on top of the ticket box, and automatic preview as you type)
 - collapsible attachments, change history, and ticket modification sections 

==== Roadmap and Milestone ====

 * The text of Milestones descriptions can be searched ''(since 0.11.1)''


==== Reports and Custom Queries ====

 * Improved custom queries:
   - support for ''Created'' and ''Modified'' fields (even as criteria, see
     ["0.12/TracQuery#QueryLanguage"])
   - OR'ed clauses (tickets having ''performance'' in description ''OR'' 
     ''performance'' in summary)
     - in the user interface
     - in query: links and ![[TicketQuery]] macro, for example:
        * query:?description=~performance&or&summary=~performance,
        * `[[TicketQuery(description=~performance,or,summary=~performance)]]`

=== Repository Browser ===

 * Remember last expanded folder in the URL and automatically re-expand it
   when visiting that URL again
 * Separate sortable column for ''Author''

=== User Preferences ===

A new tab has been added for selecting the language.

=== Timeline ===
   - filtering by author
   - filtering by repository (in case there are multiple repositories defined)


=== Caveats ===

 - This release requires a '''database upgrade''' when upgrading from the 0.11.x series:
{{{
trac-admin $TRAC_ENV upgrade
}}}
 - PySqlite 1.0.x is no longer supported; use PySqlite 2 (preferably 2.5.x)
 - PyPgSQL (Python bindings for PostgreSQL) is no longer supported; use psycopg2
 - Text template processing has been changed from the [genshi:wiki:Documentation/text-templates.html#legacy-text-template-syntax legacy text template syntax] to the [genshi:wiki:Documentation/text-templates.html new text template syntax]. Overridden text templates placed in the `templates` folder of the environment must therefore be converted to the new syntax (typically the ticket e-mail template). Also, the `[notification] ticket_subject_template` [wiki:TracIni#notification-section option] can now include arbitrary directives.

== Developer-visible changes ==

A detailed view of the API changes since 0.11.x can be found in ["TracDev/ApiChanges/0.12"].


== Acknowledgements ==

Many thanks to the growing number of people who have, and continue to,
support the project. Also our thanks to all people providing feedback and bug
reports that helps us making Trac better, easier to use and more effective.

Without your invaluable help, Trac would not evolve. Thank you all.

Finally, we offer hope that Trac will prove itself useful to like-minded
programmers around the world, and that this release will prove an improvement
over the last version.

Please let us know. :-)

/The Trac Team http://trac.edgewall.org/