Project

General

Profile

RedmineTextFormatting » History » Version 86

Victor Zagorodny, 2012-11-29 09:26

1 68 Jean-Philippe Lang
h1. Text formatting
2 1 Jean-Philippe Lang
3
{{>TOC}}
4
5
h2. Links
6
7 6 Jean-Philippe Lang
h3. Redmine links
8
9 68 Jean-Philippe Lang
Redmine allows hyperlinking between resources (issues, changesets, wiki pages...) from anywhere text formatting is used.
10 1 Jean-Philippe Lang
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 68 Jean-Philippe Lang
* Link to a changeset with a non-numeric hash: *commit:c6f4d0fd* (displays c6f4d0fd).
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 1 Jean-Philippe Lang
* Attachments:
50 6 Jean-Philippe Lang
  
51
  * *!attachment:file.zip* (link to the attachment of the current object named file.zip)
52 68 Jean-Philippe Lang
  * *!attachment:"file.zip"* (double quotes can be used when the filename contains non word characters)
53 6 Jean-Philippe Lang
  * 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)
54 1 Jean-Philippe Lang
55 14 Jean-Philippe Lang
* Repository files
56
57 39 Yuki Kita
  * *!source:some/file*           -- Link to the file located at /some/file in the project's repository
58
  * *!source:some/file@52*        -- Link to the file's revision 52
59
  * *!source:some/file#L120*      -- Link to line 120 of the file
60
  * *!source:some/file@52#L120*   -- Link to line 120 of the file's revision 52
61 77 Thomas Themel
  * *!source:"some file@52#L120"* -- Double quotes can be used when the URL contains spaces  
62
  * *!source:repo_identifier|some/file* -- Link to a file in a repository other than the project default repository. 
63
  * *!source:"repo_identifier|some file"* -- Link to a file in a repository other than the project default repository, with spaces in the path. 
64 1 Jean-Philippe Lang
  * *!export:some/file*           -- Force the download of the file
65 77 Thomas Themel
 
66 14 Jean-Philippe Lang
67 32 Jean-Philippe Lang
Escaping:
68 6 Jean-Philippe Lang
69
* You can prevent Redmine links from being parsed by preceding them with an exclamation mark: !
70
71 42 Andrew Quach Huynh
h3. External links
72 5 Jean-Philippe Lang
73 83 Jean-Philippe Lang
HTTP URLs are automatically turned into clickable links: 
74 47 Ian Epperson
* *http&#58;//www.redmine.org* -- External link to the redmine website: http://www.redmine.org
75
* *someone&#64;foo.bar* -- Link to an email address: someone@foo.bar
76 5 Jean-Philippe Lang
77 83 Jean-Philippe Lang
HTTP URLs can also use different text than the link itself:
78 47 Ian Epperson
* *"Redmine web site"&#58;http&#58;//www.redmine.org* -- External link with different text: "Redmine web site":http://www.redmine.org
79 70 Jean-Philippe Lang
* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- External image with a title that links to an URL: 
80 1 Jean-Philippe Lang
81
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org
82 83 Jean-Philippe Lang
83
h3. Email addresses
84
85
Email addresses are automatically turned into clickable links:
86 70 Jean-Philippe Lang
87 47 Ian Epperson
* *"Email someone"&#58;mailto&#58;someone&#64;foo.bar* -- Email link with different text: "Email someone":mailto:someone@foo.bar
88 1 Jean-Philippe Lang
89 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.
90
* *"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
91
* *"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
92
* *"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
93
94 1 Jean-Philippe Lang
h2. Text formatting
95 10 John Goerzen
96 67 Jean-Philippe Lang
For things such as headlines, bold, tables, lists, Redmine supports "Textile syntax":http://en.wikipedia.org/wiki/Textile_%28markup_language%29.  See http://redcloth.org/hobix.com/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.
97 1 Jean-Philippe Lang
98 38 ha thach
h3. Acronym
99
100
<pre>
101
JPL(Jean-Philippe Lang)
102
</pre>
103
104
Display:
105
106
JPL(Jean-Philippe Lang)
107
108 1 Jean-Philippe Lang
h3. Font style
109
110
<pre><code>* *bold*
111
* _italic_
112 19 Pavel Schichko
* *_bold italic_*
113 1 Jean-Philippe Lang
* +underline+
114
* -strike-through-
115 45 Ian Epperson
* Plain ^superscript^
116
* Plain ~subscript~
117 63 Colin Sullivan
* @inline monospace@
118 1 Jean-Philippe Lang
</code></pre>
119
120
Display:
121
122
 * *bold*
