Changes between Version 2 and Version 3 of TracWiki
- Timestamp:
- Jun 17, 2013, 1:35:49 PM (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracWiki
v2 v3 1 = Trac Wiki エンジン = #TheTracWikiEngine 1 2 = Trac Wiki システム = #TheTracWikiSystem 2 3 [[TracGuideToc]] 3 4 4 Trac はテキストとドキュメンテーションにシステム中で使用される組み込みの Wiki エンジンを持っています。 WikiFormatting は [wiki:TitleIndex Wiki ページ] や [wiki:TracTickets チケット] 、 [wiki:TracChangeset コミットログメッセージ] 、 [wiki:TracRoadmap マイルストーン] 、 [wiki:TracReports レポート] で使用することができます。 この組み込みエンジンによってすべての Trac モジュールで書式付きテキストとハイパーリンクを使用することができます。 5 Trac には Wiki システムが組み込まれています。直感的で簡単なマークアップ言語を使用して [WikiNewPage ページを作成する] ことで、非常に柔軟な方法で情報や知識をまとめることができます。このマークアップテキストは [wiki:TitleIndex Wiki ページ] だけでなく、[wiki:TracTickets チケット] の概要やコメント、[wiki:TracChangeset コミットログメッセージ]、[wiki:TracRoadmap マイルストーン] の詳細、[wiki:TracReports レポート] の詳細の記述、更には拡張機能内でも使用することができます。 6 この組み込みエンジンによってすべての Trac モジュールで書式付きテキストとハイパーリンクを使用することができます。 5 7 6 Wiki テキストの編集はとても簡単です。どの Web ブラウザも使用でき、 HTML のようなもっと複雑なマークアップ言語に比べるとシンプルな [WikiFormatting 書式体系] です。 Wiki が設計された背景には、 HTML はネスト可能なタグの数が膨大でかつとても複雑なので、速いペースで編集することができず、ページの実質的な内容を把握し難いという理由があったからです。それでも Trac はマークアップの別手段として、 [WikiHtml HTML], [WikiRestructuredText reStructuredText], [http://www.textism.com/tools/textile/ Textile] にも対応しています。 8 Wiki テキストの編集はとても簡単です。どの Web ブラウザも使用でき、 HTML のようなもっと複雑なマークアップ言語に比べるとシンプルな [WikiFormatting 書式体系] です。 Wiki が設計された背景には、 HTML はネスト可能なタグの数が膨大でかつとても複雑なので、速いペースで編集することができず、ページの実質的な内容を把握し難いという理由があったからです。それでも Trac はマークアップの別手段として、 [WikiHtml HTML], [WikiRestructuredText reStructuredText], [http://www.textism.com/tools/textile/ Textile] にも対応しています。これらはページの一部(wiki ブロック)で使用することができます。 7 9 8 10 Wiki が目指しているところはテキスト編集をより簡単にし、人々にプロジェクトのための情報を提供し、その内容に注釈をつけることを '''奨励する''' ことです。 Trac はまた Wiki 文法をもっと使いやすくするための簡単なツールバーを提供しています。そして、ブラウザの [http://universaleditbutton.org/Universal_Edit_Button ユニバーサルエディットボタン] をサポートします。 9 11 10 12 Wiki そのものはどんな仕組みも押し付けません。何も書いていない紙の束に似ています。あなたがふさわしいと思う情報や文書をまとめることができ、必要に応じて後でまとめなおすことができます。 11 Wiki に 貢献することは本質的にはハイパーリンクをビルドすることなので、13 Wiki に投稿することは本質的にはハイパーリンクをビルドすることなので、 12 14 HTML に関する一般的な助言についてもここで扱います。 13 例えば、 ''[http://www.w3.org/Provider/Style オンライン・ハイパーテキストのためのスタイルガイド]'' には 15 例えば、 ''[http://www.w3.org/Provider/Style オンライン・ハイパーテキストのためのスタイルガイド]'' には 14 16 [http://www.w3.org/Provider/Style/Structure.html 作品全体の構造] についての考え方や 15 17 情報を [http://www.w3.org/Provider/Style/WithinDocument.html 各ドキュメントに] まとめる方法について説明されています。最も重要な tip として、 “ あなたがリンクをたどっていなかったとしても、読むことができる HTML ページにしよう” ということです。 16 18 17 19 詳細について: 18 * WikiNewPage は新しい Wiki ページの作成時参照して下さい。すなわち、 [PageTemplates Wiki ページテンプレート] から始めるために Wiki ページの新規作成を構成できます。 19 * WikiFormatting のルール、 WikiMacros や WikiProcessors のような上級者向けルールも含みます。 20 * WikiPageNames の使用方法と TracLinks の他のフォーム、すなわちもっと細かな方法で Trac 内のいろいろなリソースを参照する方法 20 * WikiFormatting のルール。WikiMacros や WikiProcessors のような上級者向けルールも含みます 21 * WikiPageNames の使用方法。TracLinks の他の書式、すなわちもっと細かな方法で Trac 内のいろいろなリソースを参照する方法 21 22 22 もし Wiki テキストを編集する練習をしたいならば、 SandBox を使用してください。23 もし Wiki テキストを編集する練習をしたいならば、SandBox を使用してください。Note: 誰でもすべての Trac Wiki を編集できるわけではありません。プロジェクトの方針によります。Trac の管理者に確認してください。 23 24 24 25 変更を保存する前に、そのページを ''プレビュー'' することや、あなたが行なった ''変更を確認'' することができます。 25 ''並べて編集'' モードを有効にし たとき、タイピングすると書式のプレビューが自動的に表示されます。 ''編集をしたタイミングと、プレビューが自動的に更新されるタイミングについて [wiki:/TracIni#trac-section 遅延設定] が可能です。''26 ''並べて編集'' モードを有効にしタイピングすると、書式のプレビューが自動的に表示されます(設定を反映させるには一度プレビューを見る必要があります)。 ''編集をしたタイミングと、プレビューが自動的に更新されるタイミングについて [wiki:/TracIni#trac-section 遅延設定] が可能です。'' 26 27 27 28 Web 上のその他の情報について: 28 29 * 有名な Wiki 百科事典における [http://wikipedia.org/wiki/Wiki Wiki] の定義 29 30 * Wiki の [http://c2.com/cgi/wiki?WikiHistory 歴史] 30 * [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks なぜ Wiki は動くのか] を説明した Wiki ページ31 * [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks なぜ wiki は動くのか] を説明した Wiki ページ 31 32 32 33 ----