Редактирование полей Rich Text

Когда пользователь JIRA создает, редактирует или комментирует задачу JIRA, некоторые поля могут отображать два небольших значка внизу текстовой области: синий экран (значок предварительного просмотра) и вопросительный знак (значок справки), и панель инструментов (простой редактор Wiki). Наличие этих значков и панели инструментов указывает на то, что это поле поддерживает текстовое форматирование JIRA, которое позволяет использовать функции расширенного текста, такие как:

  •  Курсив, полужирный, подчеркнутый текст (Italic, bold, underlined text).
  •  Несколько уровней заголовков (Multiple levels of headings).
  •  Маркеры, пронумерованные списки, таблицы и цитаты (Bullets, numbered lists, tables and quotations).
  •  Изображения (Images).
  •  Макросы (Macros) (см. ниже).

Вы можете щелкнуть значок справки (Help), чтобы увидеть всплывающее окно, содержащее справку о  текстовом форматировании, или выделить текст, который вы хотите отформатировать, выбрать и нажать кнопку на панели инструментов, чтобы применить соответствующий стиль.

Использование макросов

 

JIRA поставляется со следующими макросами:

 Макрос

 Описание

Привязка макроса

(Anchor Macro)

Создайте привязку, которая позволяет пользователям ссылаться на определенную точку на странице.

Применение:
 


{anchor:bookmark1}
... text here ...
[#bookmark1]

Макрокоманда кода

(Code Macro)

Отформатируйте блоки  исходного кода или XML. Язык по умолчанию - Java, но вы также можете указать JavaScript, ActionScript, XML, HTML и SQL.

Применение:


--- Java example ---
{code:title=Bar.java|borderStyle=solid}
// Some comments here
public String getFoo()
{
    return foo;
}
{code}
*--- XML example ---*
{code:xml}

  

{code}

Макрокоманда цитаты

(Quote Macro)

Создайте блок-схемы, которые могут содержать несколько абзацев или сложную разметку.

Применение:


{quote}
This is text from another source
{quote}

Макрокоманда без формата

(No Format Macro)

Создайте блоки текста, где другое форматирование вики не применяется.

Применение:


{noformat}
This is text  \#&@!@(*!&*@()#*@\ \\
{macros} _wont_work_here
{noformat} 

Макрокоманда панели

(Panel Macro)

Нарисуйте панель со следующими дополнительными параметрами:

  • Название: название панели
  • BorderStyle: стиль границы, используемый этой панелью (сплошной, пунктирный и другие допустимые стили CSS-границы)
  • BorderColor: цвет границы, используемый этой панелью
  • BorderWidth: ширина границы, используемая этой панелью
  • BgColor: цвет фона этой панели
  • TitleBGColor: цвет фона раздела заголовка этой панели

 


{panel}Some text{panel}
{panel:title=My Title}Some text with a title{panel}
{panel:title=My Title| borderStyle=dashed| borderColor=#ccc| titleBGColor=#F7D6C1| bgColor=#FFFFCE}
a block of text surrounded with a *panel*
yet _another_ line
{panel} 

Макрокоманда цвета

(Color Macro)

Измените цвет  текста.

Применение:


{color:red}
look ma, red text!
{color}

Вы можете использовать любой из шестнадцати стандартных цветов HTML ('вода', 'черная', 'синяя', 'fuschia', 'зеленый', 'серый', 'известь', 'марон', 'флот', 'маслина', 'фиолетовая', 'красная', 'серебряная', 'чирок', 'белый', 'желтый'), или любой шестнадцатеричный цветовой код (например '#336699').

Макрокоманда Lorem Ipsum

(Lorem Ipsum Macro)

Вставьте абзацы текста, заполняющего  пробел «lorem ipsum».

Применение:


{loremipsum}

Макрокоманда HTML

(HTML Macro)

Используйте HTML-код в пределах запроса Jira .

Применение:


{html}
You'll find a lot more in < href="chapter2.html">chapter two </a>. See also this <a href="../images/forest.gif">map of the enchanted forest.</a>
{html}

По материалам Atlassian JIRA User's Guide: Editing Rich-Text Fields