Project

General

Profile

RusRedmineTextFormatting » History » Version 23

Lucy Yevseyeva, 2014-06-21 16:32

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