Project

General

Profile

RusRedmineTextFormatting » History » Version 55

Lucy Yevseyeva, 2014-06-21 18:23

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