Context Navigation

← Previous Change
Wiki History
Next Change →

Version 1 から Version 2 における更新: WikiFormatting

Timestamp:: Nov 29, 2010, 3:25:28 PM (14 years 前)
Author:: trac (IP: 127.0.0.1)
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

WikiFormatting

v1	v2
1		= Wiki ~~文法 = #WikiFormatting~~
	1	= WikiFormatting =
2	2	[[TracGuideToc]]
3	3
4		Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。
5
6		Trac は小さく強力な Wiki レンダリングエンジンを内蔵しています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。
7		(特に [http://moinmoin.wikiwikiweb.de/ MoinMoin])
8
9
10		このページは、 WikiFormatting でフォーマットできる文法の文例集です。
11
12
13		== フォント書式 == #FontStyles
14
15		Trac の Wiki は以下のフォント書式に対応しています:
16		{{{
17		* '''ボールド''', '''!''' この箇所もボールドになります''', '''! '''
18		* ''イタリック''
19		* '''''ボールドイタリック'''''
20		* __アンダーライン__
21		* {{{モノスペース}}} or `モノスペース`
22		* ~~取り消し線~~
23		* ^上付き文字^
24		* ,,下付き文字,,
25		}}}
26
27		表示内容:
28		* '''ボールド''', '''!''' この箇所もボールドになります''', '''! '''
29		* ''イタリック''
30		* '''''ボールドイタリック'''''
31		* __アンダーライン__
32		* {{{モノスペース}}} or `モノスペース`
33		* ~~取り消し線~~
34		* ^上付き文字^
35		* ,,下付き文字,,
	4	Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and powerful whole.
	5
	6	Trac has a built in small and powerful wiki rendering engine. This wiki engine implements an ever growing subset of the commands from other popular Wikis,
	7	especially [http://moinmo.in/ MoinMoin] and [trac:WikiCreole].
	8
	9
	10	This page will give you an in-depth explanation of the wiki markup available anywhere WikiFormatting is allowed.
	11
	12	The ''Cheat sheet'' below gives you a quick overview for the most common syntax, each link in the ''Category'' column will lead you to the more detailed explanation later in this page.
	13
	14	A few other wiki pages present the advanced features of the Trac wiki markup in more depth:
	15	- TracLinks covers all the possible ways to refer precisely to any Trac resource or parts thereof,
	16	- WikiPageNames talks about the various names a wiki page can take, CamelCase or not
	17	- WikiMacros lists the macros available for generating dynamic content,
	18	- WikiProcessors and WikiHtml details how parts of the wiki text can be processed in special ways
	19
	20
	21	== Cheat sheet ==
	22
	23	\|\|= '''Category''' =\|\|= '''Wiki Markup''' =\|\|= '''Display''' =\|\|
	24	\|-----------------------------------------------------------
	25	{{{#!th rowspan=3
	26	[#FontStyles Font Styles]
	27	}}}
	28	\|\| `'''bold'''`, `''italic''`, `'''''Wikipedia style'''''` \|\| \
	29	\|\| '''bold''', ''italic'', '''''Wikipedia style''''' \|\|
	30	\|\| {{{`monospaced and ''nowiki''`}}} \|\| \
	31	\|\| `monospaced and nowiki` \|\|
	32	\|\| `bold`, `//italic//`, `//!WikiCreole style//` \|\| \
	33	\|\| bold, //italic//, //!WikiCreole style// \|\|
	34	\|-----------------------------------------------------------
	35	\|\|= [#Headings Headings] =\|\|\
	36	{{{#!td
	37	{{{
	38	== Level 2 ==
	39	=== Level 3 ^([#hn note])^
	40	}}}
	41	}}}
	42	{{{#!td style="padding-left: 2em"
	43	== Level 2
	44	=== Level 3 ^([#hn note])^
	45	}}}
	46	\|-----------------------------------------------------------
	47	\|\|= [#Paragraphs Paragraphs] =\|\|\
	48	{{{#!td
	49	{{{
	50	First paragraph
	51	on multiple lines.
	52
	53	Second paragraph.
	54	}}}
	55	}}}
	56	{{{#!td
	57	First paragraph
	58	on multiple lines.
	59
	60	Second paragraph.
	61	}}}
	62	\|-----------------------------------------------------------
	63	\|\|= [#Lists Lists] =\|\|\
	64	{{{#!td
	65	{{{
	66	* bullets list
	67	on multiple paragraphs
	68	1. nested list
	69	a. different numbering
	70	styles
	71	}}}
	72	}}}
	73	{{{#!td
	74	* bullets list
	75	on multiple paragraphs
	76	1. nested list
	77	a. different numbering
	78	styles
	79	}}}
	80	\|-----------------------------------------------------------
	81	{{{#!th
	82	[#DefinitionLists Definition Lists]
	83	}}}
	84	{{{#!td
	85	{{{
	86	term:: definition on
	87	multiple paragraphs
	88	}}}
	89	}}}
	90	{{{#!td
	91	term:: definition on
	92	multiple paragraphs
	93	}}}
	94	\|-----------------------------------------------------------
	95	\|\|= [#PreformattedText Preformatted Text] =\|\|\
	96	{{{#!td
	97	{{{
	98	{{{
	99	multiple lines, ''no wiki''
	100	white space respected
	101	}}}
	102	}}}
	103	}}}
	104	{{{#!td
	105	{{{
	106	multiple lines, ''no wiki''
	107	white space respected
	108	}}}
	109	}}}
	110	\|-----------------------------------------------------------
	111	\|\|= [#Blockquotes Blockquotes] =\|\|\
	112	{{{#!td
	113	{{{
	114	if there's some leading
	115	space the text is quoted
	116	}}}
	117	}}}
	118	{{{#!td
	119	if there's some leading
	120	space the text is quoted
	121	}}}
	122	\|-----------------------------------------------------------
	123	\|\|= [#DiscussionCitations Discussion Citations] =\|\|\
	124	{{{#!td
	125	{{{
	126	>> ... (I said)
	127	> (he replied)
	128	}}}
	129	}}}
	130	{{{#!td
	131	>>... (I said)
	132	> (he replied)
	133	}}}
	134	\|-----------------------------------------------------------
	135	\|\|= [#Tables Tables] =\|\|\
	136	{{{#!td
	137	{{{
	138	\|\|= Table Header =\|\| Cell \|\|
	139	\|\|\|\| (details below) \|\|
	140	}}}
	141	}}}
	142	{{{#!td
	143	\|\|= Table Header =\|\| Cell \|\|
	144	\|\|\|\| (details below) \|\|
	145	}}}
	146	\|-----------------------------------------------------------
	147	{{{#!th rowspan=2
	148	[#Links Links]
	149	}}}
	150	\|\| `http://trac.edgewall.org` \|\|\
	151	\|\| http://trac.edgewall.org \|\|
	152	\|\| `WikiFormatting (CamelCase)` \|\|\
	153	\|\| WikiFormatting (CamelCase) \|\|
	154	\|-----------------------------------------------------------
	155	{{{#!th rowspan=5
	156	[#TracLinks TracLinks]
	157	}}}
	158	\|\| `wiki:WikiFormatting`, `wiki:"WikiFormatting"` \|\|\
	159	\|\| wiki:WikiFormatting, wiki:"WikiFormatting" \|\|
	160	\|\| `#1 (ticket)`, `[1] (changeset)`, `{1} (report)` \|\|\
	161	\|\| #1 (ticket), [1] (changeset), {1} (report) \|\|
	162	\|\| `ticket:1, ticket:1#comment:1` \|\|\
	163	\|\| ticket:1, ticket:1#comment:1 \|\|
	164	\|\| `Ticket [ticket:1]`, `[ticket:1 ticket one]` \|\|\
	165	\|\| Ticket [ticket:1], [ticket:1 ticket one] \|\|
	166	\|\| `Ticket [[ticket:1]]`, `[[ticket:1\|ticket one]]` \|\|\
	167	\|\| Ticket [[ticket:1]], [[ticket:1\|ticket one]] \|\|
	168	\|-----------------------------------------------------------
	169	{{{#!th rowspan=2
	170	[#SettingAnchors Setting Anchors]
	171	}}}
	172	\|\| `[=#point1 (1)] First...` \|\|\
	173	\|\| [=#point1 (1)] First... \|\|
	174	\|\| `see [#point1 (1)]` \|\|\
	175	\|\| see [#point1 (1)] \|\|
	176	\|-----------------------------------------------------------
	177	{{{#!th rowspan=2
	178	[#EscapingLinksandWikiPageNames Escaping Markup]
	179	}}}
	180	\|\| `!'' doubled quotes` \|\|\
	181	\|\| !'' doubled quotes \|\|
	182	\|\| `!wiki:WikiFormatting`, `!WikiFormatting` \|\|\
	183	\|\| !wiki:WikiFormatting, !WikiFormatting \|\|
	184	\|-----------------------------------------------------------
	185	\|\|= [#Images Images] =\|\| `[[Image(`''link''`)]]` \|\| [[Image(htdocs:../common/trac_logo_mini.png)]] \|\|
	186	\|-----------------------------------------------------------
	187	{{{#!th rowspan=2
	188	[#Macros Macros]
	189	}}}
	190	\|\| `[[MacroList(*)]]` \|\| ''(short list of all available macros)'' \|\|
	191	\|\| `[[Image?]]` \|\| ''(help for the Image macro)'' \|\|
	192	\|-----------------------------------------------------------
	193	\|\|= [#Processors Processors] =\|\|\
	194	{{{#!td
	195	{{{
	196	{{{
	197	#!div style="font-size: 80%"
	198	Code highlighting:
	199	{{{#!python
	200	hello = lambda: "world"
	201	}}}
	202	}}}
	203	}}}
	204	}}}
	205	{{{#!td style="padding-left: 2em"
	206	{{{
	207	#!div style="font-size: 80%"
	208	Code highlighting:
	209	{{{#!python
	210	hello = lambda: "world"
	211	}}}
	212	}}}
	213	}}}
	214	\|-----------------------------------------------------------
	215	\|\|= [#Comments Comments] =\|\|\
	216	{{{#!td
	217	{{{
	218	{{{#!comment
	219	Note to Editors: ...
	220	}}}
	221	}}}
	222	}}}
	223	{{{#!td style="padding-left: 2em"
	224	{{{#!comment
	225	Note to Editors: ...
	226	}}}
	227	}}}
	228	\|-----------------------------------------------------------
	229	\|\|= [#Miscellaneous Miscellaneous] =\|\|\
	230	{{{#!td
	231	{{{
	232	Line [[br]] break
	233	Line \\ break
	234	----
	235	}}}
	236	}}}
	237	{{{#!td style="padding-left: 2em"
	238	Line [[br]] break
	239	Line \\ break
	240	----
	241	}}}
	242
	243
	244	== Font Styles ==
	245
	246	The Trac wiki supports the following font styles:
	247	\|\|= Wiki Markup =\|\|= Display =\|\|
	248	{{{#!td
	249	{{{
	250	* '''bold''',
	251	''' triple quotes !'''
	252	can be bold too if prefixed by ! ''',
	253	* ''italic''
	254	* '''''bold italic''''' or ''italic and
	255	''' italic bold ''' ''
	256	* __underline__
	257	* {{{monospace}}} or `monospace`
	258	(hence `{{{` or {{{`}}} quoting)
	259	* ~~strike-through~~
	260	* ^superscript^
	261	* ,,subscript,,
	262	* also bold, //italic as well//,
	263	and '' bold italic '' //(since 0.12)//
	264	}}}
	265	}}}
	266	{{{#!td
	267	* '''bold''',
	268	''' triple quotes !'''
	269	can be bold too if prefixed by ! ''',
	270	* ''italic''
	271	* '''''bold italic''''' or ''italic and
	272	''' italic bold ''' ''
	273	* __underline__
	274	* {{{monospace}}} or `monospace`
	275	(hence `{{{` or {{{`}}} quoting)
	276	* ~~strike-through~~
	277	* ^superscript^
	278	* ,,subscript,,
	279	* also bold, //italic as well//,
	280	and '' bold italic '' //(since 0.12)//
	281	}}}
36	282
37	283	Notes:
38		* `{{{...}}}`と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。
39		* {{{ ! }}} は wiki パーサに wiki フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです。
40
41		== 見出し == #Headings
42
43		1 文字から 5 文字の「イコール '='」を行頭に置き、 1 文字のスペースに続けてタイトルを置くと、
44		見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)'' を
45		置きます。
46		見出しに続いて id 属性を明示的に付与することが出来ます。付与しない場合、暗黙の読み取り可能な id 属性が生成されます。
47		'''(訳注: 明示的に付与する id 属性では日本語は使用できないようです。)'''
48
49		例:
50		{{{
51		= 見出し (第1レベル) =
52		== 見出し (第2レベル) ==
53		=== 見出し (第3レベル) ===
54		=== 明示的な id === #using-explicit-id-in-heading
55		}}}
56
57		表示内容:
58		= 見出し (第1レベル) =
59		== 見出し (第2レベル) ==
60		=== 見出し (第3レベル) ===
61		=== 明示的な id === #using-explicit-id-in-heading
62
63		== 改行 == #Paragraphs
64
65		2 つのテキストブロックの間に 1 行以上の空行がある場合、新しい段落として改行を行います。
66
67		強制的に改行だけを行いたい場合、このように書いてください:
68		{{{
69		1行目[[BR]]2行目
70		}}}
71		以下のように表示されます:
72
73		1行目[[BR]]2行目
74
75
76		== リスト == #Lists
77
78		番号付きリストと番号無しリストの両方があります。
79
80		例:
81		{{{
	284	* `{{{...}}}` and {{{`...`}}} commands not only select a monospace font, but also treat their content as verbatim text, meaning that no further wiki processing is done on this text.
	285	* {{{ ! }}} tells wiki parser to not take the following characters as wiki format, so pay attention to put a space after !, e.g. when ending bold.
	286	* all the font styles marks have to be used in opening/closing pairs,
	287	and they must nest properly (in particular, an `''` italic can't be paired
	288	with a `//` one, and `'''` can't be paired with `**`)
	289
	290
	291	== Headings ==
	292
	293	You can create heading by starting a line with one up to six ''equal'' characters ("=")
	294	followed by a single space and the headline text.
	295
	296	[=#hn] The headline text can be followed by the same number of "=" characters, but this is no longer mandatory.
	297
	298	Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated.
	299
	300	\|\|= Wiki Markup =\|\|= Display =\|\|
	301	{{{#!td
	302	{{{
	303	= Heading =
	304	== Subheading
	305	=== About ''this'' ===
	306	=== Explicit id === #using-explicit-id-in-heading
	307	== Subheading #sub2
	308	}}}
	309	}}}
	310	{{{#!td style="padding: 1em;"
	311	{{{
	312	#!div
	313	== Subheading
	314	=== About ''this'' ===
	315	=== Explicit id === #using-explicit-id-in-heading
	316	== Subheading #sub2
	317	}}}
	318	}}}
	319
	320	== Paragraphs ==
	321
	322	A new text paragraph is created whenever two blocks of text are separated by one or more empty lines.
	323
	324	A forced line break can also be inserted, using:
	325	\|\|= Wiki Markup =\|\|= Display =\|\|
	326	{{{#!td
	327	{{{
	328	Line 1[[BR]]Line 2
	329	}}}
	330	{{{
	331	Paragraph
	332	one
	333
	334	Paragraph
	335	two
	336	}}}
	337	}}}
	338	{{{#!td
	339	Line 1[[BR]]Line 2
	340
	341	Paragraph
	342	one
	343
	344	Paragraph
	345	two
	346	}}}
	347
	348	== Lists ==
	349
	350	The wiki supports both ordered/numbered and unordered lists.
	351
	352	Example:
	353	\|\|= Wiki Markup =\|\|= Display =\|\|
	354	{{{#!td
	355	{{{
	356	* Item 1
	357	* Item 1.1
	358	* Item 1.1.1
	359	* Item 1.1.2
	360	* Item 1.1.3
	361	* Item 1.2
	362	* Item 2
	363	- items can start at the beginning of a line
	364	and they can span multiple lines
	365	- be careful though to continue the line
	366	with the appropriate indentation, otherwise
	367	that will start a new paragraph...
	368
	369	1. Item 1
	370	a. Item 1.a
	371	a. Item 1.b
	372	i. Item 1.b.i
	373	i. Item 1.b.ii
	374	1. Item 2
	375	And numbered lists can also be restarted
	376	with an explicit number:
	377	3. Item 3
	378	}}}
	379	}}}
	380	{{{#!td
82	381	* Item 1
83	382	* Item 1.1
…	…
87	386	* Item 1.2
88	387	* Item 2
	388	- items can start at the beginning of a line
	389	and they can span multiple lines
	390	- be careful though to continue the line
	391	with the appropriate indentation, otherwise
	392	that will start a new paragraph...
89	393
90	394	1. Item 1
…	…
94	398	i. Item 1.b.ii
95	399	1. Item 2
96		~~番号付きリストでは、番号を指定することもできます~~:
	400	And numbered lists can also be restarted with an explicit number:
97	401	3. Item 3
98	402	}}}
99	403
100		表示内容:
101		* Item 1
102		* Item 1.1
103		* Item 1.1.1
104		* Item 1.1.2
105		* Item 1.1.3
106		* Item 1.2
107		* Item 2
108
109		1. Item 1
110		a. Item 1.a
111		a. Item 1.b
112		i. Item 1.b.i
113		i. Item 1.b.ii
114		1. Item 2
115		番号付きリストでは、番号を指定することもできます:
116		3. Item 3
117
118		リストマーカーの前にスペースを一つ以上置かなければなりません。スペースがない場合、通常のパラグラフとして扱われます。
119
120
121		== 用語定義リスト == #DefinitionLists
122
123
124		Wikiは用語定義リストも作成できます。
125
126		例:
	404
	405	== Definition Lists ==
	406
	407	The wiki also supports definition lists.
	408
	409	\|\|= Wiki Markup =\|\|= Display =\|\|
	410	{{{#!td
	411	{{{
	412	llama::
	413	some kind of mammal, with hair
	414	ppython::
	415	some kind of reptile, without hair
	416	(can you spot the typo?)
	417	}}}
	418	}}}
	419	{{{#!td
	420	llama::
	421	some kind of mammal, with hair
	422	ppython::
	423	some kind of reptile, without hair
	424	(can you spot the typo?)
	425	}}}
	426
	427	Note that you need a space in front of the defined term.
	428
	429
	430	== Preformatted Text ==
	431
	432	Block containing preformatted text are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote. The curly braces need to be on a separate line.
	433
	434	\|\|= Wiki Markup =\|\|= Display =\|\|
	435	{{{#!td
	436	{{{
	437	{{{
	438	def HelloWorld():
	439	print '''Hello World'''
	440	}}}
	441	}}}
	442	}}}
	443	{{{#!td
	444	{{{
	445	def HelloWorld():
	446	print '''Hello World'''
	447	}}}
	448	}}}
	449
	450	Note that this kind of block is also used for selecting lines that should be processed through WikiProcessors.
	451
	452	== Blockquotes ==
	453
	454	In order to mark a paragraph as blockquote, indent that paragraph with two spaces.
	455
	456	\|\|= Wiki Markup =\|\|= Display =\|\|
	457	{{{#!td
127	458	{{{
128		llama::
129		毛の生えた哺乳類の一種。
130		ppython::
131		毛がない爬虫類の一種。
132		(typoを見つけたかい?)
133		}}}
134
135		表示内容:
136		llama::
137		毛の生えた哺乳類の一種。
138		ppython::
139		毛がない爬虫類の一種。
140		(typoを見つけたかい?)
141
142		定義する用語の前にスペースが一つ必要なことを忘れないで下さい。
143
144
145		== 整形済みテキスト == #PreformattedText
146
147		整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。
148
149		例:
150		{{{
151		{{{
152		def HelloWorld():
153		print "Hello World"
154		}}}
155		}}}
156
157		表示内容:
158		{{{
159		def HelloWorld():
160		print "Hello World"
161		}}}
162
163
164		== 引用ブロック == #Blockquotes
165
166		段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。
167
168		例:
169		{{{
	459	Paragraph
170	460	This text is a quote from someone else.
171	461	}}}
172
173		表示内容:
	462	}}}
	463	{{{#!td
	464	Paragraph
174	465	This text is a quote from someone else.
175
176		== 引用 == #DiscussionCitations
177
178		進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。
179
180		例:
181		{{{
	466	}}}
	467
	468	== Discussion Citations ==
	469
	470	To delineate a citation in an ongoing discussion thread, such as the ticket comment area, e-mail-like citation marks (">", ">>", etc.) may be used.
	471
	472	\|\|= Wiki Markup =\|\|= Display =\|\|
	473	{{{#!td
	474	{{{
	475	>> Someone's original text
	476	> Someone else's reply text
	477	> - which can be any kind of Wiki markup
	478	My reply text
	479	}}}
	480	}}}
	481	{{{#!td
182	482	>> Someone's original text
183	483	> Someone else's reply text
	484	> - which can be any kind of Wiki markup
184	485	My reply text
185	486	}}}
186	487
187		表示内容:
188		>> Someone's original text
189		> Someone else's reply text
190		My reply text
191
192		''Note: いくつかの WikiFormatting の要素、表やあらかじめ整形されたテキストは引用エリアでは整形が崩れてしまいます。きれいな引用を作るには再整形が必要になるでしょう。''
193
194		== 表 == #Tables
195
196		簡単なテーブルはこのように記述します:
197		{{{
	488
	489	== Tables ==
	490	=== Simple Tables ===
	491	Simple tables can be created like this:
	492	\|\|= Wiki Markup =\|\|= Display =\|\|
	493	{{{#!td
	494	{{{
	495	\|\|Cell 1\|\|Cell 2\|\|Cell 3\|\|
	496	\|\|Cell 4\|\|Cell 5\|\|Cell 6\|\|
	497	}}}
	498	}}}
	499	{{{#!td style="padding: 2em;"
198	500	\|\|Cell 1\|\|Cell 2\|\|Cell 3\|\|
199	501	\|\|Cell 4\|\|Cell 5\|\|Cell 6\|\|
200	502	}}}
201	503
202		表示内容:
203		\|\|Cell 1\|\|Cell 2\|\|Cell 3\|\|
204		\|\|Cell 4\|\|Cell 5\|\|Cell 6\|\|
205
206		より複雑なテーブルは [wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText]
207		を使用して書くことができます。
208
209
210		== リンク == #Links
211
212		WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。
213
214		例:
	504	Cell headings can be specified by wrapping the content in a pair of '=' characters.
	505	Note that the '=' characters have to stick to the cell separators, like this:
	506	\|\|= Wiki Markup =\|\|= Display =\|\|
	507	{{{#!td
	508	{{{
	509	\|\| \|\|= stable =\|\|= latest =\|\|
	510	\|\|= 0.10 =\|\| 0.10.5 \|\| 0.10.6dev\|\|
	511	\|\|= 0.11 =\|\| 0.11.6 \|\| 0.11.7dev\|\|
	512	}}}
	513	}}}
	514	{{{#!td style="padding: 2em;"
	515	\|\| \|\|= stable =\|\|= latest =\|\|
	516	\|\|= 0.10 =\|\| 0.10.5 \|\| 0.10.6dev\|\|
	517	\|\|= 0.11 =\|\| 0.11.6 \|\| 0.11.7dev\|\|
	518	}}}
	519
	520	Finally, specifying an empty cell means that the next non empty cell will span the empty cells. For example:
	521	\|\|= Wiki Markup =\|\|= Display =\|\|
	522	{{{#!td
	523	{{{
	524	\|\| 1 \|\| 2 \|\| 3 \|\|
	525	\|\|\|\| 1-2 \|\| 3 \|\|
	526	\|\| 1 \|\|\|\| 2-3 \|\|
	527	\|\|\|\|\|\| 1-2-3 \|\|
	528	}}}
	529	}}}
	530	{{{#!td style="padding: 2em;"
	531	\|\| 1 \|\| 2 \|\| 3 \|\|
	532	\|\|\|\| 1-2 \|\| 3 \|\|
	533	\|\| 1 \|\|\|\| 2-3 \|\|
	534	\|\|\|\|\|\| 1-2-3 \|\|
	535	}}}
	536
	537	Note that if the content of a cell "sticks" to one side of the cell and only one, then the text will be aligned on that side. Example:
	538	\|\|= Wiki Markup =\|\|= Display =\|\|
	539	{{{#!td
	540	{{{
	541	\|\|=Text =\|\|= Numbers =\|\|
	542	\|\|left align \|\| 1.0\|\|
	543	\|\| center \|\| 4.5\|\|
	544	\|\| right align\|\| 4.5\|\|
	545	\|\| default alignment \|\| 2.5\|\|
	546	\|\|default\|\| 2.5\|\|
	547	\|\| default \|\| 2.5\|\|
	548	\|\| default \|\| 2.5\|\|
	549	}}}
	550	}}}
	551	{{{#!td style="padding: 2em;"
	552	\|\|=Text =\|\|= Numbers =\|\|
	553	\|\|left align \|\| 1.0\|\|
	554	\|\| center \|\| 4.5\|\|
	555	\|\| right align\|\| 4.5\|\|
	556	\|\| default alignment \|\| 2.5\|\|
	557	\|\|default\|\| 2.5\|\|
	558	\|\| default \|\| 2.5\|\|
	559	\|\| default \|\| 2.5\|\|
	560	}}}
	561
	562	If contrary to the example above, the cells in your table contain more text, it might be convenient to spread a table row over multiple lines of markup. The `\` character placed at the end of a line after a cell separator tells Trac to not start a new row for the cells on the next line.
	563
	564	\|\|= Wiki Markup =\|\|
	565	{{{#!td
	566	{{{
	567	\|\| this is column 1 [http://trac.edgewall.org/newticket new ticket] \|\| \
	568	\|\| this is column 2 [http://trac.edgewall.org/roadmap the road ahead] \|\| \
	569	\|\| that's column 3 and last one \|\|
	570	}}}
	571	}}}
	572	\|-------------
	573	\|\|= Display =\|\|
	574	{{{#!td style="padding: 2em;"
	575	\|\| this is column 1 [http://trac.edgewall.org/newticket new ticket] \|\| \
	576	\|\| this is column 2 [http://trac.edgewall.org/roadmap the road ahead] \|\| \
	577	\|\| that's column 3 and last one \|\|
	578	}}}
	579
	580	=== Complex Tables ===
	581
	582	If the possibilities offered by the simple "pipe"-based markup for tables described above are not enough for your needs, you can create more elaborated tables by using [#Processors-example-tables WikiProcessor based tables].
	583
	584
	585	== Links ==
	586
	587	Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}.
	588
	589	\|\|= Wiki Markup =\|\|= Display =\|\|
	590	{{{#!td
	591	{{{
	592	TitleIndex, http://www.edgewall.com/, !NotAlink
	593	}}}
	594	}}}
	595	{{{#!td
	596	TitleIndex, http://www.edgewall.com/, !NotAlink
	597	}}}
	598
	599	Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets.
	600	If the descriptive title is omitted, then the explicit prefix is discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.
	601
	602	\|\|= Wiki Markup =\|\|= Display =\|\|
	603	{{{#!td
	604	{{{
	605	* [http://www.edgewall.com Edgewall Software]
	606	* [wiki:TitleIndex Title Index]
	607	* [wiki:TitleIndex]
	608	* [wiki:ISO9000]
	609	}}}
	610	}}}
	611	{{{#!td
	612	* [http://www.edgewall.com Edgewall Software]
	613	* [wiki:TitleIndex Title Index]
	614	* [wiki:TitleIndex]
	615	* [wiki:ISO9000]
	616	}}}
	617
	618	Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe ('\|') and a title and all this inside //double// square brackets.
	619
	620	{{{#!td
	621	{{{
	622	* [[http://www.edgewall.com\|Edgewall Software]]
	623	* [[wiki:TitleIndex\|Title Index]]
	624	or even [[TitleIndex\|Title Index]]
	625	* [[wiki:TitleIndex]]
	626	''' but not ![[TitleIndex]]! '''
	627	* [[ISO9000]]
	628	}}}
	629	}}}
	630	{{{#!td
	631	* [[http://www.edgewall.com\|Edgewall Software]]
	632	* [[wiki:TitleIndex\|Title Index]]
	633	or even [[TitleIndex\|Title Index]]
	634	* [[wiki:TitleIndex]]
	635	''' but not ![[TitleIndex]]! '''
	636	* [[ISO9000]]
	637	}}}
	638
	639	'''Note''': the [trac:WikiCreole] style for links is quick to type and
	640	certainly looks familiar as it's the one used on Wikipedia and in many
	641	other wikis. Unfortunately it conflicts with the syntax for [#Macros macros].
	642	So in the rare case when you need to refer to a page which is named after
	643	a macro (typical examples being TitleIndex, InterTrac and InterWiki),
	644	by writing `[[TitleIndex]]` you will actually call the macro instead of linking
	645	to the page.
	646
	647	== Trac Links ==
	648
	649	Wiki pages can link directly to other parts of the Trac system. Pages can refer to tickets, reports, changesets, milestones, source files and other Wiki pages using the following notations:
	650
	651	\|\|= Wiki Markup =\|\|= Display =\|\|
	652	{{{#!td
	653	{{{
	654	* Tickets: #1 or ticket:1
	655	* Reports: {1} or report:1
	656	* Changesets: r1, [1] or changeset:1
	657	* ...
	658	* targeting other Trac instances,
	659	so called InterTrac links:
	660	- Tickets: #Trac1 or Trac:ticket:1
	661	- Changesets: [Trac1] or Trac:changeset:1
	662	}}}
	663	}}}
	664	{{{#!td
	665	* Tickets: #1 or ticket:1
	666	* Reports: {1} or report:1
	667	* Changesets: r1, [1] or changeset:1
	668	* ...
	669	* targeting other Trac instances,
	670	so called InterTrac links:
	671	- Tickets: #Trac1 or Trac:ticket:1
	672	- Changesets: [Trac1] or Trac:changeset:1
	673	}}}
	674
	675	There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers.
	676
	677
	678	== Setting Anchors ==
	679
	680	An anchor, or more correctly speaking, an [http://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 anchor name] can be added explicitly at any place in the Wiki page, in order to uniquely identify a position in the document:
	681
215	682	{{{
216		TitleIndex, http://www.edgewall.com/, !NotAlink
217		}}}
218
219		表示内容:
220		TitleIndex, http://www.edgewall.com/, !NotAlink
221
222		リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて 1 文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wiki ページを使いたい場合に役に立ちます。
223
224		例:
	683	[=#point1]
	684	}}}
	685
	686	This syntax was chosen to match the format for explicitly naming the header id [#Headings documented above]. For example:
225	687	{{{
226		* [http://www.edgewall.com/ Edgewall Software]
227		* [wiki:TitleIndex Title Index]
228		* [wiki:ISO9000]
229		}}}
230
231		表示内容:
232		* [http://www.edgewall.com/ Edgewall Software]
233		* [wiki:TitleIndex Title Index]
234		* [wiki:ISO9000]
235
236		== Trac リンク == #TracLinks
237
238		Wiki ページでは Trac の他のコンポーネントに直接リンクできます。チケット、レポート、チェンジセット、マイルストーン、ソースファイル、他の Wiki ページへは以下のようにリンクを記述します:
	688	== Long title == #title
	689	}}}
	690
	691	It's also very close to the syntax for the corresponding link to that anchor:
239	692	{{{
240		* チケット: #1 もしくは ticket:1
241		* レポート: {1} もしくは report:1
242		* チェンジセット: r1, [1] もしくは changeset:1
243		* ...
244		}}}
245
246		表示内容:
247		* チケット: #1 もしくは ticket:1
248		* レポート: {1} もしくは report:1
249		* チェンジセット: r1, [1] もしくは changeset:1
250		* ...
251
252		Trac は他にも多くの種類のリンクを使用することができます。より詳しい情報は TracLinks を参照してください。
253
254
255		== リンクの無効化 == #EscapingLinksandWikiPageNames
256
257		エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。
258
259		例:
	693	[#point1]
	694	}}}
	695
	696	Optionally, a label can be given to the anchor:
260	697	{{{
	698	[[=#point1 '''Point 1''']]
	699	}}}
	700
	701	\|\|= Wiki Markup =\|\|= Display =\|\|
	702	\|----------------------------------
	703	{{{#!td
	704	{{{
	705	[#point2 jump to the second point]
	706
	707	...
	708
	709	Point2: [=#point2] Jump here
	710	}}}
	711	}}}
	712	{{{#!td
	713	[#point2 jump to the second point]
	714
	715	...
	716
	717	Point2: [=#point2] Jump here
	718	}}}
	719
	720	For more complex anchors (e.g. when a custom title is wanted), one can use the Span macro, e.g. `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`.
	721
	722
	723	== Escaping Links and WikiPageNames ==
	724
	725	You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark).
	726
	727	\|\|= Wiki Markup =\|\|= Display =\|\|
	728	{{{#!td
	729	{{{
	730	!NoHyperLink
	731	!#42 is not a link
	732	}}}
	733	}}}
	734	{{{#!td
261	735	!NoHyperLink
262		!#42 はリンクではありません。
263		}}}
264
265		表示内容:
266		!NoHyperLink
267		!#42 はリンクではありません。
268
269
270		== 画像 == #Images
271
272		URL が `.png`, `.gif` or `.jpg` で終わっている場合、自動的にイメージへのリンクとはならずに `<img>` タグに変換されます。
273
274		現在では `[[Image]]` マクロを使用しなければなりません。画像を表示する最も簡単な方法は、現在のページへの添付ファイルとして画像をアップロードし、 `[[Image(picture.gif)]]` のようにファイル名を指定してマクロを呼び出す方法です。
275
276		現在のページに加えて、他のリソースを参照することも可能です。
	736	!#42 is not a link
	737	}}}
	738
	739	== Images ==
	740
	741	Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags.
	742
	743	You now have to use the ![[Image]] macro. The simplest way to include an image is to upload it as attachment to the current page, and put the filename in a macro call like `[[Image(picture.gif)]]`.
	744
	745	In addition to the current page, it is possible to refer to other resources:
277	746	* `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page)
278	747	* `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket)
…	…
280	749	* `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository)
281	750
282		表示例: [[Image(htdocs:../common/trac_logo_mini.png)]]
283
284
285		`[[Image()]]` マクロに関するより詳しい情報は WikiMacros に記載されています。
286
287
288		== マクロ == #Macros
289
290		マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。
291
292		例:
293		{{{
294		[[RecentChanges(Trac,3)]]
295		}}}
296
297		表示内容:
298		[[RecentChanges(Trac,3)]]
299
300		使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。
301
302
303		== プロセッサ == #Processors
304
305		Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップにも対応しています。例えば、プロセッサとしてページの描画に
306		[wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。
307
308		例1:
	751	\|\|= Wiki Markup =\|\|= Display =\|\|
	752	{{{#!td
	753	{{{
	754	[[Image(htdocs:../common/trac_logo_mini.png)]]
	755	}}}
	756	}}}
	757	{{{#!td
	758	[[Image(htdocs:../common/trac_logo_mini.png)]]
	759	}}}
	760
	761	See WikiMacros for further documentation on the `[[Image()]]` macro.
	762
	763
	764	== Macros ==
	765
	766	Macros are ''custom functions'' to insert dynamic content in a page.
	767
	768	\|\|= Wiki Markup =\|\|= Display =\|\|
	769	{{{#!td
	770	{{{
	771	[[RecentChanges(Trac,3)]]
	772	}}}
	773	}}}
	774	{{{#!td style="padding-left: 2em"
	775	[[RecentChanges(Trac,3)]]
	776	}}}
	777
	778	See WikiMacros for more information, and a list of installed macros.
	779
	780	The detailed help for a specific macro can also be obtained more directly by appending a "?" to the macro name.
	781
	782	\|\|= Wiki Markup =\|\|= Display =\|\|
	783	{{{#!td
	784	{{{
	785	[[MacroList?]]
	786	}}}
	787	}}}
	788	{{{#!td style="padding-left: 2em"
	789	[[MacroList?]]
	790	}}}
	791
	792
	793	== Processors ==
	794
	795	Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in
	796	[wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].
	797
	798	\|\|= Wiki Markup =\|\|= Display =\|\|
	799	\|--------------------------------------------------------
	800	{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
	801
	802	[=#Processors-example-html Example 1:] HTML
	803
	804	}}}
	805	\|--------------------------------------------------------
	806	{{{#!td style="border: 0px"
	807	{{{
	808	{{{
	809	#!html
	810	<h1 style="text-align: right; color: blue">
	811	HTML Test
	812	</h1>
	813	}}}
	814	}}}
	815	}}}
	816	{{{#!td valign="top" style="border: 0px"
	817
309	818	{{{
310	819	#!html
311		<pre class="wiki">{{{
312		#!html
313		<h1 style="text-align: right; color: blue">HTMLテスト</h1>
314		}}}</pre>
315		}}}
316
317		表示内容:
	820	<h1 style="text-align: right; color: blue">HTML Test</h1>
	821	}}}
	822
	823	}}}
	824	\|--------------------------------------------------------
	825	{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
	826
	827	[=#Processors-example-highlight Example 2:] Code Highlighting
	828
	829	}}}
	830	\|--------------------------------------------------------
	831	{{{#!td style="border: 0px"
	832	{{{
	833	{{{
	834	#!python
	835	class Test:
	836
	837	def __init__(self):
	838	print "Hello World"
	839	if __name__ == '__main__':
	840	Test()
	841	}}}
	842	}}}
	843	}}}
318	844	{{{
319		#!html
320		<h1 style="text-align: right; color: blue">HTMLテスト</h1>
321		}}}
322
323		例:
324		{{{
325		#!html
326		<pre class="wiki">{{{
327		#!python
328		class Test:
329
330		def __init__(self):
331		print "Hello World"
332		if __name__ == '__main__':
333		Test()
334		}}}</pre>
335		}}}
336
337		表示内容:
	845	#!td valign="top" style="border: 0px"
	846
338	847	{{{
339	848	#!python
…	…
345	854	}}}
346	855
347		Perl:
	856	}}}
	857	\|--------------------------------------------------------
	858	{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
	859
	860	[=#Processors-example-tables Example 3:] Complex Tables
	861
	862	}}}
	863	\|--------------------------------------------------------
	864	{{{#!td style="border: 0px"
	865	{{{
	866	{{{#!th rowspan=4 align=justify
	867	With the `#td` and `#th` processors,
	868	table cells can contain any content:
	869	}}}
	870	\|----------------
	871	{{{#!td
	872	- lists
	873	- embedded tables
	874	- simple multiline content
	875	}}}
	876	\|----------------
	877	{{{#!td
	878	As processors can be easily nested,
	879	so can be tables:
	880	{{{#!th
	881	Example:
	882	}}}
	883	{{{#!td style="background: #eef"
	884	\|\| must be at the third level now... \|\|
	885	}}}
	886	}}}
	887	\|----------------
	888	{{{#!td
	889	Even when you don't have complex markup,
	890	this form of table cells can be convenient
	891	to write content on multiple lines.
	892	}}}
	893	}}}
	894	}}}
348	895	{{{
349		#!perl
350		my ($test) = 0;
351		if ($test > 0) {
352		print "hello";
353		}
354		}}}
355
356		より詳細な情報は WikiProcessors に記載されています。
357
358
359		== コメント == #Comments
360
361		コメントをプレーンテキストに追加することができます。コメントはレンダリングされず、プレーンテキスト形式でのみ表示されます。
362		{{{
363		{{{
364		#!comment
365		Your comment here
366		}}}
367		}}}
368
369
370		== その他 == #Miscellaneous
371
372		4 文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。
373
374		例:
375		{{{
376		----
377		}}}
378
379		表示内容:
	896	#!td valign="top" style="border: 0px"
	897
	898	{{{#!th rowspan=4 align=justify
	899	With the `#td` and `#th` processors,
	900	table cells can contain any content:
	901	}}}
	902	\|----------------
	903	{{{#!td
	904	- lists
	905	- embedded tables
	906	- simple multiline content
	907	}}}
	908	\|----------------
	909	{{{#!td
	910	As processors can be easily nested,
	911	so can be tables:
	912	{{{#!th
	913	Example:
	914	}}}
	915	{{{#!td style="background: #eef"
	916	\|\| must be at the third level now... \|\|
	917	}}}
	918	}}}
	919	\|----------------
	920	{{{#!td
	921	Even when you don't have complex markup,
	922	this form of table cells can be convenient
	923	to write content on multiple lines.
	924	}}}
	925
	926	}}}
	927
	928	See WikiProcessors for more information.
	929
	930
	931	== Comments ==
	932
	933	Comments can be added to the plain text. These will not be rendered and will not display in any other format than plain text.
	934
	935	\|\|= Wiki Markup =\|\|= Display =\|\|
	936	{{{#!td
	937	{{{
	938	Nothing to
	939	{{{
	940	#!comment
	941	Your comment for editors here
	942	}}}
	943	see ;-)
	944	}}}
	945	}}}
	946	{{{#!td
	947	Nothing to
	948	{{{
	949	#!comment
	950	Your comment for editors here
	951	}}}
	952	see ;-)
	953	}}}
	954
	955	== Miscellaneous ==
	956
	957	An horizontal line can be used to separated different parts of your page:
	958
	959	\|\|= Wiki Markup =\|\|= Display =\|\|
	960	{{{#!td
	961	{{{
	962	Four or more dashes will be replaced
	963	by an horizontal line (<HR>)
	964	----
	965	See?
	966	}}}
	967	}}}
	968	{{{#!td
	969	Four or more dashes will be replaced
	970	by an horizontal line (<HR>)
380	971	----
381
382
383
384		----
385		See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring.
	972	See?
	973	}}}
	974	\|----------------------------------
	975	{{{#!td
	976	{{{
	977	"macro" style [[br]] line break
	978	}}}
	979	}}}
	980	{{{#!td
	981	"macro" style [[br]] line break
	982	}}}
	983	\|----------------------------------
	984	{{{#!td
	985	{{{
	986	!WikiCreole style \\ line\\break
	987	}}}
	988	}}}
	989	{{{#!td
	990	!WikiCreole style \\ line\\break
	991	}}}

XPressME Integration Kit

Trac

Context Navigation

Version 1 から Version 2 における更新: WikiFormatting

Legend:

WikiFormatting