Changes between Version 2 and Version 3 of TracWiki

Oct 1, 2012 9:35:34 AM (12 years ago)



  • TracWiki

    v2 v3  
    1 = Trac Wiki エンジン = #TheTracWikiEngine 
     2= The Trac Wiki System = 
    4 Trac はテキストとドキュメンテーションにシステム中で使用される組み込みの Wiki エンジンを持っています。 WikiFormatting は [wiki:TitleIndex Wiki ページ] や [wiki:TracTickets チケット] 、 [wiki:TracChangeset コミットログメッセージ] 、 [wiki:TracRoadmap マイルストーン] 、 [wiki:TracReports レポート] で使用することができます。 この組み込みエンジンによってすべての Trac モジュールで書式付きテキストとハイパーリンクを使用することができます。 
     5Trac has a built-in wiki system which you can use for organizing knowledge and information in a very flexible way by [WikiNewPage creating pages] containing an intuitive and easy to learn textual markup. This text markup is also used in all other parts of the system, not only in [wiki:TitleIndex wiki pages], but also in [wiki:TracTickets ticket] description and comments, [wiki:TracChangeset check-in log messages], [wiki:TracRoadmap milestone] descriptions and [wiki:TracReports report] descriptions, even in third-party extensions. 
     6It allows for formatted text and hyperlinks in and between all Trac modules. 
    6 Wiki テキストの編集はとても簡単です。どの Web ブラウザも使用でき、 HTML のようなもっと複雑なマークアップ言語に比べるとシンプルな [WikiFormatting 書式体系] です。 Wiki が設計された背景には、 HTML はネスト可能なタグの数が膨大でかつとても複雑なので、速いペースで編集することができず、ページの実質的な内容を把握し難いという理由があったからです。それでも Trac はマークアップの別手段として、 [WikiHtml HTML], [WikiRestructuredText reStructuredText], [ Textile] にも対応しています。 
     8Editing wiki text is easy, using any web browser and a simple [WikiFormatting formatting system], rather than more complex markup languages like HTML.  The reasoning behind its design is that HTML, with its large collection of nestable tags, is too complicated to allow fast-paced editing, and distracts from the actual content of the pages. Note though that Trac also supports [WikiHtml HTML], [WikiRestructuredText reStructuredText] and [ Textile] as alternative markup formats, which can eventually be used in parts of a page (so called wiki “blocks”). 
    8 Wiki が目指しているところはテキスト編集をより簡単にし、人々にプロジェクトのための情報を提供し、その内容に注釈をつけることを '''奨励する''' ことです。 Trac はまた Wiki 文法をもっと使いやすくするための簡単なツールバーを提供しています。 
     10The main goal of the wiki is to make editing text easier and ''encourage'' people to contribute and annotate text content for a project. Trac also provides a simple toolbar to make formatting text even easier, and supports the [ universal edit button] of your browser. 
    10 Wiki そのものはどんな仕組みも押し付けません。何も書いていない紙の束に似ています。あなたがふさわしいと思う情報や文書をまとめることができ、必要に応じて後でまとめなおすことができます。 
    11 Wiki に貢献することは本質的にはハイパーリンクをビルドすることなので、 
    12 HTML に関する一般的な助言についてもここで扱います。 
    13 例えば、 ''[ オンライン・ハイパーテキストのためのスタイルガイド]'' には  
    14 [ 作品全体の構造] についての考え方や 
    15 情報を [ 各ドキュメントに] まとめる方法について説明されています。最も重要なことの1つは、 “ あなたがリンクをたどっていなかったとしても、読むことができる HTML ページにしよう” ということです。 
     12The wiki itself does not enforce any structure, but rather resembles a stack of empty sheets of paper, where you can organize information and documentation as you see fit, and later reorganize if necessary.  
     13As contributing to a wiki is essentially building hypertext,  
     14general advice regarding HTML authoring apply here as well. 
     15For example, the ''[ Style Guide for online hypertext]'' explains how to think about the 
     16[ overall structure of a work]  
     17and how to organize information [ within each document]. One of the most important tip is “make your HTML page such that you can read it even if you don't follow any links.” 
    17 詳細について: 
    18  * WikiNewPage は新しい Wiki ページの作成時参照して下さい。すなわち、 [PageTemplates Wiki ページテンプレート] から始めるために Wiki ページの新規作成を構成できます。 
    19  * WikiFormatting のルール、 WikiMacros や WikiProcessors のような上級者向けルールも含みます。 
    20  * WikiPageNames の使用方法と TracLinks の他のフォーム、すなわちもっと細かな方法で Trac 内のいろいろなリソースを参照する方法 
     19Learn more about: 
     20 * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors 
     21 * How to use WikiPageNames and other forms of TracLinks which are used to refer in a precise way to any resource within Trac 
    22 もし Wiki テキストを編集する練習をしたいならば、 SandBox を使用してください。 
     23If you want to practice editing, please use the SandBox. Note that not all Trac wikis are editable by anyone, this depends on the local policy; check with your Trac administrators. 
    24 変更を保存する前に、そのページを ''プレビュー'' することや、あなたが行なった ''変更を確認'' することができます。 
    25 ''並べて編集'' モードを有効にしたとき、タイピングすると書式のプレビューが自動的に表示されます。 ''編集をしたタイミングと、プレビューが自動的に更新されるタイミングについて [wiki:/TracIni#trac-section 遅延設定] が可能です。'' 
     25Before saving your changes, you can ''Preview'' the page or ''Review the Changes'' you've made. 
     26You can get an automatic preview of the formatting as you type when you activate the ''Edit Side-by-side'' mode (you have to Preview the page for the setting to take effect). '' There is a [wiki:/TracIni#trac-section configurable delay] between when you make your edit and when the automatic preview will update.'' 
    27 Web 上のその他の情報について: 
    28  * 有名な Wiki 百科事典における [ Wiki] の定義 
    29  * Wiki の [ 歴史] 
    30  * [ なぜ Wiki は動くのか] を説明した Wiki ページ 
     28Some more information about wikis on the web: 
     29 * A definition of [ Wiki], in a famous wiki encyclopedia 
     30 * The [ History] of the original wiki 
     31 * A wiki page explaining [ why wiki works]