Edgewall Software

Changes between Version 5 and Version 6 of 0.12/TracBrowser


Ignore:
Timestamp:
Mar 12, 2010, 5:20:03 AM (12 years ago)
Author:
mark.m.mcmahon@…
Comment:

Changed folder → directory for consistency, added carriage returns to source (not sure if that is a good idea (it's better for diffing, but not for wrapping), but wasn't consistent?), many other changes

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TracBrowser

    v5 v6  
    33
    44The Trac repository browser can be used to browse specific revisions of directories
    5 and files stored in the repositories associated to the Trac environment.
     5and files stored in the repositories associated with the Trac environment.
    66
    7 At the toplevel of the repository browser, you'll find the '''Repository Index''', listing all the configured repositories.
    8 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^[#note-multirepos (1)]^.
     7''(since 0.12)'':
     8At the top-level of the repository browser is the '''Repository Index''',
     9listing all the configured repositories.
     10Each repository has a name which is used as a path prefix in a
     11"virtual" file hierarchy encompassing all the available repositories.
     12If a default repository has been configured, its top-level files and directories
     13are also listed, in a '''Default Repository''' section placed before the
     14repository index. If the default repository is the only repository associated
     15with the Trac environment the '''Repository Index''' will be omitted ^[#note-multirepos (1)]^.
    916
    1017Directory entries are displayed in a list with sortable columns. The list
     
    1421
    1522The browser can be used to navigate through the directory structure
    16 by clicking on the directory names. Clicking on a file name will show
    17 the contents of the file. Clicking on the revision number of a file or
    18 directory will take you to the TracRevisionLog for that file.
    19 Note that there's also a ''Revision Log'' navigation link that will do
    20 the same for the path currently being examined.
     23by clicking on the directory names.
     24Clicking on a file name will show the contents of the file.
     25Clicking on the revision number of a file or directory will take
     26you to the TracRevisionLog for that file.
     27Note that there's also a ''Revision Log'' navigation link that will do the
     28same for the path currently being examined.
     29Clicking on the ''diff'' icon after revision number will display the changes made
     30to the files modified in that revision.
     31Clicking on the ''Age'' of the file - will take you to that changeset in the timeline.
     32
     33{{{#!div style="background:#efe"
     34'''MMM''' there is no ''View revision'' input field at the top of the Repository Browser page.
     35I found out why. There are actually two views for the repository browser in 0.12 ...
     36 a) Before you in a particular repo (http://localhost/test_env/browser)
     37 b) After you are in a particular repo (http://localhost/test_env/browser/MyProject)
     38
     39I don't currently know which view it goes to if you only have a default repo.
    2140
    2241It's also possible to browse directories or files as they were in history,
     
    2544the ''View revision'' input field at the top of the page.
    2645
     46}}}
     47
    2748The color bar next to the ''Age'' column gives a visual indication of the age
    2849of the last change to a file or directory, following the convention that
    29 [[span(style=color:#88f,blue)]] is oldest and [[span(style=color:#f88,red)]] is newest, but this can be [TracIni#browser-section configured].
     50'''[[span(style=color:#88f,blue)]]''' is oldest and '''[[span(style=color:#f88,red)]]'''
     51is newest, but this can be [TracIni#browser-section configured].
    3052
    31 At the top of the browser page, there's a drop-down menu which you can use
     53At the top of the browser page, there's a ''Visit'' drop-down menu which you can use
    3254to select some interesting places in the repository, for example branches or tags.
    3355This is sometimes referred to as the ''browser quickjump'' facility.
    34 The precise meaning and content of this menu depends on your backend.
    35 For Subversion, this list contains by default the top-level trunk directory and sub-directories of the top-level branches and tags directories (`/trunk`, `/branches/*`, and `/tags/*`).  This can be [TracIni#svn-section configured] for more advanced cases.
     56The precise meaning and content of this menu depends on your repository backend.
     57For Subversion, this list contains by default the top-level trunk directory
     58and sub-directories of the top-level branches and tags directories
     59(`/trunk`, `/branches/*`, and `/tags/*`).  This can be [TracIni#svn-section configured]
     60for more advanced cases.
    3661
    37 If you're using a Javascript enabled browser, you'll be able to expand and collapse folders in-place by clicking on the arrow head at the right side of a folder. Alternatively, the [trac:TracKeys keyboard] can also be used for this:
     62If you're using a Javascript enabled browser, you'll be able to expand and
     63collapse directories in-place by clicking on the arrow head at the right side of a
     64directory. Alternatively, the [trac:TracKeys keyboard] can also be used for this:
    3865 - use `'j'` and `'k'` to select the next or previous entry, starting with the first
    39  - `'o'` (open) to toggle between expanded and collapsed state of the selected folder or for visiting the selected file
     66 - `'o'` (open) to toggle between expanded and collapsed state of the selected
     67   directory or for visiting the selected file
    4068 - `'v'` (view, visit) and `'<Enter>'`, same as above
    41  - `'r'` can be used to force the reload of an already expanded folder
     69 - `'r'` can be used to force the reload of an already expanded directory
    4270 - `'A'` can be used to directly visit a file in annotate (blame) mode
    4371 - `'L'` to view the log for the selected entry
    44 Those controls will also operate on the entry under the mouse if no row has been selected using `'j'` or `'k'`.
     72If no row has been selected using `'j'` or `'k'` these keys will operate on the entry under the mouse .
     73
     74{{{#!div style="background:#efe"
     75I guess that some keys are upper case and some lower to avoid conflicts with browser defined keys.
     76I find for example in Firefox and IE on windows that 'a' works as well as 'A' but 'l' does not work for 'L'.
     77}}}
    4578
    4679For the Subversion backend, some additional features are available:
    47  - Displays the `svn:needs-lock` property
     80 - The `svn:needs-lock` property will be displayed
    4881 - Support for the `svn:mergeinfo` property showing the merged and eligible information
    49  - Support for browsing the `svn:externals` property (which can be [TracIni#svn:externals-section configured])
    50  - The `svn:mime-type` property is used to select the syntax highlighter for rendering the file. For example, setting `svn:mime-type` to `text/html` will 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 `svn:mime-type` to `text/html;charset=utf-8`. The `charset=` specification overrides the default encoding defined in the `default_charset` option of the `[trac]` section of [TracIni#trac-section trac.ini].
     82 - Support for browsing the `svn:externals` property
     83   (which can be [TracIni#svn:externals-section configured])
     84 - The `svn:mime-type` property is used to select the syntax highlighter for rendering
     85   the file. For example, setting `svn:mime-type` to `text/html` will ensure the file is
     86   highlighted as HTML, regardless of the file extension. It also allows selecting the character
     87   encoding used in the file content. For example, if the file content is encoded in UTF-8,
     88   set `svn:mime-type` to `text/html;charset=utf-8`. The `charset=` specification overrides the
     89   default encoding defined in the `default_charset` option of the `[trac]` section
     90   of [TracIni#trac-section trac.ini].
     91{{{#!div style="background:#efe"
     92I found this section a bit hard to understand. I changed the first item as I understood that well.
     93but I think the other items could be changed also
     94}}}
     95
    5196
    5297----
    5398{{{#!div style="font-size:85%"
    54 [=#note-multirepos (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.
     99[=#note-multirepos (1)] -  This means that after upgrading a single-repository Trac of version
     1000.11 (or below) to a multi-repository Trac (0.12), the repository browser will look and feel
     101the same, that single repository becoming automatically the "default" repository.
    55102}}}
    56103