RedmineTextFormattingTextile » History » Version 13
Andrea Ludin, 2022-01-11 09:46
1 | 1 | Hans Ginzel | h1. Textile formatting |
---|---|---|---|
2 | 1 | Hans Ginzel | |
3 | 3 | Hiroo Hayashi | Below is *Textile* formatting. For *Markdown* formatting see [[RedmineTextFormattingMarkdown]]. |
4 | 3 | Hiroo Hayashi | For limitations of current Textile support see #6269, #10078 (Definition Lists). |
5 | 1 | Hans Ginzel | |
6 | 1 | Hans Ginzel | {{>TOC}} |
7 | 1 | Hans Ginzel | |
8 | 1 | Hans Ginzel | h2. Links |
9 | 1 | Hans Ginzel | |
10 | 1 | Hans Ginzel | h3. Redmine links |
11 | 1 | Hans Ginzel | |
12 | 4 | Hiroo Hayashi | {{include(RedmineTextFormattingRedmineLinks)}} |
13 | 1 | Hans Ginzel | |
14 | 1 | Hans Ginzel | h3. External links |
15 | 1 | Hans Ginzel | |
16 | 7 | Go MAEDA | URLs (http, https, ftp and ftps) are automatically turned into clickable links: |
17 | 1 | Hans Ginzel | * *http://www.redmine.org* -- External link to the redmine website: http://www.redmine.org |
18 | 1 | Hans Ginzel | |
19 | 7 | Go MAEDA | URLs can also use different text than the link itself: |
20 | 1 | Hans Ginzel | * *"Redmine web site":http://www.redmine.org* -- External link with different text: "Redmine web site":http://www.redmine.org |
21 | 1 | Hans Ginzel | * *!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: |
22 | 1 | Hans Ginzel | |
23 | 1 | Hans Ginzel | p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org |
24 | 1 | Hans Ginzel | |
25 | 6 | Seung Soo Mun | File URI can be used to link UNC path: |
26 | 6 | Seung Soo Mun | * *"\\server\share$":file://///server/share%24* -- File URI showing UNC path: "\\server\share$":file://///server/share%24 |
27 | 6 | Seung Soo Mun | You should "URL Encodings":http://www.w3schools.com/tags/ref_urlencode.asp for special characters like empty space, $, á, é, í, ó, ú, etc. |
28 | 6 | Seung Soo Mun | |
29 | 1 | Hans Ginzel | h3. Email addresses |
30 | 1 | Hans Ginzel | |
31 | 1 | Hans Ginzel | Email addresses are automatically turned into clickable links: |
32 | 1 | Hans Ginzel | |
33 | 3 | Hiroo Hayashi | * *someone@foo.bar* -- Link to an email address: someone@foo.bar |
34 | 1 | Hans Ginzel | * *"Email someone":mailto:someone@foo.bar* -- Email link with different text: "Email someone":mailto:someone@foo.bar |
35 | 1 | Hans Ginzel | |
36 | 1 | Hans Ginzel | 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. |
37 | 1 | Hans Ginzel | * *"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar* -- Email to webmaster, CC admin: "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar |
38 | 1 | Hans Ginzel | * *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help* -- Email link with the subject "Website Help": "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help |
39 | 10 | Charles Sun | * *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20* -- Email link with the subject "Website Help" and a default body: "My problem is ":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20 |
40 | 1 | Hans Ginzel | |
41 | 1 | Hans Ginzel | h2. Text formatting |
42 | 1 | Hans Ginzel | |
43 | 1 | Hans Ginzel | 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. |
44 | 1 | Hans Ginzel | |
45 | 1 | Hans Ginzel | h3. Acronym |
46 | 1 | Hans Ginzel | |
47 | 1 | Hans Ginzel | <pre> |
48 | 1 | Hans Ginzel | JPL(Jean-Philippe Lang) |
49 | 1 | Hans Ginzel | </pre> |
50 | 1 | Hans Ginzel | |
51 | 3 | Hiroo Hayashi | displays: |
52 | 1 | Hans Ginzel | |
53 | 1 | Hans Ginzel | JPL(Jean-Philippe Lang) |
54 | 1 | Hans Ginzel | |
55 | 1 | Hans Ginzel | h3. Font style |
56 | 1 | Hans Ginzel | |
57 | 1 | Hans Ginzel | <pre><code>* *bold* |
58 | 1 | Hans Ginzel | * _italic_ |
59 | 1 | Hans Ginzel | * *_bold italic_* |
60 | 1 | Hans Ginzel | * +underline+ |
61 | 1 | Hans Ginzel | * -strike-through- |
62 | 1 | Hans Ginzel | * Plain ^superscript^ |
63 | 1 | Hans Ginzel | * Plain ~subscript~ |
64 | 1 | Hans Ginzel | * @inline monospace@ |
65 | 1 | Hans Ginzel | * <notextile>normal *bold* _italic_ normal;E=mc ^2^</notextile> |
66 | 1 | Hans Ginzel | * <notextile>normal<notextile></notextile>*bold*<notextile></notextile>_italic_<notextile></notextile>normal;E=mc<notextile></notextile>^2^</notextile> |
67 | 1 | Hans Ginzel | * <notextile>Escaping: <notextile>*bold* _italic_ @inlinemono@</notextile> Alternative using HTML-codes: *bold* _italic_ @inlinemono@</notextile> |
68 | 1 | Hans Ginzel | * <notextile><pre>*some lines* some "link":http://www.redmine.org</pre></notextile> |
69 | 1 | Hans Ginzel | * <notextile><pre><notextile></notextile>*some lines* some "link":http://www.redmine.org</pre></notextile> |
70 | 1 | Hans Ginzel | </code></pre> |
71 | 1 | Hans Ginzel | |
72 | 3 | Hiroo Hayashi | displays: |
73 | 1 | Hans Ginzel | |
74 | 1 | Hans Ginzel | * *bold* |
75 | 1 | Hans Ginzel | * _italic_ |
76 | 1 | Hans Ginzel | * *_bold italic_* |
77 | 1 | Hans Ginzel | * +underline+ |
78 | 1 | Hans Ginzel | * -strike-through- |
79 | 1 | Hans Ginzel | * Plain ^superscript^ |
80 | 1 | Hans Ginzel | * Plain ~subscript~ |
81 | 1 | Hans Ginzel | * @inline monospace@ |
82 | 1 | Hans Ginzel | * normal *bold* _italic_ normal;E=mc ^2^ |
83 | 1 | Hans Ginzel | * normal<notextile></notextile>*bold*<notextile></notextile>_italic_<notextile></notextile>normal;E=mc<notextile></notextile>^2^ |
84 | 1 | Hans Ginzel | * Escaping: <notextile>*bold* _italic_ @inlinemono@</notextile> Alternative using HTML-codes: *bold* _italic_ @inlinemono@ |
85 | 1 | Hans Ginzel | * <pre>*some lines* some "link":http://www.redmine.org</pre> |
86 | 1 | Hans Ginzel | * <pre><notextile></notextile>*some lines* some "link":http://www.redmine.org</pre> |
87 | 1 | Hans Ginzel | |
88 | 3 | Hiroo Hayashi | h3. Color |
89 | 1 | Hans Ginzel | |
90 | 1 | Hans Ginzel | <pre><code><notextile>* %{color:red}red% %{color:green}green% %{color:yellow}yellow% %{color:#82B6E1}blue'ish% |
91 | 1 | Hans Ginzel | * %{color:red}red%<notextile></notextile>%{color:green}green%<notextile></notextile>%{color:yellow}yellow%<notextile></notextile>%{color:#82B6E1}blue'ish% |
92 | 1 | Hans Ginzel | * %{background:lightgreen}Lightgreen Background% %{background:yellow}Yellow Background% |
93 | 1 | Hans Ginzel | * %{background:lightgreen}Lightgreen Background%<notextile></notextile>%{background:yellow}Yellow Background% |
94 | 1 | Hans Ginzel | </notextile></code></pre> |
95 | 1 | Hans Ginzel | |
96 | 3 | Hiroo Hayashi | displays: |
97 | 1 | Hans Ginzel | |
98 | 1 | Hans Ginzel | * %{color:red}red% %{color:green}green% %{color:yellow}yellow% %{color:#82B6E1}blue'ish% |
99 | 1 | Hans Ginzel | * %{color:red}red%<notextile></notextile>%{color:green}green%<notextile></notextile>%{color:yellow}yellow%<notextile></notextile>%{color:#82B6E1}blue'ish% |
100 | 1 | Hans Ginzel | * %{background:lightgreen}Lightgreen Background% %{background:yellow}Yellow Background% |
101 | 1 | Hans Ginzel | * %{background:lightgreen}Lightgreen Background%<notextile></notextile>%{background:yellow}Yellow Background% |
102 | 1 | Hans Ginzel | |
103 | 1 | Hans Ginzel | h3. Inline images |
104 | 1 | Hans Ginzel | |
105 | 1 | Hans Ginzel | * *!image_url!* displays an image located at image_url (textile syntax) |
106 | 1 | Hans Ginzel | * *!>image_url!* right floating image |
107 | 1 | Hans Ginzel | * *!image_url(Image title)!* displays an image with an alt/title attribute |
108 | 1 | Hans Ginzel | * *!image_url!:URL* displays an image located at image_url with link URL added |
109 | 1 | Hans Ginzel | |
110 | 1 | Hans Ginzel | If you have an image attached to your wiki page, it can be displayed inline using its filename: *!attached_image.png!* |
111 | 1 | Hans Ginzel | |
112 | 1 | Hans Ginzel | You can also apply a CSS style to the image in the same ways as styling SPANs. The code *!{width: 100%}attached_image.png!* will make the image adjusts to the parent's width. |
113 | 1 | Hans Ginzel | |
114 | 1 | Hans Ginzel | h3. Headings |
115 | 1 | Hans Ginzel | |
116 | 1 | Hans Ginzel | <pre><code>h1. Heading |
117 | 1 | Hans Ginzel | |
118 | 1 | Hans Ginzel | h2. Subheading |
119 | 1 | Hans Ginzel | |
120 | 1 | Hans Ginzel | h3. Subheading |
121 | 1 | Hans Ginzel | </code></pre> |
122 | 1 | Hans Ginzel | |
123 | 1 | Hans Ginzel | Redmine assigns an anchor to each of those headings thus you can link to them with "#Heading", "#Subheading" and so forth. |
124 | 1 | Hans Ginzel | |
125 | 1 | Hans Ginzel | h3. Paragraphs |
126 | 1 | Hans Ginzel | |
127 | 1 | Hans Ginzel | <pre><code>p. left aligned |
128 | 1 | Hans Ginzel | |
129 | 5 | Hiroo Hayashi | p(. left ident 1em |
130 | 1 | Hans Ginzel | |
131 | 5 | Hiroo Hayashi | p((. left ident 2em |
132 | 5 | Hiroo Hayashi | as well as for following lines |
133 | 1 | Hans Ginzel | |
134 | 5 | Hiroo Hayashi | p>. right aligned |
135 | 1 | Hans Ginzel | |
136 | 5 | Hiroo Hayashi | p)))>. right ident 3em |
137 | 1 | Hans Ginzel | |
138 | 5 | Hiroo Hayashi | p=. This is centered paragraph. |
139 | 1 | Hans Ginzel | </code></pre> |
140 | 1 | Hans Ginzel | |
141 | 5 | Hiroo Hayashi | displays; |
142 | 5 | Hiroo Hayashi | |
143 | 5 | Hiroo Hayashi | p. left aligned |
144 | 5 | Hiroo Hayashi | |
145 | 5 | Hiroo Hayashi | p(. left ident 1em |
146 | 5 | Hiroo Hayashi | |
147 | 5 | Hiroo Hayashi | p((. left ident 2em |
148 | 5 | Hiroo Hayashi | as well as for following lines |
149 | 5 | Hiroo Hayashi | |
150 | 5 | Hiroo Hayashi | p>. right aligned |
151 | 5 | Hiroo Hayashi | |
152 | 5 | Hiroo Hayashi | p)))>. right ident 3em |
153 | 5 | Hiroo Hayashi | |
154 | 5 | Hiroo Hayashi | p=. This is centered paragraph. |
155 | 5 | Hiroo Hayashi | |
156 | 1 | Hans Ginzel | h3. Horizontal rule |
157 | 3 | Hiroo Hayashi | |
158 | 1 | Hans Ginzel | @----@ |
159 | 3 | Hiroo Hayashi | |
160 | 1 | Hans Ginzel | displays: |
161 | 1 | Hans Ginzel | |
162 | 1 | Hans Ginzel | ---- |
163 | 1 | Hans Ginzel | |
164 | 5 | Hiroo Hayashi | h3. Preformatted Text |
165 | 1 | Hans Ginzel | |
166 | 5 | Hiroo Hayashi | <pre> <pre>*Your text won't become bold*</pre> </pre> |
167 | 1 | Hans Ginzel | |
168 | 3 | Hiroo Hayashi | displays: |
169 | 3 | Hiroo Hayashi | |
170 | 1 | Hans Ginzel | <pre> *Your text won't become bold* </pre> |
171 | 1 | Hans Ginzel | |
172 | 1 | Hans Ginzel | h3. Blockquotes |
173 | 1 | Hans Ginzel | |
174 | 1 | Hans Ginzel | Start the paragraph with *bq.*: |
175 | 1 | Hans Ginzel | |
176 | 1 | Hans Ginzel | <pre><code>bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern. |
177 | 1 | Hans Ginzel | To go live, all you need to add is a database and a web server. |
178 | 1 | Hans Ginzel | </code></pre> |
179 | 1 | Hans Ginzel | |
180 | 3 | Hiroo Hayashi | displays: |
181 | 1 | Hans Ginzel | |
182 | 1 | Hans Ginzel | bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern. |
183 | 1 | Hans Ginzel | To go live, all you need to add is a database and a web server. |
184 | 1 | Hans Ginzel | |
185 | 1 | Hans Ginzel | You can also use > at the beginning of each line and stack them for nested quotes: |
186 | 1 | Hans Ginzel | |
187 | 1 | Hans Ginzel | <pre> |
188 | 1 | Hans Ginzel | >> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern. |
189 | 1 | Hans Ginzel | >> To go live, all you need to add is a database and a web server. |
190 | 1 | Hans Ginzel | > Great! |
191 | 1 | Hans Ginzel | </pre> |
192 | 1 | Hans Ginzel | |
193 | 3 | Hiroo Hayashi | displays: |
194 | 1 | Hans Ginzel | |
195 | 1 | Hans Ginzel | >> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern. |
196 | 1 | Hans Ginzel | >> To go live, all you need to add is a database and a web server. |
197 | 1 | Hans Ginzel | > Great! |
198 | 1 | Hans Ginzel | |
199 | 1 | Hans Ginzel | h3. Unordered lists |
200 | 1 | Hans Ginzel | |
201 | 1 | Hans Ginzel | <pre> |
202 | 1 | Hans Ginzel | * Item 1 |
203 | 1 | Hans Ginzel | * Item 2 |
204 | 1 | Hans Ginzel | ** Item 21 |
205 | 1 | Hans Ginzel | ** Item 22 |
206 | 1 | Hans Ginzel | * Item 3 |
207 | 1 | Hans Ginzel | </pre> |
208 | 1 | Hans Ginzel | |
209 | 1 | Hans Ginzel | displays: |
210 | 1 | Hans Ginzel | |
211 | 1 | Hans Ginzel | * Item 1 |
212 | 1 | Hans Ginzel | * Item 2 |
213 | 1 | Hans Ginzel | ** Item 21 |
214 | 1 | Hans Ginzel | ** Item 22 |
215 | 1 | Hans Ginzel | * Item 3 |
216 | 1 | Hans Ginzel | |
217 | 1 | Hans Ginzel | h3. Ordered lists |
218 | 1 | Hans Ginzel | |
219 | 1 | Hans Ginzel | <pre> |
220 | 1 | Hans Ginzel | # Item 1 |
221 | 1 | Hans Ginzel | # Item 2 |
222 | 1 | Hans Ginzel | # Item 3 |
223 | 1 | Hans Ginzel | ## Item 3.1 |
224 | 1 | Hans Ginzel | ## Item 3.2 |
225 | 1 | Hans Ginzel | </pre> |
226 | 1 | Hans Ginzel | |
227 | 1 | Hans Ginzel | displays: |
228 | 1 | Hans Ginzel | |
229 | 1 | Hans Ginzel | # Item 1 |
230 | 1 | Hans Ginzel | # Item 2 |
231 | 1 | Hans Ginzel | # Item 3 |
232 | 1 | Hans Ginzel | ## Item 3.1 |
233 | 1 | Hans Ginzel | ## Item 3.2 |
234 | 1 | Hans Ginzel | |
235 | 1 | Hans Ginzel | h3. Tables |
236 | 1 | Hans Ginzel | |
237 | 1 | Hans Ginzel | <pre> |
238 | 1 | Hans Ginzel | |_.UserID |_.Name |_.Group |_. attribute list | |
239 | 1 | Hans Ginzel | |Starting with | a | simple |row | |
240 | 1 | Hans Ginzel | |\3=.IT |<. align left | |
241 | 1 | Hans Ginzel | |1 |Artur Pirozhkov |/2.Users |>. align right | |
242 | 1 | Hans Ginzel | |2 |Vasya Rogov |=. center | |
243 | 1 | Hans Ginzel | |3 |John Smith |Admin |
244 | 1 | Hans Ginzel | (root) |^. valign top | |
245 | 1 | Hans Ginzel | |4 |- |Nobody |
246 | 1 | Hans Ginzel | (anonymous) |~. valign bottom | |
247 | 1 | Hans Ginzel | </pre> |
248 | 1 | Hans Ginzel | |
249 | 1 | Hans Ginzel | displays (all multiple spaces are replaced by 1 space): |
250 | 1 | Hans Ginzel | |
251 | 1 | Hans Ginzel | |_.UserID |_.Name |_.Group |_. attribute list | |
252 | 1 | Hans Ginzel | |Starting with | a | simple |row | |
253 | 1 | Hans Ginzel | |\3=.IT |<. align left | |
254 | 1 | Hans Ginzel | |1 |Artur Pirozhkov |/2.Users |>. align right | |
255 | 1 | Hans Ginzel | |2 |Vasya Rogov |=. center | |
256 | 1 | Hans Ginzel | |3 |John Smith |Admin |
257 | 1 | Hans Ginzel | (root) |^. valign top | |
258 | 1 | Hans Ginzel | |4 |- |Nobody |
259 | 1 | Hans Ginzel | (anonymous) |~. valign bottom | |
260 | 1 | Hans Ginzel | |
261 | 1 | Hans Ginzel | If you want to include pipe characters inside your table (e.g. for Wiki links), you need to prevent textile from interpreting them: |
262 | 1 | Hans Ginzel | |
263 | 1 | Hans Ginzel | |_.Input |_. Output| |
264 | 1 | Hans Ginzel | |*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>| |
265 | 1 | Hans Ginzel | |
266 | 8 | David Lukas Müller | If you want to specify the width of the table, you need to put *table{width:100%}.* just before your table definition: |
267 | 8 | David Lukas Müller | |
268 | 8 | David Lukas Müller | <pre> |
269 | 8 | David Lukas Müller | table{width:100%}. |
270 | 8 | David Lukas Müller | | This table will use |
271 | 8 | David Lukas Müller | all horizontal space | |
272 | 8 | David Lukas Müller | </pre> |
273 | 8 | David Lukas Müller | |
274 | 8 | David Lukas Müller | This way the table will extend to the whole page width ... |
275 | 8 | David Lukas Müller | |
276 | 8 | David Lukas Müller | table{width:100%}. |
277 | 8 | David Lukas Müller | | This table will use |
278 | 8 | David Lukas Müller | all horizontal space | |
279 | 8 | David Lukas Müller | |
280 | 8 | David Lukas Müller | ... compared with the standard width: |
281 | 8 | David Lukas Müller | |
282 | 8 | David Lukas Müller | | This table will use |
283 | 8 | David Lukas Müller | only the required space | |
284 | 8 | David Lukas Müller | |
285 | 1 | Hans Ginzel | h3. Table of content |
286 | 1 | Hans Ginzel | |
287 | 1 | Hans Ginzel | <pre><code>{{toc}} => left aligned toc |
288 | 1 | Hans Ginzel | {{>toc}} => right aligned toc |
289 | 1 | Hans Ginzel | </code></pre> |
290 | 1 | Hans Ginzel | |
291 | 1 | Hans Ginzel | Please keep in mind, that the toc-tag needs an empty line above and underneath it and no other text before and after it. |
292 | 1 | Hans Ginzel | |
293 | 1 | Hans Ginzel | Example: |
294 | 1 | Hans Ginzel | |
295 | 1 | Hans Ginzel | <pre><code> |
296 | 1 | Hans Ginzel | h1. headLineOne |
297 | 1 | Hans Ginzel | |
298 | 1 | Hans Ginzel | h2. something |
299 | 1 | Hans Ginzel | |
300 | 1 | Hans Ginzel | {{toc}} |
301 | 1 | Hans Ginzel | |
302 | 1 | Hans Ginzel | h2. something more |
303 | 1 | Hans Ginzel | </code></pre> |
304 | 13 | Andrea Ludin | |
305 | 13 | Andrea Ludin | |
306 | 13 | Andrea Ludin | h3. Footnotes |
307 | 13 | Andrea Ludin | |
308 | 13 | Andrea Ludin | Marker: |
309 | 13 | Andrea Ludin | |
310 | 13 | Andrea Ludin | <pre> |
311 | 13 | Andrea Ludin | This is a first word[1] with a footnote. |
312 | 13 | Andrea Ludin | |
313 | 13 | Andrea Ludin | This is a second word[2] with a footnote. |
314 | 13 | Andrea Ludin | </pre> |
315 | 13 | Andrea Ludin | |
316 | 13 | Andrea Ludin | *Note:* Marker directly attached to word (no space, no dot or any thing else in between). |
317 | 13 | Andrea Ludin | |
318 | 13 | Andrea Ludin | |
319 | 13 | Andrea Ludin | Definition: |
320 | 13 | Andrea Ludin | |
321 | 13 | Andrea Ludin | <pre> |
322 | 13 | Andrea Ludin | fn1^. Footnote for the first word |
323 | 13 | Andrea Ludin | |
324 | 13 | Andrea Ludin | fn2^. Footnote for second first word |
325 | 13 | Andrea Ludin | </pre> |
326 | 13 | Andrea Ludin | |
327 | 13 | Andrea Ludin | *Note:* Each definition on its own line anywhere within the document. Empty lines between definitions. |
328 | 13 | Andrea Ludin | |
329 | 13 | Andrea Ludin | displays: |
330 | 13 | Andrea Ludin | |
331 | 13 | Andrea Ludin | This is a first word[1] with a footnote. |
332 | 13 | Andrea Ludin | |
333 | 13 | Andrea Ludin | This is a second word[2] with a footnote. |
334 | 13 | Andrea Ludin | |
335 | 13 | Andrea Ludin | fn1^. Footnote for the first word |
336 | 13 | Andrea Ludin | |
337 | 13 | Andrea Ludin | fn2^. Footnote for second first word |
338 | 1 | Hans Ginzel | |
339 | 1 | Hans Ginzel | h2. Macros |
340 | 1 | Hans Ginzel | |
341 | 1 | Hans Ginzel | 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 also includes a few builtin macros: |
342 | 1 | Hans Ginzel | |
343 | 1 | Hans Ginzel | {{macro_list}} |
344 | 1 | Hans Ginzel | |
345 | 1 | Hans Ginzel | h2. Code highlighting |
346 | 1 | Hans Ginzel | |
347 | 11 | Go MAEDA | Default code highlightment relies on "Rouge":http://rouge.jneen.net/, a syntax highlighting library written in pure Ruby. It supports many commonly used languages such as *c*, *cpp* (c++), *csharp* (c#, cs), *css*, *diff* (patch, udiff), *go* (golang), *groovy*, *html*, *java*, *javascript* (js), *kotlin*, *objective_c* (objc), *perl* (pl), *php*, *python* (py), *r*, *ruby* (rb), *sass*, *scala*, *shell* (bash, zsh, ksh, sh), *sql*, *swift*, *xml* and *yaml* (yml) languages, where the names inside parentheses are aliases. Please refer to [[RedmineCodeHighlightingLanguages]] for the full list of supported languages. |
348 | 1 | Hans Ginzel | |
349 | 1 | Hans Ginzel | You can highlight code in your wiki page using this syntax: |
350 | 1 | Hans Ginzel | |
351 | 1 | Hans Ginzel | <pre><code><pre><code class="ruby"> |
352 | 1 | Hans Ginzel | Place your code here. |
353 | 1 | Hans Ginzel | </code></pre> |
354 | 1 | Hans Ginzel | </code></pre> |
355 | 1 | Hans Ginzel | |
356 | 1 | Hans Ginzel | Example: |
357 | 1 | Hans Ginzel | |
358 | 1 | Hans Ginzel | <pre><code class="ruby"> |
359 | 1 | Hans Ginzel | # The Greeter class |
360 | 1 | Hans Ginzel | class Greeter |
361 | 1 | Hans Ginzel | def initialize(name) |
362 | 1 | Hans Ginzel | @name = name.capitalize |
363 | 1 | Hans Ginzel | end |
364 | 1 | Hans Ginzel | |
365 | 1 | Hans Ginzel | def salute |
366 | 1 | Hans Ginzel | puts "Hello #{@name}!" |
367 | 1 | Hans Ginzel | end |
368 | 1 | Hans Ginzel | end |
369 | 1 | Hans Ginzel | </code></pre> |
370 | 1 | Hans Ginzel | |
371 | 9 | Go MAEDA | h2. Styling text using CSS |
372 | 9 | Go MAEDA | |
373 | 9 | Go MAEDA | Textile can style text using CSS. Examples as follows: |
374 | 9 | Go MAEDA | |
375 | 9 | Go MAEDA | <pre> |
376 | 9 | Go MAEDA | Three primary colors of light are %{color: #f00}red%, %{color: #0f0}green% and %{color: #00f}blue%. |
377 | 9 | Go MAEDA | |
378 | 9 | Go MAEDA | p{border: solid 1px #000; padding: 0.5em;}. The quick brown fox jumps over the lazy dog. |
379 | 9 | Go MAEDA | |
380 | 9 | Go MAEDA | table{width: 100%}. |
381 | 9 | Go MAEDA | |={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 | |
382 | 9 | Go MAEDA | </pre> |
383 | 9 | Go MAEDA | |
384 | 9 | Go MAEDA | displays: |
385 | 9 | Go MAEDA | |
386 | 9 | Go MAEDA | Three primary colors of light are %{color: #f00}red%, %{color: #0f0}green% and %{color: #00f}blue%. |
387 | 9 | Go MAEDA | |
388 | 9 | Go MAEDA | p{border: solid 1px #000; padding: 0.5em;}. The quick brown fox jumps over the lazy dog. |
389 | 9 | Go MAEDA | |
390 | 9 | Go MAEDA | table{width: 100%}. |
391 | 9 | Go MAEDA | |={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 | |
392 | 9 | Go MAEDA | |
393 | 9 | Go MAEDA | h3. Allowed CSS properties |
394 | 9 | Go MAEDA | |
395 | 9 | Go MAEDA | Redmine allows the following properties. Other properties are not allowed for security reasons (see r2192). |
396 | 9 | Go MAEDA | |
397 | 9 | Go MAEDA | * background |
398 | 9 | Go MAEDA | * background-* |
399 | 9 | Go MAEDA | * border |
400 | 9 | Go MAEDA | * border-* |
401 | 9 | Go MAEDA | * color |
402 | 9 | Go MAEDA | * float |
403 | 9 | Go MAEDA | * font |
404 | 9 | Go MAEDA | * font-* |
405 | 9 | Go MAEDA | * height |
406 | 9 | Go MAEDA | * margin |
407 | 9 | Go MAEDA | * margin-* |
408 | 9 | Go MAEDA | * max-height |
409 | 9 | Go MAEDA | * max-width |
410 | 9 | Go MAEDA | * min-height |
411 | 9 | Go MAEDA | * min-width |
412 | 9 | Go MAEDA | * padding |
413 | 9 | Go MAEDA | * padding-* |
414 | 9 | Go MAEDA | * text |
415 | 9 | Go MAEDA | * text-* |
416 | 9 | Go MAEDA | * width |
417 | 9 | Go MAEDA | |
418 | 1 | Hans Ginzel | h2. Translation |
419 | 1 | Hans Ginzel | |
420 | 1 | Hans Ginzel | Note that the following translations may not be up to date. Please refer to the original english documentation if needed. |
421 | 1 | Hans Ginzel | |
422 | 1 | Hans Ginzel | * [[BrRedmineWikiFormatting|Português Brasileiro]] |
423 | 1 | Hans Ginzel | * [[RusRedmineTextFormatting|Русский]] |
424 | 1 | Hans Ginzel | * [[FrRedmineWikiFormatting|French]] |
425 | 1 | Hans Ginzel | * [[KoreanWikiFormatting|Korean]] |
426 | 1 | Hans Ginzel | * [[TurkishWikiFormatting|Türkçe]] |
427 | 1 | Hans Ginzel | * [[TraditionalChineseWikiFormatting|繁體中文]] |
428 | 1 | Hans Ginzel | * [[SimplifiedChineseWikiFormatting|简体中文]] |