Feedback on Confluence Storage Format

When upgrading from Confluence 3.x to Confluence 4.x, the underlying storage format for your content will be migrated from a wiki markup-based format to a new XHTML-based format. This page describes the new storage format, and provides an opportunity for people to discuss the storage format and related ideas.

On this page:

Comments welcome

This page has attracted a lot of interest and a number of very valuable comments. Please have a read, to see the ideas that people have proposed.

Notes about the storage format

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.
Confluence の保存形式は、「XHTML ベース」といいます。正確を期すためには XML と呼ぶべきでしょう。というのも、Confluence の保存形式はXHTML 定義に準拠していないからです。特に、Confluence ではマクロなどにカスタム要素が含まれています。アトラシアンでは、保存形式で HTML が大部分を占めていることを示すために「XHTML ベース」という用語を使用しています。

Under consideration

Provide an XSD - "an XSD could make on the fly validation for persons having an editor supporting it (e.g. Visual Studio), and since an XSD would be a way to validate your input. CONF-24884 - Getting issue details... STATUS

マクロ

See Confluence Storage Format for Macros.

見出し

形式のタイプ	Confluence 3.5 以前	Confluence 4.0 以降
Heading 1	`h1. 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} ブロック引用 {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 (空行) 段落 2	<p>Paragraph 1</p> <p>Paragraph 2</p>	段落 1 段落 2
改行	行 1 \\ 行 2	行 1 \\ 行 2 注意: これはエディタで `Shift + Return/Enter` キーを使用して作成したものです	行 1 行 2
水平線	----	<hr />
— 記号	---	—	—
– 記号	--	–	–

形式のタイプ	Confluence 3.5 以前	Confluence 4.0 以降	表示結果
番号なし箇条書き – 黒丸 (Round Bullet)	* 番号なし箇条書き項目	<ul> <li>round bullet list item</li> </ul>	番号なし箇条書き項目
Unordered list – squarebullets	- Square bullet list item	<ul style="list-style-type: square;"> <li>square bullet list item</li> </ul>	Square bullet list item
番号付き箇条書き (番号付きリスト)	# 番号付き箇条書き項目	<ol> <li>numbered list item</li> </ol>	番号付き箇条書き項目

リンク

形式のタイプ	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-body` を使用してコンテンツを折り返す必要があります。

リンク本体に関する注意

エディタから取得されるすべてのリンクは、既定ではプレーンテキストで保存されます。ただし、リンク本体に含めることを許可されている一部のマークアップが検出された場合はこのかぎりではありません。リンク本体でサポートされているマークアップの例を以下に挙げます。

様々なリンク本体の例

<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> 内で許可されているマークアップタグは、、、、、<code>、<tt>、、、 、 です。

画像

形式のタイプ

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||

|通常のセル 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>

表見出しセル 1	表見出しセル 2
通常のセル 1	通常のセル 2

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>

表見出しセル 1	表見出しセル 2
マージされたセル	通常のセル 1
マージされたセル	通常のセル 2

ページレイアウト

Confluence supports page layouts directly, as an alternative to macro-based layouts such as those using the section and column macros. This section documents the storage format XML created when these layouts are used in a page.

メモ:

Page layouts were introduced in Confluence 4.2, and are not available in earlier versions of Confluence.
The word {content} in the layouts below indicates where further XHTML or Confluence storage format block content would be entered, such as  or <table> tags.

