Changes between Version 3 and Version 4 of TracBrowser


Ignore:
Timestamp:
Dec 30, 2016, 2:54:46 AM (7 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracBrowser

    v3 v4  
    1 = Trac リポジトリブラウザ = #TheTracRepositoryBrowser
     1= The Trac Repository Browser
     2
    23[[TracGuideToc]]
    34
    4 Trac のリポジトリブラウザでは、 Environment に関連付けられたリポジトリに格納されている
    5 特定のリビジョンのディレクトリやファイルを閲覧することができます。
     5The Trac repository browser can be used to browse specific revisions of directories and files stored in the repositories associated with the Trac environment.
    66
    7 ''(0.12 以降)'':
    8 リポジトリブラウザのトップレベルは、設定されている全てのリポジトリを一覧表示する
    9 '''リポジトリ一覧''' (英語版では '''Repository Index''') です。
    10 各々のリポジトリには、すべてのリポジトリを含めた階層構造の中でのファイルの
    11 "仮想的な" 位置を特定するために、パスのプレフィックスとして使用する名前を付与します。
    12 リポジトリの一つに名前を設定しないことができ、これがデフォルトのリポジトリとなります。このようなデフォルトのリポジトリが定義されている場合、
    13 リポジトリ一覧より先に '''デフォルトリポジトリ''' (英語版では '''Default Repository''') 欄にトップレベルのファイルやディレクトリが一覧表示されます。
    14 Environment に関連付けられているリポジトリがデフォルトのリポジトリのみの場合、
    15 '''リポジトリ一覧''' は表示されません。 (^[#note-multirepos (1)]^)
     7At the top-level of the repository browser is the '''Repository Index''', listing all the configured repositories.
     8Each repository has a name which is used as a path prefix in a "virtual" file hierarchy encompassing all the available repositories.
     9One of the repositories can be configured with an empty name; this is the default repository. When such a default repository is present, its top-level files and directories are also listed, in a '''Default Repository''' section placed before the repository index. If the default repository is the only repository associated with the Trac environment, then the '''Repository Index''' will be omitted. This means that after upgrading a single-repository Trac of version 0.11 (or earlier) to a multi-repository Trac (0.12), the repository browser will look and feel the same, that single repository becoming automatically the "default" repository.
    1610
    17 ディレクトリは列ごとにソート可能なリストとして表示されます。
    18 ソートを行うには、 ''名称'' (英語版では ''Name''), ''サイズ'' (英語版では ''Size''), ''時期'' (英語版では ''Age''), ''更新者'' (英語版では ''Author'') と表示されている、列名をクリックします。
    19 ソートの並び順は、もう一度クリックすることで
    20 逆順にすることができます。
     11Directory 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.
    2112
    22 リポジトリブラウザでは、ディレクトリ名をクリックすることで、
    23 ディレクトリ構造をたどることができます。
    24 ファイル名をクリックすると、ファイルの中身が表示されます。
    25 ファイルやディレクトリのリビジョン番号をクリックすると、
    26 そのファイルやディレクトリの TracRevisionLog を見ることができます。
    27 ナビゲーションリンクには、 ''更新履歴'' (英語版では ''Revision Log'') というリンクがありますが、
    28 これは 現在見ているパスの TracRevisionLog を表示します。
    29 リビジョン番号の後にある ''diff'' アイコンをクリックすると、
    30 そのリビジョンでファイルにどのような更新が行われたか表示されます。
    31 ファイルの ''時期'' (英語版では ''Age'') をクリックすると、該当するチェンジセット前後のタイムラインが表示されます。
     13The browser can be used to navigate through the directory structure by clicking on the directory names.
     14Clicking on a file name will show the contents of the file.
     15Clicking on the revision number of a file or directory will take you to the TracRevisionLog for that file.
     16Note that there's also a ''Revision Log'' navigation link that will do the same for the path currently being examined.
     17Clicking on the ''diff'' icon after revision number will display the changes made to the files modified in that revision.
     18Clicking on the ''Age'' of the file - will take you to that changeset in the timeline.
    3219
    33 またリビジョンを指定して、
    34 そのディレクトリやファイルの履歴を確認することも可能です。
    35 最新のリビジョンで表示するのがデフォルトの動作になりますが、ページ上部の ''リビジョン指定''
    36 (英語版では ''View revision'') テキストボックスにリビジョン番号を指定すると、そのリビジョンでのリポジトリの状態を表示します。
     20It'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.
    3721
    38 ''時期'' (英語版では ''Age'') 列に後続するカラーバーは、
    39 ファイルやディレクトリが最終更新されてから経過した時間を視覚的に表現したものです。
    40 デフォルトの設定では '''[[span(style=color:#88f,青)]]''' が古く '''[[span(style=color:#f88,赤)]]''' が新しいものを指します。
    41 この設定は [TracIni#browser-section コンフィグ] で変更可能です。
     22The 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 '''[[span(style=color:#88f,blue)]]''' is oldest and '''[[span(style=color:#f88,red)]]''' is newest, but this can be [TracIni#browser-section configured].
    4223
    43 リポジトリブラウザのページ上部には、ブランチやタグのようにリポジトリ内で有意な場所を選択するための
    44 ''ジャンプ'' (英語版では ''Visit'') ドロップダウンメニューがあります。
    45 このリストは ''リポジトリブラウザへのクイックジャンプ'' の機能 (訳注: TracSearch でのクイックジャンプのことです。検索文字列がリストに一致すると、該当するパスのブラウザ画面にリダイレクトします) でも使用されます。
    46 正確に記述すると、このメニューの内容はバックエンドに依存しています。
    47 Subversion のデフォルトでは、リストにはトップレベルの trunk と
    48 branches、 tags ディレクトリ配下全て
    49 (`/trunk`, `/branches/*`, `/tags/*`) が含まれています。
    50 これらは [TracIni#svn-section 設定を変更する] ことでより高度なケースに対応できます。
     24At the top of the browser page, there's a ''Visit'' drop-down menu which you can use to select some interesting places in the repository, for example branches or tags.
     25This is sometimes referred to as the ''browser quickjump'' facility.
     26The precise meaning and content of this menu depends on your repository backend.
     27For 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.
    5128
    52 Web ブラウザが Javascript に対応していれば、ディレクトリの脇にある右向きの矢印をクリックすることで、
    53 そのページ内でディレクトリを展開したり、畳んだりできます。
    54 他の操作方法として [trac:TracKeys キーボード] が使用できます:
    55  - `'j'` と `'k'` は、それぞれ前後のエントリに移動します
    56  - `'o'` (open) は、選択されているのがフォルダであれば、展開表示と折り畳み表示を切り替えます
    57    ファイルであれば、そのファイルに移動します
    58  - `'v'` (view, visit) および `'<Enter>'` も上記と同じ動作です
    59  - `'r'` は、既に展開したディレクトリを再読み込みするために使用します
    60  - `'A'` は、アノテート表示ページに直接移動します (訳注: ファイル選択時のみ対象です)
    61  - `'L'` は、選択しているエントリのログ表示に移動します
    62 `'j'` や `'k'` を使って選択した行がない場合、これらのキーはマウスオーバ状態にあるエントリを対象にします。
     29If you're using a Javascript enabled browser, you'll be able to expand and collapse directories in-place by clicking on the arrow head at the right side of a directory. Alternatively, the [trac:TracAccessibility keyboard] can also be used for this:
     30 - use `j` and `k` to select the next or previous entry, starting with the first
     31 - `o` ('''o'''pen) to toggle between expanded and collapsed state of the selected
     32   directory or for visiting the selected file
     33 - `v` ('''v'''iew, '''v'''isit) and `<Enter>`, same as above
     34 - `r` can be used to force the '''r'''eload of an already expanded directory
     35 - `a` can be used to directly visit a file in '''a'''nnotate (blame) mode
     36 - `l` to view the '''l'''og for the selected entry
     37If no row has been selected using `j` or `k` these keys will operate on the entry under the mouse.
    6338
    64 {{{#!comment
    65 MMM: I guess that some keys are upper case and some lower to avoid conflicts with browser defined keys.
    66 I find for example in Firefox and IE on windows that 'a' works as well as 'A' but 'l' does not work for 'L'.
    67  cboos: 'l' is reserved for Vim like behavior, see #7867
    68 }}}
    69 
    70 Subversion バックエンドでは、下記の機能も用意されています:
    71  - `svn:needs-lock` プロパティ対応
    72  - `svn:mergeinfo` プロパティでのマージ状態やブロック状態の表示対応
    73  - `svn:externals` プロパティでの閲覧対応
    74    ([TracIni#svn:externals-section 設定の変更] が必要です)
    75  - `svn:mime-type` プロパティがファイルを表示する際にシンタックスハイライトの選択に使用されます。
    76    例えば `svn:mime-type` が `text/html` に設定されている場合、拡張子にかかわらず、そのファイルは HTML としてハイライトされます。
    77    また、ファイルで使用される文字のエンコードを指定することもできます。
    78    ファイルの内容が UTF-8 で作成されている場合は、
    79    `svn:mime-type` を `text/html;charset=utf-8` のように設定します。
    80    この `charset=` で指定したエンコードは [TracIni#trac-section trac.ini] の `[trac]` セクションのオプション
    81    `default_charset` で指定したエンコードのデフォルト値より優先されます
     39For the Subversion backend, some advanced additional features are available:
     40 - The `svn:needs-lock` property will be displayed.
     41 - Support for the `svn:mergeinfo` property showing the merged and eligible information.
     42 - Support for browsing the `svn:externals` property, which can be [TracIni#svn:externals-section configured].
     43 - 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].
    8244{{{#!comment
    8345MMM: I found this section a bit hard to understand. I changed the first item as I understood that well.
     
    8648}}}
    8749
    88 
    8950----
    90 {{{#!div style="font-size:85%"
    91 [=#note-multirepos (1)] 単独リポジトリしかサポートしない
    92 0.11 以前のバージョンから、マルチリポジトリをサポートする 0.12 に Trac をアップグレードした場合、リポジトリブラウザの見え方は同じようになります。
    93 単独のリポジトリは自動的に "デフォルトリポジトリ" として取り扱われるようになります。
    94 }}}
    95 
    9651See also: TracGuide, TracChangeset, TracFineGrainedPermissions