クラウド
Data Center 5.9
バージョン

Confluence ストレージフォーマット

Confluence マークアップ

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページでは、Confluence がページのコンテンツ、ページテンプレート、ブループリント、ブログ投稿、およびコメントを保存するために使用するXHTML ベース形式について説明します。この情報は、Confluence ページの基本マークアップの解釈と編集を行う必要がある上級ユーザーを対象としています。

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

指定したページの Confluence 保存形式を表示するには、 > [保存形式の表示] を選択します。このオプションは、次のいずれかに該当する場合にのみ使用可能です。

  • ユーザーが Confluence 管理者。
  • Confluence サイトに Confluence ソースエディタ プラグインがインストールされていて、ソースエディタを使用する権限がある場合
  • ページの保存形式を編集したい場合、Confluence システム管理者が Confluence ソースエディタ プラグインをインストールする必要があります。
  • 用語の明確化： > ソース表示を選択した場合、表示されるのはページの保存形式ではなく、エディタパネル内で使用される形式です。

On this page:

マクロ

保存形式と Wiki マークアップの例は、それぞれのマクロのドキュメントに含まれています。

見出し

形式のタイプ

Confluence 3.5 以前Confluence 4.0 以降表示結果 
Heading 1

h1. Heading 1

 
<h1>Heading 1</h1>

ドキュメント用テーマでは下線が付きます
Heading 2
h2. 見出し 2
 
<h2>Heading 2</h2>

ドキュメント用テーマでは下線が付きます
Heading 3
h3. 見出し 3
 
<h3>Heading 3</h3>

 
見出し 4 から 6 まで利用でき、同じパターンに従います    

 

テキスト効果

形式のタイプ

Confluence 3.5 以前Confluence 4.0 以降表示結果 
より強い強調/太字
*太字*
 
<strong>strong text</strong>
太字<b> でも同様の結果が得られますが保存時に <strong> に変換されます。
強調
_強調_
 
<em>Italics Text</em>
強調<i> でも同じ結果を得られますが保存時に <em> に変換されます
取り消し線
-取り消し線-
 
<span style="text-decoration: line-through;">strikethrough</span>
取り消し線<s> および <del> でも同じ結果を得られます
下線
+下線+
 
<u>underline</u>
下線 
上付き
^上付き^
 
<sup>superscript</sup>
上付き 
下付き
~下付き~
 
<sub>subscript</sub>
下付き 
等幅
{{等幅}}
 
<code>monospaced</code>
monospaced 
書式設定済みn/a 
<pre>preformatted text</pre>

 

 

書式設定済みテキスト
 
ブロック引用
bq. ブロック引用

または

{quote} 

ブロック

引用

{quote}
 
<blockquote>
<p>block quote</p></blockquote>
ブロック引用
 
文字の色
{color:red}赤い文字{color}
 
<span style="color: rgb(255,0,0);">red text</span>
赤い文字 
文字サイズ小 n/a 
<small>small text</small>

 

 

小さい文字

 
文字サイズ大n/a 
<big>big text</big>

大きい文字

 
中央揃えn/a 
<p style="text-align: center;">centered text</p>
中央揃えテキスト 
右揃えn/a 
<p style="text-align: right;">right aligned text</p>

右揃えテキスト

 

テキストの改行

形式のタイプ

Confluence 3.5 以前Confluence 4.0 以降表示結果
新しい段落
段落 1

(空行)

段落 2 
 
<p>Paragraph 1</p>

<p>Paragraph 2</p>

段落 1

段落 2

改行
行 1 \\ 行 2
 
Line 1 <br /> Line 2

注意: これはエディタで Shift + Return/Enter キーを使用して作成したものです

行 1
行 2 
水平線---- 
<hr />

— 記号

--- 
&mdash;

—

– 記号-- 
&ndash;

–

リスト

形式のタイプ

Confluence 3.5 以前Confluence 4.0 以降表示結果
番号なし箇条書き – 黒丸 (Round Bullet)
* 番号なし箇条書き項目
 
<ul>

<li>round bullet list item</li>
</ul>
  • 番号なし箇条書き項目
番号付き箇条書き (番号付きリスト)
# 番号付き箇条書き項目
 
<ol>

<li>numbered list item</li>
</ol>
  1. 番号付き箇条書き項目
タスク一覧
[] タスク一覧項目
 
<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[Link to another Confluence Page]]>
</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> 内で許可されているマークアップ タグは、<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:classcss クラス属性
ac:title画像のツールチップ
ac:stylecss スタイル
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 は、マクロベースのレイアウト (セクションや列のマクロの使用など) の代替として、ページ レイアウトを直接サポートしています。このセクションでは、これらのレイアウトがページで使用されるときに作成される保存形式 XML について説明します。

メモ:

要素名Confluence 5.2 以降属性
ac:layout

ページにレイアウトがあることを示します。ページ内の最上位の要素にします。

なし
ac:layout-section

レイアウト内の行を表します。ac:layout タグに直接含める必要があります。セクションのタイプは、セル数とそれらのセルの相対幅を示します。

 

ac:type
ac:layout-cellレイアウト内の列を表します。ac:layout-section タグに直接含める必要があります。layout-section 内のセル数は、ac:type に一致する適切な値である必要があります。なし

The recognised values of ac:type for ac:layout-section are:

ac:type

期待されるセル数

説明

single

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

(smile)

 :(   
<ac:emoticon ac:name="sad" />
(sad)
 :P   
<ac:emoticon ac:name="cheeky" />
(tongue)
 :D   
<ac:emoticon ac:name="laugh" />
(big grin)
 ;)   
<ac:emoticon ac:name="wink" />
(wink)
 (y)   
<ac:emoticon ac:name="thumbs-up" />
(thumbs up)
 (n)   
<ac:emoticon ac:name="thumbs-down" />
(thumbs down)
 (i)   
<ac:emoticon ac:name="information" />
(info)
 (/)   
<ac:emoticon ac:name="tick" />
(tick)
 (x)   
<ac:emoticon ac:name="cross" />
(error)
 (!) 
<ac:emoticon ac:name="warning" />
(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>
	... resource identifier for the container of the attachment ...
</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:userkey="2c9680f7405147ee0140514c26120003"/>

メモ:

  • ri:userkey: (必須) ユーザーの一意の識別子を示します。
スペース 
<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>

説明テキスト

説明テキストを使用すると、エンドユーザー (テンプレートからページの作成を使用する人) 向けにテンプレートの記入方法に関する情報を含めることができます。説明テキストの動作は次のとおりです。

  • 特定のテキスト ブロックにユーザーが入力すると、すべての 説明テキストが自動でクリアされます。
  • ユーザーが選択できるように @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>
Last modified on Mar 17, 2016

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.