RusRedmineTextFormatting » History » Version 53

Lucy Yevseyeva, 2014-06-21 17:57

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