Project

General

Profile

RusRedmineTextFormatting » History » Version 20

Lucy Yevseyeva, 2014-06-21 16:24

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 3 Lucy Yevseyeva
h3. Сноски
294 1 Ruslan Khasanov
295 3 Lucy Yevseyeva
Сноска:
296
297
fn21. *fn21.* Поясняющий текст.
298
299
Ссылка на сноску[4]:
300
301
p(. *Поясняемый текст&#91;21]*: Поясняемый текст[21]
302
303 6 Lucy Yevseyeva
h3. Разделитель
304
305
Три дефиса *---*, отделенные переносами строк от остального текста, преобразуются в html-тэг <hr>.
306
307
---
308
309 3 Lucy Yevseyeva
h2. Атрибуты
310
311
h3. Идентификаторы
312
313
p(. *p(#id).* -- присваивает абзацу идентификатор id.
314
315
Пример: 
316
317
p((#id). Данный абзац имеет идентификатор id, что может быть использовано, например, для создания [[RedmineTextFormattingRus#id|ссылки]] на него.
318
319
h3. Классы css
320
321
p(. *p(class).* -- присваивает абзацу класс class.
322
323
Пример:
324
325
p((ruby syntaxhl). Данный абзац содержит фразу, оформленную в стиле %(fu)ruby функции.%
326
327
h2. Ссылки на объекты
328
329
Чтобы предотвратить преобразование redmine-разметки в ссылку поставьте перед ней восклицательный знак.
330
331
h3. Задачи
332
333
p(. *!#124*: #124 -- ссылка перечеркнута, если задача закрыта.
334
335
h3. Редакции
336
337
p(. *!r758*: r758
338
339
h3. Коммиты 
340
341
p(. *commit:c6f4d0fd*: commit:c6f4d0fd
342
343
h3. Wiki-страницы
344
345
Ссылка отображается красной, если страницы не существует: [[Nonexistent page]].
346
347
p(. *&#91;&#91;Guide&#93;&#93;*: [[Guide]]
348
349
p(. *&#91;&#91;Guide&#124;User manual&#93;&#93;*: [[Guide|User manual]] -- ссылка с произвольным текстом.
350
351
p(. *&#91;&#91;Guide#User-guide&#124;User guide&#93;&#93;*: [[Guide#User-guide|User guide]] -- ссылка на определенный заголовок страницы.
352
_После символа # в названии заголовка ставятся дефисы вместо пробелов._
353
354
p(. *&#91;&#91;someproject:some-page&#93;&#93;* -- ссылка на wiki-страницу из другого проекта.
355
356
p(. *&#91;&#91;someproject:&#93;&#93;* -- ссылка на главную страницу Wiki другого проекта.
357
358
h3. Документы
359
360
p(. *!document#17* -- ссылка на документ по идентификатору.
361
362
p(. *!document:somedocument* -- ссылка на документ по названию.
363
364
p(. *!document:"Some document"* -- название заключается в двойные кавычки, если в нем есть пробелы.
365
366
p(. *!document:some_project:"Some document"* -- ссылка по названию на доукумент в другом проекте.
367
368
h3. Версии
369
370
p(. *!version#3* -- ссылка на версию по идентификатору.
371
372
p(. *!version:1.0.0* -- ссылка на версию по названию.
373
374
p(. *!version:"1.0 beta 2"* -- название заключается в двойные кавычки, если в нем есть пробелы.
375
376
h3. Проекты
377
378
p(. *project#4* или *!project:someid* -- ссылка на проект по числовому или символьному идентификатору.
379
380
p(. *!project:someproject* - ссылка на проект по названию.
381
382
p(. *!project:"Some project"* - название заключается в двойные кавычки, если в нем есть пробелы.
383
384
h3. Вложения
385
  
386
p(. *!attachment:i0003.gif*: attachment:i0003.gif -- ссылка на файл, прикрепленный к данной странице.
387
388
p((#attach). _*Важно*_: ссылки на прикрепленные файлы действуют только на той странице, к которой они прикреплены.
389
390
h3. Репозиторий
391
392
p(. *!source:some/file* -- ссылка на файл репозитория.
393
394
p(. *!source:some/file@52* -- ссылка на редакцию файла репозитория.
395
396
p(. *!source:some/file#L120* -- ссылка на строку файла репозитория.
397
398
p(. *!source:some/file@52#L120* -- комбинация разметки.
399
400
p(. *!source:"some file@52#L120"* -- двойные кавычки используются, если в URL присутствуют пробелы.
401
402
p(. *!export:some/file* -- ссылка на скачивание файла.
403
404
h2. Макросы
405
406
Список доступных макросов и их описание (по-английски) вызывается макросом *&#123;{macro_list}}*.
407
408
{{>TOC}}
409
410 1 Ruslan Khasanov
h3. Содержание
411
412 3 Lucy Yevseyeva
*&#123;{TOC}}* -- отображает содержание страницы, которое формируется автоматически на основе [[RedmineTextFormattingRus#Заголовки|заголовков]].
413
*&#123;{>TOC}}* -- выравнивание блока содержания по правому краю:
414 1 Ruslan Khasanov
415 3 Lucy Yevseyeva
h3. Дочерние страницы
416 1 Ruslan Khasanov
417 3 Lucy Yevseyeva
*&#123;{child_pages}}* -- выводит список ссылок на все "дочерние страницы":http://www.redmine.org/projects/redmine/wiki/RedmineWikis#Creating-sub-pages-parentchild-relationships (англ.) данной страницы.
418
*&#123;{child_pages(Foo)}}* -- выводит список ссылок для указанной в скобках wiki-страницы [[Foo]].
419
*&#123;{child_pages(Foo, parent=1)}}* -- начинает список со ссылки на родительскую страницу.
420 1 Ruslan Khasanov
421 3 Lucy Yevseyeva
Пример последнего макроса для страницы [[Teams]]:
422
{{child_pages(Teams, parent=1)}}
423 1 Ruslan Khasanov
424 3 Lucy Yevseyeva
h3. Включение текста
425 1 Ruslan Khasanov
426 3 Lucy Yevseyeva
*&#123;{include(Foo)}}* -- включает в данном месте текста содержимое страницы [[Foo]] без каких-либо специальных обозначений.
427 1 Ruslan Khasanov
428 3 Lucy Yevseyeva
Пример:
429 1 Ruslan Khasanov
430 3 Lucy Yevseyeva
{{include(Foo)}}
431
Если включаемой страницы не существует или у пользователя нет к ней доступа, будет выведено сообщение об ошибке.
432
433
h2. Подсветка кода
434
435
Подсветка кода реализована на "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.
436
437
Чтобы подсветить код, используйте следующую разметку:
438
439 1 Ruslan Khasanov
<pre><code><pre><code class="ruby">
440 3 Lucy Yevseyeva
  Place your code here.
441 1 Ruslan Khasanov
</code></pre>
442
</code></pre>
443
444
Пример:
445
446
<pre><code class="ruby">
447
# The Greeter class
448 2 Denis Savitskiy
class Greeter
449 1 Ruslan Khasanov
  def initialize(name)
450
    @name = name.capitalize
451
  end
452
 
453
  def salute
454
    puts "Hello #{@name}!"
455
  end
456
end
457
</code></pre>
458 3 Lucy Yevseyeva
459
h2. Заключение
460
461
Простейшие возможности разметки доступны через кнопки над полем ввода, однако, все варианты оформления применимы к любому тексту в Redmine: задаче, новости, комментарию и т.п.
462
Историю изменений wiki-страницы можно посмотреть, нажав ссылку "История " вверху справа.
463
В качестве примера всех перечисленных вариантов разметки можно рассмотреть исходный код данной статьи.
464
465
fn1. Синтаксис Textile поддерживается в Redmine не полностью. В частности, не преобразуются спецсимволы, например, (с) в &copy;, -- в &mdash; и т.п., а также не поддерживается разметка: атрибута {color:red} и блоков bq.., bc. и pre.
466
467
fn2. К сожалению, не работает для кириллицы: ИС(Информационные Системы)
468
469
fn3. Перенос строки в тексте преобразуется парсером в @<br>@.
470
471
fn4. Ссылка не обрабатывается если отделяется от поясняемой фразы: например [4] или "другой пример"[4].