123
 * _italic_
124 19 Pavel Schichko
 * *_bold italic_*
125 1 Jean-Philippe Lang
 * +underline+
126
 * -strike-through-
127 45 Ian Epperson
 * Plain ^superscript^
128
 * Plain ~subscript~
129 63 Colin Sullivan
 * @inline monospace@
130 1 Jean-Philippe Lang
131
h3. Inline images
132 9 Jean-Philippe Lang
133 1 Jean-Philippe Lang
* *&#33;image_url&#33;* displays an image located at image_url (textile syntax)
134
* *&#33;>image_url&#33;* right floating image
135 66 Jean-Philippe Lang
* *&#33;image_url(Image title)&#33;* displays an image with an alt/title attribute
136 73 Dieter Egert
* *&#33;image_url&#33;:URL* displays an image located at image_url with link URL added
137 18 samir djouadi
138 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;*
139 1 Jean-Philippe Lang
140 80 Caio Cunha
You can also apply a CSS style to the image in the same ways as styling SPANs. The code *&#33;{width: 100%}attached_image.png&#33;* will make the image adjusts to the parent's width.
141
142 1 Jean-Philippe Lang
h3. Headings
143
144
<pre><code>h1. Heading
145 66 Jean-Philippe Lang
146 1 Jean-Philippe Lang
h2. Subheading
147 66 Jean-Philippe Lang
148 1 Jean-Philippe Lang
h3. Subheading
149
</code></pre>
150
151
h3. Paragraphs
152
153 58 Dieter Egert
<pre><code>p. left aligned
154
155 60 Dieter Egert
  p(. left ident 1em
156 58 Dieter Egert
157 60 Dieter Egert
    p((. left ident 2em
158
    as well as for following lines
159 58 Dieter Egert
160 60 Dieter Egert
                                                                                   p>. right aligned
161 58 Dieter Egert
162 60 Dieter Egert
                                                                        p)))>. right ident 3em
163 58 Dieter Egert
164 60 Dieter Egert
                           p=. This is centered paragraph.
165 1 Jean-Philippe Lang
</code></pre>
166
167
h3. Predefined
168
169
To escape wiki syntax
170 58 Dieter Egert
<pre> <pre> *Your text won't become bold* </pre> </pre>
171 36 ha thach
Display:
172 37 ha thach
173 1 Jean-Philippe Lang
<pre> *Your text won't become bold* </pre>
174 38 ha thach
175
h3. Blockquotes
176 37 ha thach
177 84 Jean-Philippe Lang
Start the paragraph with *bq.*:
178 1 Jean-Philippe Lang
179
<pre><code>bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
180
To go live, all you need to add is a database and a web server.
181
</code></pre>
182
183 84 Jean-Philippe Lang
Displays:
184 1 Jean-Philippe Lang
185
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
186
To go live, all you need to add is a database and a web server.
187
188 84 Jean-Philippe Lang
You can also use > at the beginning of each line and stack them for nested quotes:
189
190
<pre>
191 1 Jean-Philippe Lang
>> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
192 84 Jean-Philippe Lang
>> To go live, all you need to add is a database and a web server.
193
> Great!
194
</pre>
195
196
Displays:
197
198
>>  Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
199
>>  To go live, all you need to add is a database and a web server.
200
> Great!
201 60 Dieter Egert
202 28 Jean-Philippe Lang
h3. Unordered lists
203
204
<pre>
205
* Item 1
206
* Item 2
207 29 Eric Gallimore
** Item 21
208
** Item 22
209 28 Jean-Philippe Lang
* Item 3
210
</pre>
211
212
displays:
213 1 Jean-Philippe Lang
214 28 Jean-Philippe Lang
* Item 1
215
* Item 2
216 29 Eric Gallimore
** Item 21
217 28 Jean-Philippe Lang
** Item 22
218
* Item 3
219 1 Jean-Philippe Lang
220
h3. Ordered lists
221
222 28 Jean-Philippe Lang
<pre>
223
# Item 1
224
# Item 2
225
# Item 3
226
## Item 3.1
227
## Item 3.2
228 1 Jean-Philippe Lang
</pre>
229 29 Eric Gallimore
230
displays:
231 1 Jean-Philippe Lang
232 20 Kirill Ponomarev
# Item 1
233
# Item 2
234
# Item 3
235 21 Andrew Chaika
## Item 3.1
236
## Item 3.2
237
238 1 Jean-Philippe Lang
h3. Tables
239
240
<pre>
241 71 Dieter Egert
|_.UserID     |_.Name|_.Group|_. attribute list  |
242 72 Dieter Egert
|Starting with| a    |   simple|row |
243 60 Dieter Egert
|\3=.IT               |<. align left|
244
|1|Artur Pirozhkov |/2.Users |>. align right|
245
|2|Vasya Rogov        |=. center |
246 58 Dieter Egert
|3|John Smith |Admin
247
               (root)|^. valign top |
