|Version 4 (modified by 12 years ago) ( diff ),|
This page documents the 0.12 release. Documentation for other releases can be found here.
The Trac Repository Browser
Table of Contents
The Trac repository browser can be used to browse specific revisions of directories and files stored in the repositories associated to the Trac environment.
At the toplevel of the repository browser, you'll find the Repository Index, listing all the configured repositories. A repository has a name which is used as a path prefix in a "virtual" file hierarchy encompassing all the available repositories. If a default repository has been configured, its toplevel files and folders are also listed, in a Default Repository section placed before the repository index. The latter will be omitted if the default repository is the only repository associated to the Trac environment(1).
Directory entries are displayed in a list with sortable columns. The list entries can be sorted by Name, Size, Age or Author by clicking on the column headers. The sort order can be reversed by clicking on a given column header again.
The browser can be used to navigate through the directory structure by clicking on the directory names. Clicking on a file name will show the contents of the file. Clicking on the revision number of a file or directory will take you to the TracRevisionLog for that file. Note that there's also a Revision Log navigation link that will do the same for the path currently being examined.
It's also possible to browse directories or files as they were in history, at any given repository revision. The default behavior is to display the latest revision but another revision number can easily be selected using the View revision input field at the top of the page.
The color bar next to the Age column gives a visual indication of the age of the last change to a file or directory, following the convention that blue is oldest and red is newest, but this can be configured.
At the top of the browser page, there's a drop-down menu which you can use
to select some interesting places in the repository, for example branches or tags.
This is sometimes referred to as the browser quickjump facility.
The precise meaning and content of this menu depends on your backend.
For Subversion, this list contains by default the top-level trunk directory and sub-directories of the top-level branches and tags directories (
/tags/*). This can be configured for more advanced cases.
'k' to go to the next or previous entry, and
'<Enter>') to toggle between expanded and collapsed state of the selected folder or for visiting the selected file.
'A' can be used to directly visit a file in annotate (blame) mode and
'L' to view the log for the selected path. (FIXME currently this is 'a' and 'l', but for #7867 we need the 'l'…; + find that patch for jumping to the entry under mouse in case there's no selection)
For the Subversion backend, some additional features are available:
- Displays the
- Support for the
svn:mergeinfoproperty showing the merged and eligible information
- Support for browsing the
svn:externalsproperty (which can be configured)
svn:mime-typeproperty is used to select the syntax highlighter for rendering the file. For example, setting
text/htmlwill ensure the file is highlighted as HTML, regardless of the file extension. It also allows selecting the character encoding used in the file content. For example, if the file content is encoded in UTF-8, set
charset=specification overrides the default encoding defined in the
default_charsetoption of the
[trac]section of trac.ini.
(1) - This means that after upgrading a single-repository Trac of version 0.11 (or below) to a multi-repository Trac (0.12), the repository browser will look and feel the same, that single repository becoming automatically the "default" repository.