Changes between Version 2 and Version 3 of TracLinks


Ignore:
Timestamp:
Dec 31, 2005, 4:43:10 PM (18 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracLinks

    v2 v3  
    1 = Trac リンク =
    2 TracリンクはTracのとても重要な機能です。
     1= Trac Links =
     2As you might have guessed, TracLinks are a very fundamental feature of Trac.
    33
    4 Tracリンクは WikiFormatting を使用しているすべてのコンポーネントで、Tracコンポーネント(チケット、レポート、チェンジセット、
    5 Wikiページ、マイルストーン、ソースファイル)間のハイパーリンクを可能にします。
     4They allow hyperlinking between Trac entities (tickets, reports, changesets, Wiki
     5pages, milestones and source files) from anywhere WikiFormatting is used.
    66
    7 Tracリンクは通常、 '''item:id'''( ''id'' はコンポーネントの
    8 番号や名前、パス)の形式で記述しますが、よく使われるコンポーネントについては、
    9 下の例のように表記を省略することもできます。
     7TracLinks are generally of the form '''type:id''' (where ''id'' represents the
     8number, name or path of the item) though some frequently used kinds of items
     9also have short-hand notations.
    1010
    11 例:
     11Some examples:
     12 * Tickets: '''!#1''' or '''!ticket:1'''
     13 * Reports: '''!{1}''' or '''!report:1'''
     14 * Changesets: '''!r1''', '''![1]''' or '''!changeset:1'''
     15 * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:#1:3'''
     16 * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase'''
     17 * Milestones: '''!milestone:1.0'''
     18 * Attachment: '''!attachment:ticket:944:attachment.1073.diff'''
     19 * Files: '''!source:trunk/COPYING'''
     20 * A specific file revision: '''!source:/trunk/COPYING#200'''
     21Display:
     22 * Tickets: #1 or ticket:1
     23 * Reports: {1} or report:1
     24 * Changesets: r1, [1] or changeset:1
     25 * Differences: r1:3, [1:3] or log:#1:3
     26 * Wiki pages: CamelCase or wiki:CamelCase
     27 * Milestones: milestone:1.0
     28 * Files: source:trunk/COPYING
     29 * Attachment: attachment:ticket:944:attachment.1073.diff
     30 * A specific file revision: source:/trunk/COPYING#200
    1231
    13  * チケット: '''!#1''' もしくは '''!ticket:1'''
    14  * レポート: '''!{1}''' もしくは '''!report:1'''
    15  * チェンジセット: '''![1]''' もしくは '''!changeset:1'''
    16  * Wikiページ: '''CamelCase''' もしくは '''!wiki:CamelCase'''
    17  * マイルストーン: '''!milestone:1.0'''
    18  * ファイル: '''!source:trunk/COPYING'''
     32'''Note:''' The wiki:CamelCase form is rarely used, but it can be convenient to refer to
     33pages whose names do not follow WikiPageNames rules, i.e., single words,
     34non-alphabetic characters, etc.
    1935
    20 表示:
    21  * チケット: #1 もしくは ticket:1
    22  * レポート: {1} もしくは report:1
    23  * チェンジセット: [1] もしくは changeset:1
    24  * Wikiページ: CamelCase or wiki:CamelCase
    25  * マイルストーン: milestone:1.0
    26  * ファイル: source:trunk/COPYING
    27 
    28 '''Note:''' wiki:CamelCase の書式が使われることはほとんどありませんが、
    29 ページ名が WikiPageNames のルールに従っていないページ(一文字、
    30 アルファベット以外の文字、etc.)をリンクしたい場合には便利です。
    31 
    32 フル表記の(簡略形でない)Tracリンクでは、次のようにしてリンクタイトルを
    33 カスタマイズすることもできます:
     36Trac links using the full (non-shorthand) notation can also be given a custom
     37link title like this:
    3438
    3539{{{
    … …  
    3741}}}
    3842
    39 表示:
     43Display: [ticket:1 This is a link to ticket number one].
    4044
    41 [ticket:1 This is a link to ticket number one].
     45If the title is be omitted, only the id (the part after the colon) is displayed:
    4246
    43 これは一見、全くシンプルな概念に見えるかもしれません。しかし、実はかなり複雑な情報のネットワークを可能にするのです。
     47{{{
     48[ticket:1]
     49}}}
    4450
    45 とはいえ、使い方はとても直感的で簡単です。そして、この"リンクの軌跡"が、
    46 プロジェクトで起きていることや、特定の変更が行われた経緯について理解を深めるのに非常に役に立つのです。
     51Display: [ticket:1]
     52
     53It might seem a simple enough concept at a glance, but actually allows quite a complex network of information. In practice, it's very intuitive and simple to use, and we've found the "link trail" extremely helpful to better understand what's happening in a project or why a particular change was made.
     54
     55== attachement: links ==
     56
     57The link syntax for attachments is as follows:
     58 * !attachment:the_file.txt creates a link to the attachment the_file.txt of the current object
     59 * !attachment:wiki:MyPage:the_file.txt creates a link to the attachment the_file.txt of the !MyPage wiki page
     60 * !attachment:ticket:753:the_file.txt creates a link to the attachment the_file.txt of the ticket 753 !attachment:wiki:MyPage:the_file.txt
    4761
    4862== source: links ==
    49 source:/some/path 形式のリンクは、パスがディレクトリを示しているならば
    50 ディレクトリブラウザを開き、それ以外の場合はlog viewを表示します。
    51 また、source:/some/file#123 のように表記することで、特定のリビジョンにリンクしたり、
    52 source:/some/file#latest で、最新のリビジョンにリンクすることもできます。
    5363
    54 == Tracリンクの使えるところ ==
    55 Tracリンクが使えるのは:
     64The default behavior for a source:/some/path link is to open the directory browser
     65if the path points to a directory and otherwise open the log view.
     66It's also possible to link directly to a specific revision of a file like this: source:/some/file@123
     67or like this to link to the latest revision: source:/some/file@latest.
     68If the revision is specified, one can even link to a specific line number: !source:/some/file@123#L10
     69[[comment(TODO: remove the ! when Edgewall Trac is upgraded with the support for the line syntax)]]
    5670
    57  * ソースコード (Subverison) のコミットログ
    58  * Wikiページ
    59  * チケット、レポート、マイルストーンでの説明記述箇所
     71== Quoting space in TracLinks ==
    6072
    61 その他、WikiFormatting をサポートしていることが明示されているすべてのテキストフィールド。
     73The usual syntax for quoting space is:
    6274
    63 == Tracリンクの無効化 ==
    64 Tracリンクを無効化するには、先頭に'!' (エクスクラメーションマーク)を付けます。
     75 * !attachment:'the file.txt' or
     76 * !attachment:"the file.txt"
    6577
     78== Where to use TracLinks ==
     79You can use TracLinks in:
     80
     81 * Source code (Subversion) commit messages
     82 * Wiki pages
     83 * Full descriptions for tickets, reports and milestones
     84
     85and any other text fields explicitly marked as supporting WikiFormatting.
     86
     87== Escaping Links ==
     88
     89To prevent parsing of a !TracLink, you can escape it by preceding it with a '!' (exclamation mark).
    6690{{{
    6791 !NoLinkHere.
    … …  
    6993}}}
    7094
    71 表示:
     95Display:
    7296 !NoLinkHere.
    7397 ![42] is not a link either.
    7498
    7599----
    76 参考: WikiFormatting, TracWiki
     100See also: WikiFormatting, TracWiki
    77101