Project

General

Profile

RusRedmineTextFormatting » History » Version 25

Lucy Yevseyeva, 2014-06-21 16:43

1 5 Lucy Yevseyeva
p(breadcrumb). [[RusGuide|Руководство]] » [[RusUser_Guide|Руководство пользователя]]
2
3 7 Lucy Yevseyeva
Оригинал: [[RedmineTextFormatting|Wiki formatting v.101]] - дополнено и переработано.
4 4 Lucy Yevseyeva
5 3 Lucy Yevseyeva
h1. Оформление текстов
6 1 Ruslan Khasanov
7 3 Lucy Yevseyeva
{{>TOC}}
8 1 Ruslan Khasanov
9 3 Lucy Yevseyeva
Для таких вещей как заголовки, выделение текста, таблицы, списки и т.п. Redmine поддерживает[1] парсер "Textile":http://textile.thresholdstate.com.
10 1 Ruslan Khasanov
11 25 Lucy Yevseyeva
fn1. Синтаксис Textile поддерживается в Redmine не полностью. В частности, не преобразуются спецсимволы, например, (с) в ©, -- в — и т.п. Также не поддерживается управление css-стилями.
12 24 Lucy Yevseyeva
13
p.  
14
15 3 Lucy Yevseyeva
h2. Строчные элементы
16 1 Ruslan Khasanov
17 3 Lucy Yevseyeva
h3. Внешние ссылки
18 1 Ruslan Khasanov
19 3 Lucy Yevseyeva
Адреса http(s), ftp и mail автоматически преобразуются в "кликабельные" ссылки:
20 1 Ruslan Khasanov
21 3 Lucy Yevseyeva
p(. *http://www.redmine.org*:  http://www.redmine.org
22 1 Ruslan Khasanov
23 3 Lucy Yevseyeva
Для размещения в ссылке произвольного текста используйте следующую разметку:
24 1 Ruslan Khasanov
25
p(. *"Главная страница проекта Redmine":http://www.redmine.org*: "Главная страница проекта Redmine":http://www.redmine.org.
26
27 7 Lucy Yevseyeva
h3. E-mail ссылки
28
29
p(. *someone@foo.bar*: someone@foo.bar.
30
31
В ссылке на e-mail адрес можно указать тему, текст письма и адреса для отправки копий.
32
33
p(. *"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar*: "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar -- указание адреса для отправки копии.
34
35
p(. *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help*: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help -- указание темы письма.
36
37
p(. *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20*: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20 -- указание текста письма.
38
39
p(. _*Важно_:* вместо пробелов в ссылку следует вставлять код %20.
40 8 Lucy Yevseyeva
41 3 Lucy Yevseyeva
h3. Акронимы
42 1 Ruslan Khasanov
43 3 Lucy Yevseyeva
Ненавязчиво пояснить аббревиатуры в тексте можно следующим образом[2]:
44 1 Ruslan Khasanov
45 3 Lucy Yevseyeva
p(. *JPL(Jean-Philippe Lang)*: JPL(Jean-Philippe Lang).
46 1 Ruslan Khasanov
47 3 Lucy Yevseyeva
h3. Стили шрифтов
48 1 Ruslan Khasanov
49 3 Lucy Yevseyeva
p(. *_italic_*: _курсив_
50 1 Ruslan Khasanov
51 3 Lucy Yevseyeva
p(. **_bold italic_**: *_жирный курсив_*
52 1 Ruslan Khasanov
53 3 Lucy Yevseyeva
p(. *+underline+*: +подчеркнутый+
54 1 Ruslan Khasanov
55 3 Lucy Yevseyeva
p(. *-strike-through-*: -перечеркнутый-
56 1 Ruslan Khasanov
57 3 Lucy Yevseyeva
p(. *Plain ^superscript^*: ^Верхний^ индекс
58 1 Ruslan Khasanov
59 3 Lucy Yevseyeva
p(. *Plain ~subscript~*: ~Нижний~ индекс
60 1 Ruslan Khasanov
61 3 Lucy Yevseyeva
p(. *inline @monospace@*: @моноширинный@ шрифт
62 1 Ruslan Khasanov
63 3 Lucy Yevseyeva
p(. *??cite??*: ??цитата??
64 1 Ruslan Khasanov
65 3 Lucy Yevseyeva
h3. Изображения
66 1 Ruslan Khasanov
67 11 Lucy Yevseyeva
+Внешние:+
68 1 Ruslan Khasanov
69 10 Lucy Yevseyeva
p(. *!image_url!* — встраивает в текст изображение, находящееся по внешнему адресу image_url.
70 1 Ruslan Khasanov
71 10 Lucy Yevseyeva
p(. *!image_url(Image title)!* — изображение будет снабжено заголовком.
72 1 Ruslan Khasanov
73 11 Lucy Yevseyeva
* встроенное изображение, причем текст будет продолжен после изображения !i0003.gif(Индеец)! вот так, а при наведении курсора на изображение появится текст. Этот текст также появится,если изображение по какой-либо причине недоступно — !i0004.gif(Индеец)! (отображение зависит от браузера)
74
75 1 Ruslan Khasanov
p(. *!>image_url!* — изображение выровнено по правому краю, текст обтекает изображение по левому краю.
76
77 11 Lucy Yevseyeva
* изображение отображается справа от текста !>i0003.gif!
78 1 Ruslan Khasanov
пример изображения справа от текста
79
опять справа от текста
80
еще справа от текста
81
и тут картинка справа от текста
82
а тут текст слева от картинки
83 11 Lucy Yevseyeva
84
+Прикрепленные:+
85
86
p(. *!attached_image.png!* — встраивает в текст изображение attached_image.png, прикрепленное к странице.
87
88
p(. *!{width:50%}attached_image.png!* — задаёт ширину изображения относительно блока, в который его встроили
89
90
* !{width:50%}http://www.redmine.org/screenshots/scm_diff.png!
91
92
*_Важно:_* ссылки на прикрепленные изображения действуют только на той странице, к которой они прикреплены.
93 1 Ruslan Khasanov
94 3 Lucy Yevseyeva
h2. Блочные элементы
95 1 Ruslan Khasanov
96 3 Lucy Yevseyeva
Для корректной обработки textile-разметки рекомендуется помещать блочные элементы (p, h, bq, fn) в самое начало строки и отделять их от остального текста пустыми строками.
97 1 Ruslan Khasanov
98 3 Lucy Yevseyeva
h3. Заголовки
99 1 Ruslan Khasanov
100 3 Lucy Yevseyeva
p(. *hn.* Заголовок n-ного уровня, где _n_ принимает значение от 1 до 6.
101 1 Ruslan Khasanov
102 13 Lucy Yevseyeva
<pre>
103
h1. Заголовок 1
104
105 25 Lucy Yevseyeva
h2=. Заголовок 2 // = выравнивание по центру
106 13 Lucy Yevseyeva
107 25 Lucy Yevseyeva
h3>. Заголовок 3 // > выравнивание по правому краю
108 13 Lucy Yevseyeva
</pre>
109
110 14 Lucy Yevseyeva
Заголовки снабжаются якорями, на которые можно будет давать ссылки (см. раздел [[RusRedmineTextFormatting#Wiki-страницы|Wiki-страницы]]).
111
112 15 Lucy Yevseyeva
Расставленные в тексте заголовки формируют блок "содержания" страницы, который можно встроить на страницу с помощью специального [[RusRedmineTextFormatting#Содержание|макроса]].
113 13 Lucy Yevseyeva
114 3 Lucy Yevseyeva
h3. Абзацы
115 1 Ruslan Khasanov
116 3 Lucy Yevseyeva
p. *p.* Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
117 1 Ruslan Khasanov
118 3 Lucy Yevseyeva
p(. *p(.* Отступ слева в 1em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
119 1 Ruslan Khasanov
120 3 Lucy Yevseyeva
p((. *p((.* Отступ слева в 2em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
121
Отступ сохраняется для всех следующих без пробела строк.
122 1 Ruslan Khasanov
123 3 Lucy Yevseyeva
p>. *p>.* Выравнивание по правому краю. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
124 1 Ruslan Khasanov
125 3 Lucy Yevseyeva
p<. *p<.* Выравнивание по левому краю (по умолчанию).
126 1 Ruslan Khasanov
127 3 Lucy Yevseyeva
p)))>. *p)))>.* Выравнивание по правому краю с отступом справа в 3em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
128
_Выравнивание и отступ также сохраняется для всего следующего через перенос строки (@<br>@)
129
 текста._
130 1 Ruslan Khasanov
131 3 Lucy Yevseyeva
_Выравнивание сбрасывается с введением пустой строки между выровненным блочным элементом и остальным текстом._
132 1 Ruslan Khasanov
133 3 Lucy Yevseyeva
p=. *p=.* Выравнивание по центру. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
134 1 Ruslan Khasanov
135 3 Lucy Yevseyeva
p<>. *p<>.* Выравнивание по левому и правому краю. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
136 1 Ruslan Khasanov
137 16 Lucy Yevseyeva
h3. Горизонтальный разделитель
138
139
<pre>
140
---
141
142 17 Lucy Yevseyeva
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor 
143
incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud
144
 exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute 
145
irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla 
146
pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia
147
 deserunt mollit anim id est laborum.
148 16 Lucy Yevseyeva
149
---
150
</pre>
151
152
---
153
154
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
155
156
---
157
158 3 Lucy Yevseyeva
h3. Pre-форматирование
159 1 Ruslan Khasanov
160 3 Lucy Yevseyeva
> Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].
161 1 Ruslan Khasanov
162 3 Lucy Yevseyeva
Чтобы избежать преобразования textile-разметки в html-код используйте тэги @&#60;pre>&#60;/pre>@.
163 1 Ruslan Khasanov
164 3 Lucy Yevseyeva
<pre><pre>Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].</pre></pre>
165 1 Ruslan Khasanov
166
h3. Цитаты
167
168 18 Lucy Yevseyeva
<pre>
169
> "Ruby on Rails" — программный каркас, написанный на языке программирования 
170
Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller 
171
(модель-представление-контроллер) для веб-приложений, а также обеспечивает их 
172
интеграцию с веб-сервером и сервером базы данных.
173
</pre>
174
175
> "Ruby on Rails" — программный каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller (модель-представление-контроллер) для веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером базы данных.
176 1 Ruslan Khasanov
 или
177
178 18 Lucy Yevseyeva
<pre>
179
bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails "Ruby on Rails" — программный 
180
каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет 
181
архитектурный образец Model-View-Controller (модель-представление-контроллер) для
182
 веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером 
183
базы данных.
184
</pre>
185 1 Ruslan Khasanov
186 18 Lucy Yevseyeva
bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails "Ruby on Rails" — программный каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller (модель-представление-контроллер) для веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером базы данных.
187
188
<pre>
189 19 Lucy Yevseyeva
>> Вдруг кому пригодится.
190
> Синтаксис textile-ссылки @:http://ru.wikipedia.org/wiki/Ruby_on_Rails@ 
191
преобразуется в html-атрибут @cite="http://ru.wikipedia.org/wiki/Ruby_on_Rails"@.
192 18 Lucy Yevseyeva
</pre>
193
194 19 Lucy Yevseyeva
>> Вдруг кому пригодится.
195
> Синтаксис textile-ссылки @:http://ru.wikipedia.org/wiki/Ruby_on_Rails@ преобразуется в html-атрибут @cite="http://ru.wikipedia.org/wiki/Ruby_on_Rails"@.
196 1 Ruslan Khasanov
197 3 Lucy Yevseyeva
h3. Списки
198 1 Ruslan Khasanov
199 3 Lucy Yevseyeva
Разметка для ненумерованного списка
200
<pre>* Item 1
201
* Item 2
202
** Item 2.1
203
204
 ** Item 2.1.1
205
*** Item 2.1.2
206
** Item 2.2
207
* Item 3
208
209 1 Ruslan Khasanov
** Item 0
210 3 Lucy Yevseyeva
</pre>
211 1 Ruslan Khasanov
отображается как:
212 20 Lucy Yevseyeva
213 3 Lucy Yevseyeva
* Item 1
214
* Item 2
215
** Item 2.1
216 1 Ruslan Khasanov
217 3 Lucy Yevseyeva
 ** Item 2.1.1
218
*** Item 2.1.2
219
** Item 2.2
220
* Item 3
221 1 Ruslan Khasanov
222 3 Lucy Yevseyeva
** Item 0
223 1 Ruslan Khasanov
224 3 Lucy Yevseyeva
Разметка для нумерованного списка
225
<pre># Item 1
226
# Item 2
227 1 Ruslan Khasanov
228 3 Lucy Yevseyeva
 ## Item 2.1
229
230
  ## Item 2.1.1
231
## Item 2.2
232
# Item 3
233
234 1 Ruslan Khasanov
# Item 0
235 3 Lucy Yevseyeva
</pre>
236 1 Ruslan Khasanov
отображается как:
237 20 Lucy Yevseyeva
238 3 Lucy Yevseyeva
# Item 1
239
# Item 2
240 1 Ruslan Khasanov
241 3 Lucy Yevseyeva
 ## Item 2.1
242 1 Ruslan Khasanov
243 3 Lucy Yevseyeva
  ## Item 2.1.1
244
## Item 2.2
245 1 Ruslan Khasanov
# Item 3
246
247
# Item 0
248 20 Lucy Yevseyeva
249
Под элемент списка можно встроить текст, не нарушив нумерации, если поместить его через перенос строки и пробел:
250
251
<pre>* Item 1
252
 some text
253
 some text
254
* Item 2
255
 some text
256
** Item 2.1
257
 some text
258
* Item 3
259
</pre>
260
261
# Item 1
262
 some text
263
 some text
264
# Item 2
265
 some text
266
## Item 2.1
267
 some text
268
# Item 3
269
 some text
270 3 Lucy Yevseyeva
271 1 Ruslan Khasanov
h3. Таблицы
272
273 3 Lucy Yevseyeva
Любое количество пустых символов будет заменено одним пробелом, поэтому для удобства разметки можно использовать текстовый редактор и табуляцию.
274
275 1 Ruslan Khasanov
<pre>
276 3 Lucy Yevseyeva
|_.UserID|_.Name|_.Group|_. attribute list |
277
|\3=.IT               |<. align left|
278
|1|Artur Pirozhkov |/2.Users |>. align right|
279
|2|Vasya Rogov        |=. center |
280
|3|John Smith |Admin
281
               (root)|^. valign top |
282
|4|-          |Nobody
283
               (anonymous)|~. valign bottom|
284
285 1 Ruslan Khasanov
</pre>
286
287 3 Lucy Yevseyeva
Отображается как:
288
|_.UserID|_.Name|_.Group|_. attribute list |
289
|\3=.IT               |<. align left|
290
|1|Artur Pirozhkov |/2.Users |>. align right|
291
|2|Vasya Rogov        |=. center |
292
|3|John Smith |Admin[3]
293
(root)|^. valign top |
294
|4|-          |Nobody
295
               (anonymous)|~. valign bottom|
296 1 Ruslan Khasanov
297 21 Lucy Yevseyeva
Чтобы парсер не обрабатывал символ | как разметку таблицы, символ следует поместить в экранирующие тэги:
298
|_.Input |_. Output|
299
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
300
301 3 Lucy Yevseyeva
h3. Сноски
302 1 Ruslan Khasanov
303 3 Lucy Yevseyeva
Сноска:
304
305
fn21. *fn21.* Поясняющий текст.
306
307
Ссылка на сноску[4]:
308
309
p(. *Поясняемый текст&#91;21]*: Поясняемый текст[21]
310
311
h2. Атрибуты
312
313
h3. Идентификаторы
314
315
p(. *p(#id).* -- присваивает абзацу идентификатор id.
316
317
Пример: 
318
319
p((#id). Данный абзац имеет идентификатор id, что может быть использовано, например, для создания [[RedmineTextFormattingRus#id|ссылки]] на него.
320
321
h3. Классы css
322
323
p(. *p(class).* -- присваивает абзацу класс class.
324
325
Пример:
326
327
p((ruby syntaxhl). Данный абзац содержит фразу, оформленную в стиле %(fu)ruby функции.%
328
329
h2. Ссылки на объекты
330
331
Чтобы предотвратить преобразование redmine-разметки в ссылку поставьте перед ней восклицательный знак.
332
333
h3. Задачи
334
335
p(. *!#124*: #124 -- ссылка перечеркнута, если задача закрыта.
336
337
h3. Редакции
338
339
p(. *!r758*: r758
340
341
h3. Коммиты 
342
343
p(. *commit:c6f4d0fd*: commit:c6f4d0fd
344
345
h3. Wiki-страницы
346
347
Ссылка отображается красной, если страницы не существует: [[Nonexistent page]].
348
349
p(. *&#91;&#91;Guide&#93;&#93;*: [[Guide]]
350
351
p(. *&#91;&#91;Guide&#124;User manual&#93;&#93;*: [[Guide|User manual]] -- ссылка с произвольным текстом.
352
353
p(. *&#91;&#91;Guide#User-guide&#124;User guide&#93;&#93;*: [[Guide#User-guide|User guide]] -- ссылка на определенный заголовок страницы.
354
_После символа # в названии заголовка ставятся дефисы вместо пробелов._
355
356
p(. *&#91;&#91;someproject:some-page&#93;&#93;* -- ссылка на wiki-страницу из другого проекта.
357
358
p(. *&#91;&#91;someproject:&#93;&#93;* -- ссылка на главную страницу Wiki другого проекта.
359
360
h3. Документы
361
362
p(. *!document#17* -- ссылка на документ по идентификатору.
363
364
p(. *!document:somedocument* -- ссылка на документ по названию.
365
366
p(. *!document:"Some document"* -- название заключается в двойные кавычки, если в нем есть пробелы.
367
368
p(. *!document:some_project:"Some document"* -- ссылка по названию на доукумент в другом проекте.
369
370
h3. Версии
371
372
p(. *!version#3* -- ссылка на версию по идентификатору.
373
374
p(. *!version:1.0.0* -- ссылка на версию по названию.
375
376
p(. *!version:"1.0 beta 2"* -- название заключается в двойные кавычки, если в нем есть пробелы.
377
378
h3. Проекты
379
380
p(. *project#4* или *!project:someid* -- ссылка на проект по числовому или символьному идентификатору.
381
382
p(. *!project:someproject* - ссылка на проект по названию.
383
384
p(. *!project:"Some project"* - название заключается в двойные кавычки, если в нем есть пробелы.
385
386
h3. Вложения
387
  
388
p(. *!attachment:i0003.gif*: attachment:i0003.gif -- ссылка на файл, прикрепленный к данной странице.
389
390
p((#attach). _*Важно*_: ссылки на прикрепленные файлы действуют только на той странице, к которой они прикреплены.
391
392
h3. Репозиторий
393
394
p(. *!source:some/file* -- ссылка на файл репозитория.
395
396
p(. *!source:some/file@52* -- ссылка на редакцию файла репозитория.
397
398
p(. *!source:some/file#L120* -- ссылка на строку файла репозитория.
399
400
p(. *!source:some/file@52#L120* -- комбинация разметки.
401
402
p(. *!source:"some file@52#L120"* -- двойные кавычки используются, если в URL присутствуют пробелы.
403
404
p(. *!export:some/file* -- ссылка на скачивание файла.
405
406
h2. Макросы
407
408
Список доступных макросов и их описание (по-английски) вызывается макросом *&#123;{macro_list}}*.
409
410
{{>TOC}}
411
412 1 Ruslan Khasanov
h3. Содержание
413
414 3 Lucy Yevseyeva
*&#123;{TOC}}* -- отображает содержание страницы, которое формируется автоматически на основе [[RedmineTextFormattingRus#Заголовки|заголовков]].
415
*&#123;{>TOC}}* -- выравнивание блока содержания по правому краю:
416 1 Ruslan Khasanov
417 3 Lucy Yevseyeva
h3. Дочерние страницы
418 1 Ruslan Khasanov
419 3 Lucy Yevseyeva
*&#123;{child_pages}}* -- выводит список ссылок на все "дочерние страницы":http://www.redmine.org/projects/redmine/wiki/RedmineWikis#Creating-sub-pages-parentchild-relationships (англ.) данной страницы.
420
*&#123;{child_pages(Foo)}}* -- выводит список ссылок для указанной в скобках wiki-страницы [[Foo]].
421
*&#123;{child_pages(Foo, parent=1)}}* -- начинает список со ссылки на родительскую страницу.
422 1 Ruslan Khasanov
423 3 Lucy Yevseyeva
Пример последнего макроса для страницы [[Teams]]:
424
{{child_pages(Teams, parent=1)}}
425 1 Ruslan Khasanov
426 3 Lucy Yevseyeva
h3. Включение текста
427 1 Ruslan Khasanov
428 3 Lucy Yevseyeva
*&#123;{include(Foo)}}* -- включает в данном месте текста содержимое страницы [[Foo]] без каких-либо специальных обозначений.
429 1 Ruslan Khasanov
430 3 Lucy Yevseyeva
Пример:
431 1 Ruslan Khasanov
432 3 Lucy Yevseyeva
{{include(Foo)}}
433
Если включаемой страницы не существует или у пользователя нет к ней доступа, будет выведено сообщение об ошибке.
434
435
h2. Подсветка кода
436
437
Подсветка кода реализована на "CodeRay":http://coderay.rubychan.de/ - скоростной библиотеке, написанной на Ruby. Она поддерживает синтаксис C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP, Python, RHTML, Ruby, Scheme, SQL, XML и YAML.
438
439
Чтобы подсветить код, используйте следующую разметку:
440
441 1 Ruslan Khasanov
<pre><code><pre><code class="ruby">
442 3 Lucy Yevseyeva
  Place your code here.
443 1 Ruslan Khasanov
</code></pre>
444
</code></pre>
445
446
Пример:
447
448
<pre><code class="ruby">
449
# The Greeter class
450 2 Denis Savitskiy
class Greeter
451 1 Ruslan Khasanov
  def initialize(name)
452
    @name = name.capitalize
453
  end
454
 
455
  def salute
456
    puts "Hello #{@name}!"
457
  end
458
end
459
</code></pre>
460 3 Lucy Yevseyeva
461
h2. Заключение
462
463
Простейшие возможности разметки доступны через кнопки над полем ввода, однако, все варианты оформления применимы к любому тексту в Redmine: задаче, новости, комментарию и т.п.
464
Историю изменений wiki-страницы можно посмотреть, нажав ссылку "История " вверху справа.
465
В качестве примера всех перечисленных вариантов разметки можно рассмотреть исходный код данной статьи.
466
467
fn2. К сожалению, не работает для кириллицы: ИС(Информационные Системы)
468
469
fn3. Перенос строки в тексте преобразуется парсером в @<br>@.
470
471
fn4. Ссылка не обрабатывается если отделяется от поясняемой фразы: например [4] или "другой пример"[4].