Confluence 5.4 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
このページでは、Confluence がページのコンテンツ、ページテンプレート、ブループリント、ブログ投稿、およびコメントを保存するために使用するXHTML ベース形式について説明します。この情報は、Confluence ページの基本マークアップの解釈と編集を行う必要がある上級ユーザーを対象としています。
Confluence の保存形式は、「XHTML ベース」といいます。正確を期すためには XML と呼ぶべきでしょう。というのも、Confluence の保存形式はXHTML 定義に準拠していないからです。特に、Confluence ではマクロなどにカスタム要素が含まれています。アトラシアンでは、保存形式で HTML が大部分を占めていることを示すために「XHTML ベース」という用語を使用しています。
メモ:
- You can view the Confluence storage format for a given page by choosing Tools > 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 Tools > View Source, you will see the format used within the editor panel, not the storage format of the page.
- A request from the Atlassian technical writers about comments and feedback: When adding comments to this page, please restrict your comments to constructive feedback on the documentation itself: Things we've missed in the documentation, and things that will be useful to other readers. If you have other feedback about the editor, wiki markup, the XML storage format, and Confluence 4 in general, please add your comments in the section titled Confluence 4 Editor - Customer Feedback, and its child pages. Our reason for this request: When a page attracts a large number of comments, it makes it difficult for everyone to read the page, and to add or respond to comments about the documentation. Thanks.
マクロ
See Confluence Storage Format for Macros.
見出し
形式のタイプ | 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>block quote</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>Paragraph 1</p> <p>Paragraph 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" /> <!-- A link body isn't necessary. Auto-generated from the resource identifier for display. --> </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>Table Heading Cell 1</th>
<th>Table Heading Cell 2</th>
</tr>
<tr>
<td>Normal Cell 1</td>
<td>Normal Cell 2</td>
</tr>
</tbody>
</table>
|
| |||||
| 2 列、3 行。2 行目と 3 行目の最初の列はマージされたセルになります。 | N/A | <table>
<tbody>
<tr>
<th>Table Heading Cell 1</th>
<th>Table Heading Cell 2</th>
</tr>
<tr>
<td rowspan="2">Merged Cell</td>
<td>Normal Cell 1</td>
</tr>
<tr>
<td colspan="1">Normal Cell 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>This is Sarah's template</p>
<p>A single-line text variable: <at:var at:name="MyText" /></p>
<p>A multi-line text variable: <at:var at:name="MyMulti" /></p>
<p>A selection list: <at:var at:name="MyList" /></p>
<p>End of page.</p>
説明テキスト
説明テキストを使用すると、エンドユーザー (テンプレートからページの作成を使用する人) 向けにテンプレートの記入方法に関する情報を含めることができます。説明テキストの動作は次のとおりです。
- 特定のテキスト ブロックにユーザーが入力すると、すべての 説明テキストが自動でクリアされます。
- ユーザーが選択できるように @mention プロンプトが自動でトリガーされます (「mention」タイプの説明テキストの場合)。
スクリーンショット: 説明テキストの例
<ul>
<li><ac:placeholder>This is an example of instruction text that will get replaced when a user selects the text and begins typing.</ac:placeholder></li>
</ul>
<ac:task-list>
<ac:task>
<ac:task-status>incomplete</ac:task-status>
<ac:task-body><ac:placeholder ac:type="mention">@mention example. This placeholder will automatically search for a user to mention in the page when the user begins typing.</ac:placeholder></ac:task-body>
</ac:task>
</ac:task-list>
概要
コンテンツ ツール
アプリ
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.