248
|4|-          |Nobody
249
               (anonymous)|~. valign bottom|
250 20 Kirill Ponomarev
</pre>
251 21 Andrew Chaika
252 1 Jean-Philippe Lang
displays (all multiple spaces are replaced by 1 space):
253
254 71 Dieter Egert
|_.UserID     |_.Name|_.Group|_. attribute list   |
255 72 Dieter Egert
|Starting with| a    |   simple|row |
256 60 Dieter Egert
|\3=.IT                |<. align left|
257
|1|Artur Pirozhkov |/2.Users |>. align right|
258
|2|Vasya Rogov         |=. center |
259 58 Dieter Egert
|3|John Smith |Admin
260
               (root)|^. valign top |
261
|4|-          |Nobody
262
               (anonymous)|~. valign bottom|
263 1 Jean-Philippe Lang
264 78 Thomas Themel
If you want to include pipe characters inside your table (e.g. for Wiki links), you need to prevent textile from interpreting them:
265
266
|_.Input |_. Output|
267
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
268
269 1 Jean-Philippe Lang
h3. Table of content
270
271
<pre><code>{{toc}} => left aligned toc
272
{{>toc}} => right aligned toc
273
</code></pre>
274 7 Jean-Philippe Lang
275 79 Mike Bison
Please keep in mind, that the toc-tag needs an empty line above and underneath it and no other text before and after it.
276
277
Example:
278
279
<pre><code>
280
h1. headLineOne
281
282
h2. something
283
284
{{toc}}
285
286
h2. something more
287
</code></pre>
288
289 7 Jean-Philippe Lang
h2. Macros
290
291 82 Jean-Philippe Lang
Redmine includes a macros system that lets you add custom functions to insert dynamic content in formatted text. You can learn about writing your own macros in [[RedmineMacros]]. Redmine alse includes a few builtin macros:
292 7 Jean-Philippe Lang
293
{{macro_list}}
294 1 Jean-Philippe Lang
295 4 Jean-Philippe Lang
h2. Code highlighting
296 51 Graham King
297 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.
298
299
You can highlight code in your wiki page using this syntax:
300
301 49 Dave Clements
<pre><code><pre><code class="ruby">
302 1 Jean-Philippe Lang
  Place your code here.
303 40 Mischa The Evil
</code></pre>
304 1 Jean-Philippe Lang
</code></pre>
305
306
Example:
307
308
<pre><code class="ruby">
309
# The Greeter class
310
class Greeter
311
  def initialize(name)
312
    @name = name.capitalize
313
  end
314
 
315
  def salute
316
    puts "Hello #{@name}!"
317
  end
318 40 Mischa The Evil
end
319 52 Vladimir Vasilkin
</code></pre>
320
321
h2. Translation
322 1 Jean-Philippe Lang
323 75 Caille Rotie
Note that the following translations may not be up to date. Please refer to the original english documentation if needed.
324 52 Vladimir Vasilkin
325 75 Caille Rotie
* [[RusRedmineTextFormatting|Перевод на русский]]
326
* [[FrRedmineWikiFormatting|French]]