Documentation for JIRA 4.2. Documentation for other versions of JIRA is available too.

When you create, edit or comment on a JIRA issue, some fields may display two small icons at the right of the text area: a blue screen (the 'Preview' icon) and a yellow question-mark (the 'Help' icon). The presence of these icons indicates that this field supports JIRA's Text Formatting Notation, allowing you to use rich-text features such as:

  • 斜体、太字、下線付きテキスト。
  • 複数レベルの見出し。
  • 箇条書き、番号付きリスト、表、引用符。
  • 画像。
  • マクロ (下記参照)。

For example, to include an image in the field, you would first attach the image to the issue, then type the following into the field:

To preview what the field will look like after you save it, click the 'Preview' icon:

Click the 'Help' icon to see a popup window containing the Text Formatting Notation Help.

マクロを使用する

JIRA テキスト書式の表記およびマクロは、JIRA 管理者により関連する レンダラーが設定されていた場合にのみ利用できます。

JIRA には次のマクロが同梱されています。

マクロ

説明

デフォルトで有効

アンカー マクロ

ページ内の特定の場所にリンクできるアンカーを作成します。使用方法:

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

はい

コー​​ド マクロ

ソースコードや 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}
<test>
 <another tag="attribute"/>
</test>
{code}

はい

引用文生成マクロ

複数の段落や複雑なマークアップを含む引用文を生成します。使用方法:

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

はい

書式なしマクロ

他の wiki 書式設定が適用されないテキスト ブロックを作成します。使用方法:

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

はい

パネル マクロ

次のオプションのパラメーターを持つパネルを描画します。

  • title:パネルのタイトル
  • 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} 

true

Colour Macro

Change the colour of the contained text. Usage:

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

You can use any of the sixteen standard HTML colours ('aqua','black','blue','fuschia','green','gray','lime', 'maroon','navy','olive','purple','red','silver','teal','white','yellow'), or any hexadecimal colour code (e.g. '#336699').

はい

ロレム イプサム マクロ

"ロレム イプサム'' のダミー テキストの段落を挿入します。使用方法:

{loremipsum}

はい

HTML マクロ

JIRA 課題内で HTML コードを使用します。 使用方法:

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

いいえ