Layout Type	Confluence 4.2 以降
Two columns	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two-simple","columns":["",""]}"> <div class="columnLayout twoColumns"> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell "> <div class="innerCell"> {content} </div> </div> </div> </div>
Left sidebar	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two-simple-left","columns":["aside","large"]}"> <div class="columnLayout twoColumns"> <div class="cell aside"> <div class="innerCell"> {content} </div> </div> <div class="cell large"> <div class="innerCell"> {content} </div> </div> </div> </div>
Right sidebar	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two-simple-right","columns":["large","aside"]}"> <div class="columnLayout twoColumns"> <div class="cell large"> <div class="innerCell"> {content} </div> </div> <div class="cell aside"> <div class="innerCell"> {content} </div> </div> </div> </div>
Three columns	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-three-simple","columns":["","",""]}"> <div class="columnLayout threeColumns"> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell"> <div class="innerCell"> {content} </div> </div> </div> </div>
Two columns with header and footer	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two","columns":["",""],"header":true,"footer":true}"> <div class="header"> <div class="innerCell"> {content} </div> </div> <div class="columnLayout twoColumns"> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell "> <div class="innerCell"> {content} </div> </div> </div> <div class="footer"> <div class="innerCell"> {content} </div> </div> </div>
Left sidebar with header and footer	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two-left","columns":["aside","large"],"header":true,"footer":true}"> <div class="header"> <div class="innerCell"> {content} </div> </div> <div class="columnLayout twoColumns"> <div class="cell aside"> <div class="innerCell"> {content} </div> </div> <div class="cell large"> <div class="innerCell"> {content} </div> </div> </div> <div class="footer"> <div class="innerCell"> {content} </div> </div> </div>
Right sidebar with header and footer	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-two-right","columns":["large","aside"],"header":true,"footer":true}"> <div class="header"> <div class="innerCell"> {content} </div> </div> <div class="columnLayout twoColumns"> <div class="cell large"> <div class="innerCell"> {content} </div> </div> <div class="cell aside"> <div class="innerCell"> {content} </div> </div> </div> <div class="footer"> <div class="innerCell"> {content} </div> </div> </div>
Three columns with header and footer	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-three","columns":["","",""],"header":true,"footer":true}"> <div class="header"> <div class="innerCell"> {content} </div> </div> <div class="columnLayout threeColumns"> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell "> <div class="innerCell"> {content} </div> </div> <div class="cell"> <div class="innerCell"> {content} </div> </div> </div> <div class="footer"> <div class="innerCell"> {content} </div> </div> </div>
Left and right sidebar with header and footer	<div class="contentLayout" data-atlassian-layout="{"name":"pagelayout-three-sidebars","columns":["sidebars","large","sidebars"],"header":true,"footer":true}"> <div class="header"> <div class="innerCell"> {content} </div> </div> <div class="columnLayout threeColumns"> <div class="cell sidebars"> <div class="innerCell"> {content} </div> </div> <div class="cell large"> <div class="innerCell"> {content} </div> </div> <div class="cell sidebars"> <div class="innerCell"> {content} </div> </div> </div> <div class="footer"> <div class="innerCell"> {content} </div> </div> </div>

絵文字

形式のタイプ	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:space-key`: (optional) denotes the space key. This can be omitted to create a relative reference. `ri:content-title`: (必須) ページのタイトルを示します。
ブログ投稿	<ri:blog-post ri:space-key="FOO" ri:content-title="First Post" ri:posting-day="2012/01/30" /> メモ: `ri:space-key`: (オプション) スペースキーを示します。これを省略して相対参照を作成することもできます。 `ri:content-title`: (必須) ページのタイトルを示します。 `ri:posting-day`: (必須) 投稿日を示します。形式は、YYYY/MM/DD です。
添付ファイル	<ri:attachment ri:filename> ... 添付ファイルコンテナーのリソース識別子 ... </ri:attachment> メモ: `ri:filename`: (必須) 添付ファイル名を示します。 `ri:attachment` 要素のボディは、添付ファイルのコンテナを示すリソース識別子にします。これを省略して相対添付ファイル参照 (wiki マークアップの [foo.png] に類似) を作成することもできます。例: 相対添付ファイル参照 <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:value`: (必須) 実際の URL 値を示します。
ショートカット	<ri:shortcut ri:key="jira" ri:parameter="ABC-123"> メモ: `ri:key`: (必須) Confluence ショートカットのキーを表します。 `ri:parameter`: (必須) Confluence ショートカットに渡すパラメータを表します。上記の例は、Wiki マークアップの `[ABC-123@jira]` に相当します。
ユーザー	<ri:user ri:username="fred"/> メモ: `ri:username`: (required) denotes the name of the user.
スペース	<ri:space ri:space-key="TST"/> メモ: `ri:space-key`: (必須) スペースのキーを示します。
コンテンツエンティティ	<ri:content-entity ri:content-id="123"/> メモ: `ri:content-id`: (必須) コンテンツの ID を示します。

テンプレート変数

次のスクリーンショットは単純なテンプレートを示しています。

テンプレートには次の変数が含まれています。

変数名	タイプ	値
$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:&nbsp;<at:var at:name="MyText" /></p>
<p>A multi-line text variable:&nbsp;<at:var at:name="MyMulti" /></p>
<p>A selection list:&nbsp;<at:var at:name="MyList" /></p>
<p>End of page.</p>

Another page available for further discussion

A new page is available as a place to continue discussions: Confluence 4 further discussion.

Please feel free to add your comments anywhere. We are not shutting down discussion on this page. We are supplying the new page to alleviate the problems caused by slow response on this page, due to the number of comments here.

ページツリー