Confluence 5.7 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
このページでは、Confluence がページのコンテンツ、ページテンプレート、ブループリント、ブログ投稿、およびコメントを保存するために使用するXHTML ベース形式について説明します。この情報は、Confluence ページの基本マークアップの解釈と編集を行う必要がある上級ユーザーを対象としています。
Confluence の保存形式は、「XHTML ベース」といいます。正確を期すためには XML と呼ぶべきでしょう。というのも、Confluence の保存形式はXHTML 定義に準拠していないからです。特に、Confluence ではマクロなどにカスタム要素が含まれています。アトラシアンでは、保存形式で HTML が大部分を占めていることを示すために「XHTML ベース」という用語を使用しています。
You can view the Confluence storage format for a given page by choosing 
> View Storage Format. This option is only available if one of the following is true:
- ユーザーが Confluence 管理者。
- Your Confluence site has the Confluence Source Editor plugin installed and you have permission to use the source editor.
- If you would like to edit the storage format for a page, your Confluence system administrator will need to install the Confluence Source Editor plugin.
- Clarification of terminology: If you choose > View Source, you'll see the format used within the editor panel, not the storage format of the page.
On this page:
マクロ
保存形式と Wiki マークアップの例は、それぞれのマクロのドキュメントに含まれています。
見出し
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 | |
|---|---|---|---|---|
| Heading 1 |
| <h1>見出し 1</h1> |
| ドキュメント用テーマでは下線が付きます |
| Heading 2 | h2. 見出し 2 | <h2>見出し 2</h2> |
| ドキュメント用テーマでは下線が付きます |
| Heading 3 | h3. 見出し 3 | <h3>見出し 3</h3> |
| |
| 見出し 4 から 6 まで利用でき、同じパターンに従います |
テキスト効果
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 | ||
|---|---|---|---|---|---|
| より強い強調/太字 | *太字* | <strong>強調太字テキスト</strong> | 太字 | <b> でも同様の結果が得られますが保存時に <strong> に変換されます。 | |
| 強調 | _強調_ | < em > 斜体テキスト </em > | 強調 | <i> でも同じ結果を得られますが保存時に <em> に変換されます | |
| 取り消し線 | -取り消し線- | <span style="text-decoration: line-through;">取り消し線</span> | <s> および <del> でも同じ結果を得られます | ||
| 下線 | +下線+ | <u>下線</u> | 下線 | ||
| 上付き | ^上付き^ | <sup>上付き</sup> | 上付き | ||
| 下付き | ~下付き~ | <sub>サブスクリプト</sub> | 下付き | ||
| 等幅 | {{等幅}} | <code>等幅</code> | monospaced | ||
| 書式設定済み | n/a | <pre>書式設定済みのテキスト</pre>
| 書式設定済みテキスト | ||
| ブロック引用 | bq. ブロック引用 または {quote} | <blockquote> <p>ブロック引用</p></blockquote> | ブロック引用 | ||
| 文字の色 | {color:red}赤い文字{color} | <span style="color: rgb(255,0,0);">赤字のテキスト</span> | 赤い文字 | ||
| 文字サイズ小 | n/a | <small>小さいテキスト</small>
| 小さい文字 | ||
| 文字サイズ大 | n/a | <big>テキスト大</big> | 大きい文字 | ||
| 中央揃え | n/a | <p style="text-align: center;">中央揃えのテキスト</p> | 中央揃えテキスト | ||
| 右揃え | n/a | <p style="text-align: right;">右揃えテキスト</p> | 右揃えテキスト | ||
テキストの改行
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 |
|---|---|---|---|
| 新しい段落 | 段落 1 | <p>段落 1</p> <p>段落 2</p> | 段落 1 段落 2 |
| 改行 | 行 1 \\ 行 2 | 行 1 \\ 行 2 注意: これはエディタで | 行 1 行 2 |
| 水平線 | ---- | <hr /> | |
— 記号 | --- | — | — |
| – 記号 | -- | – | – |
リスト
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 |
|---|---|---|---|
| 番号なし箇条書き – 黒丸 (Round Bullet) | * 番号なし箇条書き項目 | <ul> <li>round bullet list item</li> </ul> |
|
| 番号付き箇条書き (番号付きリスト) | # 番号付き箇条書き項目 | <ol> <li>numbered list item</li> </ol> |
|
| タスク一覧 | [] タスク一覧項目 | <ac:task-list>
<ac:task>
<ac:task-status>incomplete</ac:task-status>
<ac:task-body>task list item</ac:task-body>
</ac:task>
</ac:task-list>
|
|
リンク
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 |
|---|---|---|---|
| 別の Confluence ページにリンク | [別の Confluence ページにリンク|ページタイトル] | <ac:link> <ri:page ri:content-title="Page Title" /> <ac:plain-text-link-body> <![CDATA[別の Confluence ページへのリンク]]> </ac:plain-text-link-body> </ac:link> | 別の Confluence ページにリンク |
| 添付ファイルへのリンク | [Link to an attachment^atlassian_logo.gif] | <ac:link> <ri:attachment ri:filename="atlassian_logo.gif" /> <ac:plain-text-link-body> <![CDATA[Link to a Confluence Attachment]]> </ac:plain-text-link-body> </ac:link> | 添付ファイルへのリンク |
| 外部サイトにリンク | [Atlassian|http://www.atlassian.com/] | <a href="http://www.atlassian.com">Atlassian</a> | アトラシアン |
| アンカー リンク (同じページ) | [アンカー リンク|#アンカー名] | <ac:link ac:anchor="anchor"> <ac:plain-text-link-body> <![CDATA[Anchor Link]]> </ac:plain-text-link-body> </ac:link> | アンカー リンク |
| アンカー リンク (別のページ) | [アンカー リンク|ページタイトル#アンカー名] | <ac:link ac:anchor="anchor"> <ri:page ri:content-title="pagetitle"/> <ac:plain-text-link-body> <![CDATA[Anchor Link]]> </ac:plain-text-link-body> </ac:link> | アンカー リンク |
| 本文の組み込み画像とのリンク | [!google.png!|ページタイトル#アンカー名] | <ac:link ac:anchor="Anchor Link"> <ac:link-body> <ac:image><ri:url ri:value="http://confluence.atlassian.com/images/logo/confluence_48_trans.png" /></ac:image> </ac:link-body> </ac:link> 画像などのリッチ コンテンツの場合、 |
リンク本体に関する注意
エディタから取得されるすべてのリンクは、既定ではプレーンテキストで保存されます。ただし、リンク本体に含めることを許可されている一部のマークアップが検出された場合はこのかぎりではありません。リンク本体でサポートされているマークアップの例を以下に挙げます。
様々なリンク本体の例
<ac:link> <!-- Any resource identifier --> <ri:page ri:content-title="Home" ri:space-key="SANDBOX" /> <ac:link-body>Some <strong>Rich</strong> Text</ac:link-body> </ac:link> <ac:link> <ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" /> <ac:plain-text-link-body><![CDATA[A plain <text> link body]]></ac:plain-text-link-body> </ac:link> <ac:link> <ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" /> <!--リンク本文は必須ではありません。リソース識別子から自動生成され、表示されます。--> </ac:link>
<ac:link-body> 内で許可されているマークアップ タグは、<b>、<strong>、<em>、<i>、<code>、<tt>、<sub>、<sup>、<br>、<span> です。
画像
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 | |
|---|---|---|---|---|
| 添付された画像 | !atlassian_logo.gif! | <ac:image> <ri:attachment ri:filename="atlassian_logo.gif" /> </ac:image> |  | |
| 外部の画像 | !http://confluence.atlassian.com/images/logo/confluence_48_trans.png! | <ac:image> <ri:url ri:value="http://confluence.atlassian.com/images/logo/confluence_48_trans.png" /></ac:image> |  | |
サポートされている画像属性 (これらの属性の一部は、同等の HTML 4 IMG 要素に酷似しています):
| 名前 | 説明 |
|---|---|
| ac:align | 画像の位置合わせ |
| ac:border | 境界を設定するには "true" に設定します |
| ac:class | css クラス属性 |
| ac:title | 画像のツールチップ |
| ac:style | css スタイル |
| ac:thumbnail | この画像をサムネイルとして指定するには "true" に設定します |
| ac:alt | 代替テキスト |
| ac:height | 画像の高さ |
| ac:width | 画像の幅 |
| ac:vspace | 画像の上下の空白 |
| ac:hspace | 画像の左右の空白 |
表
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 | |||||
|---|---|---|---|---|---|---|---|---|
| 2 列、 2 行 (一番上の見出し行) | ||表見出しセル 1||表見出しセル 2|| | <table>
<tbody>
<tr>
<th>テーブル見出しセル 1</th>
<th>テーブル見出しセル 2</th>
</tr>
<tr>
<td>通常セル 1</td>
<td>通常セル 2</td>
</tr>
</tbody>
</table>
|
| |||||
| 2 列、3 行。2 行目と 3 行目の最初の列はマージされたセルになります。 | N/A | <table>
<tbody>
<tr>
<th>テーブル見出しセル 1</th>
<th>テーブル見出しセル 2</th>
</tr>
<tr>
<td rowspan="2">結合されたセル</td>
<td>標準セル 1</td>
</tr>
<tr>
<td colspan="1">標準セル 2</td>
</tr>
</tbody>
</table>
|
| |||||
ページレイアウト
Confluence は、マクロベースのレイアウト (セクションや列のマクロの使用など) の代替として、ページ レイアウトを直接サポートしています。このセクションでは、これらのレイアウトがページで使用されるときに作成される保存形式 XML について説明します。
メモ:
- ページ レイアウトは Confluence 4.2 で初めて導入され、それより前の Confluence のバージョンでは利用できません。Confluence 4.2 ~ 5.1 を使用している場合、ご使用の Confluence のバージョンのドキュメントを参照してください。
- 古い形式で作成されたレイアウトが存在するページは、5.2 形式に変換されます。
- Confluence 5.2 ではより簡潔な保存形式が導入されており、レイアウトの柔軟性を高めています。
| 要素名 | Confluence 5.2 以降 | 属性 |
|---|---|---|
ac:layout | ページにレイアウトがあることを示します。ページ内の最上位の要素にします。 | なし |
ac:layout-section | レイアウト内の行を表します。
| ac:type |
ac:layout-cell | レイアウト内の列を表します。ac:layout-section タグに直接含める必要があります。layout-section 内のセル数は、ac:type に一致する適切な値である必要があります。 | なし |
The recognised values of ac:type for ac:layout-section are:
| 期待されるセル数 | 説明 |
|---|---|---|
| 1 | １つのセルがセクション全体を占有します。 |
two_equal | 2 | 同じ幅の２つのセルです。 |
two_left_sidebar | 2 | 幅が狭い (~30%) セルの後に幅の広いセルが続きます。 |
two_right_sidebar | 2 | 幅の広いセルの後に幅の狭い(~30%) セルが続きます。 |
three_equal | 3 | 同じ幅の３つのセルです。 |
three_with_sidebars | 3 | 幅の広いセルが１つ中央にあり、両端に幅の狭い(~20%) セルがあります。 |
次の例は、新しい形式に組み込まれた旧形式の少し複雑なレイアウトの 1 つです。{content} は、<p> または <table> タグなどの他の XHTML または Confluence 保存形式のブロック コンテンツを入力する場所を示しています。
<ac:layout>
<ac:layout-section ac:type="single">
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
<ac:layout-section ac:type="three_with_sidebars">
<ac:layout-cell>
{content}
</ac:layout-cell>
<ac:layout-cell>
{content}
</ac:layout-cell>
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
<ac:layout-section ac:type="single">
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
</ac:layout>
絵文字
形式のタイプ | Confluence 3.5 以前 | Confluence 4.0 以降 | 表示結果 |
|---|---|---|---|
| 絵文字 | :) | <ac:emoticon ac:name="smile" /> |
|
| :( | <ac:emoticon ac:name="sad" /> |  | |
| :P | <ac:emoticon ac:name="cheeky" /> |  | |
| :D | <ac:emoticon ac:name="laugh" /> |  | |
| ;) | <ac:emoticon ac:name="wink" /> |  | |
| (y) | <ac:emoticon ac:name="thumbs-up" /> |  | |
| (n) | <ac:emoticon ac:name="thumbs-down" /> |  | |
| (i) | <ac:emoticon ac:name="information" /> |  | |
| (/) | <ac:emoticon ac:name="tick" /> |  | |
| (x) | <ac:emoticon ac:name="cross" /> |  | |
| (!) | <ac:emoticon ac:name="warning" /> |  |
リソース識別子
リソース識別子は、保存形式でリソースへの "リンク" または "参照" を表すために使用されます。リソースの例としては、ページ、ブログ投稿、コメント、ショートカット、画像などがあります。
リソース | リソース識別子の形式 |
|---|---|
| ページ | <ri:page ri:space-key="FOO" ri:content-title="Test Page"/> メモ:
|
| ブログ投稿 | <ri:blog-post ri:space-key="FOO" ri:content-title="First Post" ri:posting-day="2012/01/30" /> メモ:
|
| 添付ファイル | <ri:attachment ri:filename> ... 添付ファイル コンテナーのリソース識別子 ... </ri:attachment> メモ:
例: 相対添付ファイル参照 <ri:attachment ri:filename="happy.gif" /> 絶対添付ファイル参照 <ri:attachment ri:filename="happy.gif"> <ri:page ri:space-key="TST" ri:content-title="Test Page"/> </ri:attachment> |
| URL | <ri:url ri:value="http://example.org/sample.gif"/> メモ:
|
| ショートカット | <ri:shortcut ri:key="jira" ri:parameter="ABC-123"> メモ:
|
| ユーザー | <ri:user ri:userkey="2c9680f7405147ee0140514c26120003"/> メモ:
|
| スペース | <ri:space ri:space-key="TST"/> メモ:
|
| コンテンツ エンティティ | <ri:content-entity ri:content-id="123"/> メモ:
|
テンプレート変数
次のスクリーンショットは単純なテンプレートを示しています。
テンプレートには次の変数が含まれています。
| 変数名 | タイプ | 値 |
|---|---|---|
| $MyText | 単一行テキスト | |
| $MyMulti | 複数行テキスト | サイズ: 5 x 100 |
| $MyList | 一覧 | リストの項目: Apples,Pears,Peaches |
XML エクスポートにより、このテンプレート用に次のコードが生成されます。
<at:declarations>
<at:string at:name="MyText" />
<at:textarea at:columns="100" at:name="MyMulti" at:rows="5" />
<at:list at:name="MyList">
<at:option at:value="Apples" />
<at:option at:value="Pears" />
<at:option at:value="Peaches" />
</at:list>
</at:declarations>
<p>これはサラのテンプレートです</p>
<p>1行テキスト変数: <at:var at:name="MyText" /></p>
<p>複数行テキスト変数: <at:var at:name="MyMulti" /></p>
<p>選択リスト: <at:var at:name="MyList" /></p>
<p>End of page.</p>
説明テキスト
説明テキストを使用すると、エンドユーザー (テンプレートからページの作成を使用する人) 向けにテンプレートの記入方法に関する情報を含めることができます。説明テキストの動作は次のとおりです。
- 特定のテキスト ブロックにユーザーが入力すると、すべての 説明テキストが自動でクリアされます。
- ユーザーが選択できるように @mention プロンプトが自動でトリガーされます (「mention」タイプの説明テキストの場合)。
スクリーンショット: 説明テキストの例
<ul>
<li><ac:placeholder>これは、説明テキストの例です。ユーザーがテキストを選択し、入力を開始すると、このテキストは置き換えられます。</ac:placeholder></li>
</ul>
<ac:task-list>
<ac:task>
<ac:task-status>不完全な</ac:task-status>
<ac:task-body><ac:placeholder ac:type="mention">@メンションの例。このプレースホルダーはユーザーが入力を開始すると、ページ内でメンションするユーザーを自動検索します。</ac:placeholder></ac:task-body>
</ac:task>
</ac:task-list>
概要
コンテンツ ツール
アプリ