Project

General

Profile

RedmineTextFormatting » History » Version 59

Dieter Egert, 2011-06-17 17:36

1 1 Jean-Philippe Lang
h1. Wiki formatting
2
3
{{>TOC}}
4
5
h2. Links
6
7 6 Jean-Philippe Lang
h3. Redmine links
8
9 1 Jean-Philippe Lang
Redmine allows hyperlinking between issues, changesets and wiki pages from anywhere wiki formatting is used.
10
11 8 Jean-Philippe Lang
* Link to an issue: *!#124* (displays #124, link is striked-through if the issue is closed)
12 6 Jean-Philippe Lang
* Link to a changeset: *!r758* (displays r758)
13 16 Jean-Philippe Lang
* Link to a changeset with a non-numeric hash: *commit:c6f4d0fd* (displays c6f4d0fd).  Added in r1236.
14 1 Jean-Philippe Lang
15 6 Jean-Philippe Lang
Wiki links:
16 1 Jean-Philippe Lang
17 3 Jean-Philippe Lang
* *[[Guide]]* displays a link to the page named 'Guide': [[Guide]]
18 51 Graham King
* *[[Guide|User manual]]* displays a link to the same page but with different text: [[Guide|User manual]]
19
* *[[Guide#User-guide|User guide]]* displays a link to the header on the same page with different text: [[Guide#User-guide|User guide]]
20 1 Jean-Philippe Lang
21 51 Graham King
You can also link to pages of another project's wiki:
22 3 Jean-Philippe Lang
23 1 Jean-Philippe Lang
* *[[sandbox:some page]]* displays a link to the page named 'Some page' of the Sandbox wiki
24
* *[[sandbox:]]* displays a link to the Sandbox wiki main page
25
26
Wiki links are displayed in red if the page doesn't exist yet, eg: [[Nonexistent page]].
27
28 32 Jean-Philippe Lang
Links to others resources:
29 6 Jean-Philippe Lang
30
* Documents:
31
32
  * *!document#17* (link to document with id 17)
33
  * *!document:Greetings* (link to the document with title "Greetings")
34
  * *!document:"Some document"* (double quotes can be used when document title contains spaces)
35 43 Markus Valle-Klann
  * *!document:some_project:"Some document"* (link to a document in a different project)
36 6 Jean-Philippe Lang
37
* Versions:
38
39
  * *!version#3* (link to version with id 3)
40
  * *!version:1.0.0* (link to version named "1.0.0")
41
  * *!version:"1.0 beta 2"*
42
43 44 Anh Tu Sam
* Projects:
44
45
  * *project#<id>* (link to project with <id>)
46
  * *!project:<identifier>*
47
  * *!project:<name>*
48
49 6 Jean-Philippe Lang
* Attachments:
50
  
51
  * *!attachment:file.zip* (link to the attachment of the current object named file.zip)
52
  * For now, attachments of the current object can be referenced only (if you're on an issue, it's possible to reference attachments of this issue only)
53 1 Jean-Philippe Lang
54 14 Jean-Philippe Lang
* Repository files
55
56 39 Yuki Kita
  * *!source:some/file*           -- Link to the file located at /some/file in the project's repository
57
  * *!source:some/file@52*        -- Link to the file's revision 52
58
  * *!source:some/file#L120*      -- Link to line 120 of the file
59
  * *!source:some/file@52#L120*   -- Link to line 120 of the file's revision 52
60
  * *!source:"some file@52#L120"* -- Double quotes can be used when the URL contains spaces
61
  * *!export:some/file*           -- Force the download of the file
62 14 Jean-Philippe Lang
63 32 Jean-Philippe Lang
Escaping:
64 6 Jean-Philippe Lang
65
* You can prevent Redmine links from being parsed by preceding them with an exclamation mark: !
66
67 42 Andrew Quach Huynh
h3. External links
68 5 Jean-Philippe Lang
69
HTTP URLs and email addresses are automatically turned into clickable links: 
70 47 Ian Epperson
* *http&#58;//www.redmine.org* -- External link to the redmine website: http://www.redmine.org
71
* *someone&#64;foo.bar* -- Link to an email address: someone@foo.bar
72 5 Jean-Philippe Lang
73 51 Graham King
HTTP URLs and email addresses can also use different text than the link itself:
74 47 Ian Epperson
* *"Redmine web site"&#58;http&#58;//www.redmine.org* -- External link with different text: "Redmine web site":http://www.redmine.org
75
* *"Email someone"&#58;mailto&#58;someone&#64;foo.bar* -- Email link with different text: "Email someone":mailto:someone@foo.bar
76 1 Jean-Philippe Lang
77 48 Ian Epperson
More complex email instructions can be added to an email link.  A default subject, default body and CC information can be defined.  Note that spaces in any of these fields need to be replaced with the code %20.
78
* *"Email webmaster and admin"&#58;mailto&#58;webmaster&#64;foo.bar?cc=admin&#64;foo.bar* -- Email to webmaster, CC admin:  "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar
79
* *"Email someone for help"&#58;mailto&#58;someone&#64;foo.bar?subject=Website%20Help* -- Email link with the subject "Website Help": "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help
80
* *"Email someone for help"&#58;mailto&#58;someone&#64;foo.bar?subject=Website%20Help&body=My%20problem%20is%20* -- Email link with the subject "Website Help" and a default body: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20
81
82 1 Jean-Philippe Lang
h2. Text formatting
83 10 John Goerzen
84 27 Jean-Philippe Lang
For things such as headlines, bold, tables, lists, Redmine supports Textile syntax.  See http://www.textism.com/tools/textile/ for information on using any of these features.  A few samples are included below, but the engine is capable of much more of that.
85 1 Jean-Philippe Lang
86 38 ha thach
h3. Acronym
87
88
<pre>
89
JPL(Jean-Philippe Lang)
90
</pre>
91
92
Display:
93
94
JPL(Jean-Philippe Lang)
95
96 1 Jean-Philippe Lang
h3. Font style
97
98
<pre><code>* *bold*
99
* _italic_
100 19 Pavel Schichko
* *_bold italic_*
101 1 Jean-Philippe Lang
* +underline+
102
* -strike-through-
103 45 Ian Epperson
* Plain ^superscript^
104
* Plain ~subscript~
105 1 Jean-Philippe Lang
</code></pre>
106
107
Display:
108
109
 * *bold*
110
 * _italic_
111 19 Pavel Schichko
 * *_bold italic_*
112 1 Jean-Philippe Lang
 * +underline+
113
 * -strike-through-
114 45 Ian Epperson
 * Plain ^superscript^
115
 * Plain ~subscript~
116 1 Jean-Philippe Lang
117
h3. Inline images
118 9 Jean-Philippe Lang
119 1 Jean-Philippe Lang
* *&#33;image_url&#33;* displays an image located at image_url (textile syntax)
120
* *&#33;>image_url&#33;* right floating image
121 18 samir djouadi
122 15 Jean-Philippe Lang
If you have an image attached to your wiki page, it can be displayed inline using its filename: *&#33;attached_image.png&#33;*
123 1 Jean-Philippe Lang
124
h3. Headings
125
126
<pre><code>h1. Heading
127
h2. Subheading
128
h3. Subheading
129
</code></pre>
130
131
h3. Paragraphs
132
133 58 Dieter Egert
<pre><code>p. left aligned
134
135
p(. left ident 1em
136
137
p((. left ident 2em
138
as well as for following lines
139
140
p>. right aligned
141
142
p)))>. right ident 3em
143
144
p=. This is centered paragraph.
145 1 Jean-Philippe Lang
</code></pre>
146
147 59 Dieter Egert
Display:
148
149 58 Dieter Egert
p. left aligned
150
151
p(. left ident 1em
152
153
p((. left ident 2em
154
as well as for following lines
155
156
p>. right aligned
157
158
p)))>. right ident 3em
159
160 1 Jean-Philippe Lang
p=. This is centered paragraph.
161
162 58 Dieter Egert
163 36 ha thach
h3. Predefined
164
165 37 ha thach
To escape wiki syntax
166 1 Jean-Philippe Lang
<pre> <pre> *Your text won't become bold* </pre> </pre>
167 38 ha thach
Display:
168
169 37 ha thach
<pre> *Your text won't become bold* </pre>
170 36 ha thach
171 1 Jean-Philippe Lang
h3. Blockquotes
172
173
Start the paragraph with *bq.*
174
175
<pre><code>bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
176
To go live, all you need to add is a database and a web server.
177
</code></pre>
178
179
Display:
180
181
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
182
To go live, all you need to add is a database and a web server.
183
184 28 Jean-Philippe Lang
h3. Unordered lists
185
186
<pre>
187
* Item 1
188
* Item 2
189 29 Eric Gallimore
** Item 21
190
** Item 22
191 28 Jean-Philippe Lang
* Item 3
192
</pre>
193
194
displays:
195 1 Jean-Philippe Lang
196 28 Jean-Philippe Lang
* Item 1
197
* Item 2
198 29 Eric Gallimore
** Item 21
199 28 Jean-Philippe Lang
** Item 22
200
* Item 3
201
202
h3. Ordered lists
203
204
<pre>
205
# Item 1
206
# Item 2
207 29 Eric Gallimore
# Item 3
208
## Item 3.1
209 28 Jean-Philippe Lang
## Item 3.2
210 20 Kirill Ponomarev
</pre>
211
212
displays:
213 21 Andrew Chaika
214
# Item 1
215
# Item 2
216 1 Jean-Philippe Lang
# Item 3
217
## Item 3.1
218
## Item 3.2
219
220
h3. Tables
221
222
<pre>
223 58 Dieter Egert
|_.UserID|_.Name|_.Group|_. attribute list |
224
|\3=.IT    |<. align left|
225
|1|Artur Pirozhkov|/2.Users|>. align right|
226
|2|Vasya Rogov|=. center |
227
|3|John Smith |Admin
228
               (root)|^. valign top |
229
|4|-          |Nobody
230
               (anonymous)|~. valign bottom|
231 20 Kirill Ponomarev
</pre>
232 21 Andrew Chaika
233 1 Jean-Philippe Lang
Display:
234
235 58 Dieter Egert
|_.UserID|_.Name|_.Group|_. attribute list |
236
|\3=.IT    |<. align left|
237
|1|Artur Pirozhkov|/2.Users|>. align right|
238
|2|Vasya Rogov|=. center |
239
|3|John Smith |Admin
240
               (root)|^. valign top |
241
|4|-          |Nobody
242
               (anonymous)|~. valign bottom|
243 1 Jean-Philippe Lang
244
h3. Table of content
245
246
<pre><code>{{toc}} => left aligned toc
247
{{>toc}} => right aligned toc
248
</code></pre>
249 7 Jean-Philippe Lang
250
h2. Macros
251
252
Redmine has the following builtin macros:
253
254
{{macro_list}}
255
256 1 Jean-Philippe Lang
257 4 Jean-Philippe Lang
h2. Code highlighting
258 51 Graham King
259 1 Jean-Philippe Lang
Code highlighting relies on "CodeRay":http://coderay.rubychan.de/, a fast syntax highlighting library written completely in Ruby. It currently supports C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP, Python, RHTML, Ruby, Scheme, SQL, XML and YAML code.
260
261
You can highlight code in your wiki page using this syntax:
262
263 49 Dave Clements
<pre><code><pre><code class="ruby">
264 1 Jean-Philippe Lang
  Place your code here.
265 40 Mischa The Evil
</code></pre>
266 1 Jean-Philippe Lang
</code></pre>
267
268
Example:
269
270
<pre><code class="ruby">
271
# The Greeter class
272
class Greeter
273
  def initialize(name)
274
    @name = name.capitalize
275
  end
276
 
277
  def salute
278
    puts "Hello #{@name}!"
279
  end
280 40 Mischa The Evil
end
281 52 Vladimir Vasilkin
</code></pre>
282
283
284
h2. Translation
285
286
h3. Русский 
287
288 1 Jean-Philippe Lang
[[RedmineTextFormattingRus|Частичный перевод на русский]]