Changes between Version 1 and Version 2 of TracWiki


Ignore:
Timestamp:
Sep 2, 2019, 4:56:56 PM (5 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracWiki

    v1 v2  
    1 
    2 = Trac Wiki システム = #TheTracWikiSystem
     1= The Trac Wiki System =
    32[[TracGuideToc]]
    43
    5 Trac には Wiki システムが組み込まれています。直感的で簡単なマークアップ言語を使用して [WikiNewPage ページを作成する] ことで、非常に柔軟な方法で情報や知識をまとめることができます。このマークアップテキストは [wiki:TitleIndex Wiki ページ] だけでなく、[wiki:TracTickets チケット] の概要やコメント、[wiki:TracChangeset コミットログメッセージ]、[wiki:TracRoadmap マイルストーン] の詳細、[wiki:TracReports レポート] の詳細の記述、更には拡張機能内でも使用することができます。
    6 この組み込みエンジンによってすべての Trac モジュールで書式付きテキストとハイパーリンクを使用することができます。
     4Trac 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. The wiki markup is used throughout Trac, so not only in [wiki:TitleIndex wiki pages], but also in [TracTickets ticket] description and comments, [TracChangeset version control] log messages, [TracRoadmap milestone] descriptions, [TracReports report] descriptions  and even in third-party extensions.
     5It allows for formatted text and hyperlinks in and between all Trac modules.
    76
    8 Wiki テキストの編集はとても簡単です。どの Web ブラウザも使用でき、 HTML のようなもっと複雑なマークアップ言語に比べるとシンプルな [WikiFormatting 書式体系] です。 Wiki が設計された背景には、 HTML はネスト可能なタグの数が膨大でかつとても複雑なので、速いペースで編集することができず、ページの実質的な内容を把握し難いという理由があったからです。それでも Trac はマークアップの別手段として、 [WikiHtml HTML], [WikiRestructuredText reStructuredText], [http://www.textism.com/tools/textile/ Textile] にも対応しています。これらはページの一部(wiki ブロック)で使用することができます。
     7Editing wiki text is easy, as compared to complex markup languages like HTML, using any web browser and simple [WikiFormatting formatting]. The motivation for wiki markup 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 that Trac also supports [WikiHtml HTML], [WikiRestructuredText reStructuredText] and [https://txstyle.org Textile] as alternative markup formats, which can be used in parts of a page, so called wiki blocks.
    98
    10 Wiki が目指しているところはテキスト編集をより簡単にし、人々にプロジェクトのための情報を提供し、その内容に注釈をつけることを '''奨励する''' ことです。 Trac はまた Wiki 文法をもっと使いやすくするための簡単なツールバーを提供しています。そして、ブラウザの [http://universaleditbutton.org/Universal_Edit_Button ユニバーサルエディットボタン] をサポートします。
     9The main goal of the wiki is to make editing text easy in order to ''encourage'' people to contribute to a project. Trac also provides a simple toolbar to make formatting text even easier, and supports the [http://universaleditbutton.org/Universal_Edit_Button universal edit button] of your browser.
    1110
    12 Wiki そのものはどんな仕組みも押し付けません。何も書いていない紙の束に似ています。あなたがふさわしいと思う情報や文書をまとめることができ、必要に応じて後でまとめなおすことができます。
    13 Wiki に投稿することは本質的にはハイパーリンクをビルドすることなので、
    14 HTML に関する一般的な助言についてもここで扱います。
    15 例えば、 ''[http://www.w3.org/Provider/Style オンライン・ハイパーテキストのためのスタイルガイド]'' には
    16 [http://www.w3.org/Provider/Style/Structure.html 作品全体の構造] についての考え方や
    17 情報を [http://www.w3.org/Provider/Style/WithinDocument.html 各ドキュメントに] まとめる方法について説明されています。最も重要な tip として、 “ あなたがリンクをたどっていなかったとしても、読むことができる HTML ページにしよう” ということです。
     11The 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.
     12As contributing to a wiki is essentially building hypertext, general advice regarding HTML authoring apply here as well.
     13For example, the ''[https://www.w3.org/Provider/Style Style Guide for online hypertext]'' explains how to think about the [https://www.w3.org/Provider/Style/Structure.html overall structure of a work] and how to organize information [https://www.w3.org/Provider/Style/WithinDocument.html within each document]. One of the most important tips is to "make your HTML page such that you can read it, even if you don't follow any links".
    1814
    19 詳細について:
    20  * WikiFormatting のルール。WikiMacros や WikiProcessors のような上級者向けルールも含みます
    21  * WikiPageNames の使用方法。TracLinks の他の書式、すなわちもっと細かな方法で Trac 内のいろいろなリソースを参照する方法
     15Learn more about:
     16 * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors.
     17 * How to use WikiPageNames and other forms of TracLinks which are used to refer to any resource within Trac.
    2218
    23 もし Wiki テキストを編集する練習をしたいならば、SandBox を使用してください。Note: 誰でもすべての Trac Wiki を編集できるわけではありません。プロジェクトの方針によります。Trac の管理者に確認してください。
     19If you want to practice editing, please use the SandBox. Note that not all Trac wiki pages are editable by anyone, this depends on the local policy; check with your Trac administrators.
    2420
    25 変更を保存する前に、そのページを ''プレビュー'' することや、あなたが行なった ''変更を確認'' することができます。
    26 ''並べて編集'' モードを有効にしタイピングすると、書式のプレビューが自動的に表示されます(設定を反映させるには一度プレビューを見る必要があります)。 ''編集をしたタイミングと、プレビューが自動的に更新されるタイミングについて [wiki:/TracIni#trac-section 遅延設定] が可能です。''
     21Before saving your changes, you can ''Preview'' the page or ''Review Changes'' you have made.
     22You can get an automatic preview of the formatting as you type when you activate the ''Edit Side-by-side'' mode. There is a [wiki:TracIni#/auto_preview_timeout configurable delay] between when you make your edit and when the automatic preview will update.
    2723
    28 Web 上のその他の情報について:
    29  * 有名な Wiki 百科事典における [http://wikipedia.org/wiki/Wiki Wiki] の定義
    30  * Wiki の [http://c2.com/cgi/wiki?WikiHistory 歴史]
    31  * [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks なぜ wiki は動くのか] を説明した Wiki ページ
     24Some more information about wikis on the web:
     25 * A definition of [https://wikipedia.org/wiki/Wiki Wiki] according to Wikipedia.
     26 * The [http://c2.com/cgi/wiki?WikiHistory history] behind the original wiki.
     27 * A wiki page explaining [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks why wiki works].
    3228
    3329----