Project

General

Profile

RedmineTextFormatting » History » Version 76

Caille Rotie, 2012-08-07 09:46

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
  * *!source:"some file@52#L120"* -- Double quotes can be used when the URL contains spaces
62
  * *!export:some/file*           -- Force the download of the file
63 14 Jean-Philippe Lang
64 32 Jean-Philippe Lang
Escaping:
65 6 Jean-Philippe Lang
66
* You can prevent Redmine links from being parsed by preceding them with an exclamation mark: !
67
68 42 Andrew Quach Huynh
h3. External links
69 5 Jean-Philippe Lang
70
HTTP URLs and email addresses are automatically turned into clickable links: 
71 47 Ian Epperson
* *http&#58;//www.redmine.org* -- External link to the redmine website: http://www.redmine.org
72
* *someone&#64;foo.bar* -- Link to an email address: someone@foo.bar
73 5 Jean-Philippe Lang
74 51 Graham King
HTTP URLs and email addresses can also use different text than the link itself:
75 47 Ian Epperson
* *"Redmine web site"&#58;http&#58;//www.redmine.org* -- External link with different text: "Redmine web site":http://www.redmine.org
76 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: 
77
78
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org
79
80 47 Ian Epperson
* *"Email someone"&#58;mailto&#58;someone&#64;foo.bar* -- Email link with different text: "Email someone":mailto:someone@foo.bar
81 1 Jean-Philippe Lang
82 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.
83
* *"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
84
* *"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
85
* *"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
86
87 1 Jean-Philippe Lang
h2. Text formatting
88 10 John Goerzen
89 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.
90 1 Jean-Philippe Lang
91 38 ha thach
h3. Acronym
92
93
<pre>
94
JPL(Jean-Philippe Lang)
95
</pre>
96
97
Display:
98
99
JPL(Jean-Philippe Lang)
100
101 1 Jean-Philippe Lang
h3. Font style
102
103
<pre><code>* *bold*
104
* _italic_
105 19 Pavel Schichko
* *_bold italic_*
106 1 Jean-Philippe Lang
* +underline+
107
* -strike-through-
108 45 Ian Epperson
* Plain ^superscript^
109
* Plain ~subscript~
110 63 Colin Sullivan
* @inline monospace@
111 1 Jean-Philippe Lang
</code></pre>
112
113
Display:
114
115
 * *bold*
116
 * _italic_
117 19 Pavel Schichko
 * *_bold italic_*
118 1 Jean-Philippe Lang
 * +underline+
119
 * -strike-through-
120 45 Ian Epperson
 * Plain ^superscript^
121
 * Plain ~subscript~
122 63 Colin Sullivan
 * @inline monospace@
123 1 Jean-Philippe Lang
124
h3. Inline images
125 9 Jean-Philippe Lang
126 1 Jean-Philippe Lang
* *&#33;image_url&#33;* displays an image located at image_url (textile syntax)
127
* *&#33;>image_url&#33;* right floating image
128 66 Jean-Philippe Lang
* *&#33;image_url(Image title)&#33;* displays an image with an alt/title attribute
129 73 Dieter Egert
* *&#33;image_url&#33;:URL* displays an image located at image_url with link URL added
130 18 samir djouadi
131 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;*
132 1 Jean-Philippe Lang
133
h3. Headings
134
135
<pre><code>h1. Heading
136 66 Jean-Philippe Lang
137 1 Jean-Philippe Lang
h2. Subheading
138 66 Jean-Philippe Lang
139 1 Jean-Philippe Lang
h3. Subheading
140
</code></pre>
141
142
h3. Paragraphs
143
144 58 Dieter Egert
<pre><code>p. left aligned
145
146 60 Dieter Egert
  p(. left ident 1em
147 58 Dieter Egert
148 60 Dieter Egert
    p((. left ident 2em
149
    as well as for following lines
150 58 Dieter Egert
151 60 Dieter Egert
                                                                                   p>. right aligned
152 58 Dieter Egert
153 60 Dieter Egert
                                                                        p)))>. right ident 3em
154 58 Dieter Egert
155 60 Dieter Egert
                           p=. This is centered paragraph.
156 1 Jean-Philippe Lang
</code></pre>
157
158
h3. Predefined
159
160
To escape wiki syntax
161 58 Dieter Egert
<pre> <pre> *Your text won't become bold* </pre> </pre>
162 36 ha thach
Display:
163 37 ha thach
164 1 Jean-Philippe Lang
<pre> *Your text won't become bold* </pre>
165 38 ha thach
166
h3. Blockquotes
167 37 ha thach
168 60 Dieter Egert
Start the paragraph with *bq.*  or > (also stacked: >>)
169 1 Jean-Philippe Lang
170
<pre><code>bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
171
To go live, all you need to add is a database and a web server.
172
</code></pre>
173
174
Display:
175
176
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
177
To go live, all you need to add is a database and a web server.
178
179 60 Dieter Egert
>> 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. (starting with >>)
181
182 28 Jean-Philippe Lang
h3. Unordered lists
183
184
<pre>
185
* Item 1
186
* Item 2
187 29 Eric Gallimore
** Item 21
188
** Item 22
189 28 Jean-Philippe Lang
* Item 3
190
</pre>
191
192
displays:
193 1 Jean-Philippe Lang
194 28 Jean-Philippe Lang
* Item 1
195
* Item 2
196 29 Eric Gallimore
** Item 21
197 28 Jean-Philippe Lang
** Item 22
198
* Item 3
199 1 Jean-Philippe Lang
200
h3. Ordered lists
201
202 28 Jean-Philippe Lang
<pre>
203
# Item 1
204
# Item 2
205
# Item 3
206
## Item 3.1
207
## Item 3.2
208 1 Jean-Philippe Lang
</pre>
209 29 Eric Gallimore
210
displays:
211 1 Jean-Philippe Lang
212 20 Kirill Ponomarev
# Item 1
213
# Item 2
214
# Item 3
215 21 Andrew Chaika
## Item 3.1
216
## Item 3.2
217
218 1 Jean-Philippe Lang
h3. Tables
219
220
<pre>
221 71 Dieter Egert
|_.UserID     |_.Name|_.Group|_. attribute list  |
222 72 Dieter Egert
|Starting with| a    |   simple|row |
223 60 Dieter Egert
|\3=.IT               |<. align left|
224
|1|Artur Pirozhkov |/2.Users |>. align right|
225
|2|Vasya Rogov        |=. center |
226 58 Dieter Egert
|3|John Smith |Admin
227
               (root)|^. valign top |
228
|4|-          |Nobody
229
               (anonymous)|~. valign bottom|
230 20 Kirill Ponomarev
</pre>
231 21 Andrew Chaika
232 1 Jean-Philippe Lang
displays (all multiple spaces are replaced by 1 space):
233
234 71 Dieter Egert
|_.UserID     |_.Name|_.Group|_. attribute list   |
235 72 Dieter Egert
|Starting with| a    |   simple|row |
236 60 Dieter Egert
|\3=.IT                |<. align left|
237
|1|Artur Pirozhkov |/2.Users |>. align right|
238
|2|Vasya Rogov         |=. center |
239 58 Dieter Egert
|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
h2. Translation
284 1 Jean-Philippe Lang
285 75 Caille Rotie
Note that the following translations may not be up to date. Please refer to the original english documentation if needed.
286 52 Vladimir Vasilkin
287 75 Caille Rotie
* [[RusRedmineTextFormatting|Перевод на русский]]
288
* [[FrRedmineWikiFormatting|French]]