Confluence 5.3 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
This page is an extension of Confluence Wiki Markup. It describes the wiki markup used to define specific Confluence macros – the macros that are shipped with Confluence. For each macro, we define the macro name, parameter names, and accepted parameter values.
- ドキュメント用テーマを設定する。
- Wiki マークアップを直接エディタに入力する。Confluence はユーザーの入力をリッチテキスト エディタ形式に変換します。
- リンク ブラウザの [詳細] タブを使用してリンクを作成する。
- Insert a block of wiki markup into the Confluence editor. (Choose Insert > Wiki Markup.)
注意: Wiki マークアップ内のコンテンツは編集できません。Confluence は Wiki マークアップ内のページコンテンツを保存しません。 Wiki マークアップはエディターに入力できますが、Confluence は即座にそれをリッチテキストエディタ形式に変換します。最初のエントリ後は Wiki マークアップを編集できなくなります。
On this page:
アンカー マクロ
Allows you to link to a specific part of a page.
Macro name: マクロ本体: なし。 (Unnamed in wiki markup)anchorパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterはい (なし) The name of the anchor.
例:
{anchor:here}
Attachments macro
Displays a list of attachments on a given page.
Macro name: マクロ本体: なし。 利用可能な値: 正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例: 利用可能な値: The default sort order is determined by the 利用可能な値:attachmentsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 oldいいえ falsefalse - Displays only the latest version of each attachment.true – Displays all versions of each attachment, including the old versions.patternsいいえ (なし) .*jpg」を使用します (「*.jpg」ではありません )。.*jpg」、「.*png」を使用します。sortByいいえ datedatesizenamepageいいえ The page on which the macro exists. Page name, used to display attachments from another page. sortOrderいいえ sortBy type:ascendingdescendinglabelsいいえ (なし) A comma-separated list of labels. Confluence will show only attachments that have all the labels specified. (The match is an AND, not an OR.) uploadいいえ falseDetermines whether the list of attachments will include options allowing users to browse for, and attach, new files.
例:
{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false}
Blog Posts macro
Lists the most recent news items in the space.
Macro name: マクロ本体: なし。 利用可能な値: One or more space keys, separated by a comma or a space. 特別な値: 個人用スペースを指定する場合、 例: 利用可能な値: One or more label values, separated by a comma or a space.blog-postsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 contentいいえ entireentire – Display the whole content of each blog post.excerpts – Display a short extract from each blog post. If the post contains an Excerpt macro, the Blog Posts macro will display the content defined in the Excerpt macro. If the post does not contain an Excerpt macro, the Blog Posts macro will display the first few sentences of the post.titles – Display a list of blog posts, showing titles only.spacesいいえ @self
-BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。+GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。@self — 現在のスペース。@personal — All personal spaces.@global — All site spaces.@favorite — The spaces you have marked as favourite.@favourite — 上記の @favorite と同様。@all — Confluence サイトのすべてのスペース。* — 上記の @all と同様。~jbloggs や ~jbloggs@example.com のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。authorいいえ (なし) One or more usernames, separated by commas. timeいいえ (なし) 利用可能な値: m — 分h — Hoursd — Daysw — 週time=12h – Display blog posts created in the last twelve hours.time=7d – Display blog posts created in the last seven days.reverseいいえ falseA value of true changes the sort order.sortいいえ creation
maxいいえ 15The maximum number of results to be displayed. labelいいえ (なし)
-badpage you will get only content which is not labelled with 'badpage'.+superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。
例:
{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}
Change-History macro
Displays a history of updates made to a page.
Macro name: マクロ本体: なし。 Parameters: None.change-history
例:
{change-history}
Chart macro
Displays a chart based on tabular data.
Macro name: Macro body: Accepts rich text, consisting of tables that hold the chart's data. このマクロでは、便宜上種類別の一覧にまとめられた多数のパラメーターが使用されます。 これらのパラメーターは、表示するチャートのタイプやチャートの外観を決定します。 表示するチャートの種類。XY グラフは x 軸と y 軸の数値軸を持ちます。x の値は必要に応じて時間ベースにできます。 利用可能な値: 表示の向き。area、bar、および line チャートに適用されます。 利用可能な値: 3 次元で表示します。area、bar、および line チャートに適用されます。 データ表で構成される、マクロ本文を表示するかどうかを決定します。既定では、チャートのデータ表は表示されません。 利用可能な値: チャートに使用される画像のフォーマット。 利用可能な値: チャートのデータは、マクロ本文で見つかった表から取得されます。これらのパラメーターは、このデータの解釈方法を制御します。既定では、数値と日付の値は、Confluence のグローバル既定言語 (ロケール) のフォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。以下のパラメータを使用すると、追加の変換オプションを指定できます。 コンテンツの向きです。既定では、データ表の (水平方向の) 列が定義域および x の値を表していると解釈されます。 利用可能な値: " 時系列データに使用される期間。データの解釈粒度を定義します。 利用可能な値: ロケールを形成するために、 Available values are the two-character ISO 639-1 alpha-2 codes. マクロがデータ形式エラーを容認 (許可) するかどうかを決定します。 利用可能な値: 色は、16 進数表記または HTML カラーネームを使用して指定します。 グラフの種類に応じて、縦軸、横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメータを 1 つ以上指定することにより上書きできます。 カテゴリの軸ラベルのテキストの位置。 利用可能な値: 日付の目盛りの位置。 利用可能な値: 例 1: "Independent = 20" のように表示するには、次のようにします。 These are advanced options that can be used for chart versioning, to enable automation and to improve performance. Use these options carefully! Normally, the chart image is regenerated each time the page is displayed. These options allow for the generated image to be saved as an attachment and have subsequent access to re-use the attachment. This can be useful especially when combined with the Cache plugin to improve performance. Depending on the options chosen, chart images can be versioned for historical purposes. 名前とグラフ画像が添付ファイルとして保存される場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。 このパラメータで利用可能な構文は次のとおりです。 保存されたチャートのバージョン管理方法を定義します。 利用可能な値: chartチャート タイプのパラメーター
パラメーター 必須 既定 説明 typeいいえ pietimeSeries パラメーターをご参照ください。- pie, bar, line, areaxyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeriesgantt (beta)orientationいいえ verticalvertical - y 軸が垂直軸horizontal - x 軸が垂直軸3Dいいえ falsestackedいいえ false積み重ね値。area、bar チャートに適用されます。 showShapesいいえ true line チャートに適用されます。各データの位置に図形が表示されます。 opacityいいえ 0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。 チャートの表示パラメーター
パラメーター 必須 既定 説明 widthいいえ 300ピクセル単位で示されるチャートの幅。 heightいいえ 300ピクセル単位で示されるチャートの高さ。 dataDisplayいいえ falsetrue または after - データがチャートのあとに表示されます。before – - データがチャートの前に表示されます。imageFormatいいえ pngpngjpgチャートのタイトルとラベルのパラメーター
パラメーター 必須 既定 説明 titleいいえ (なし) チャートのタイトル。 subTitleいいえ (なし) グラフのサブタイトル。 xLabelいいえ (なし) x 軸 (項目) のラベル。 yLabelいいえ (なし) y 軸 (値) のラベル。 legendいいえ falseチャートの凡例 (キー) を表示するかどうかを決定します。 チャートのデータのパラメーター
パラメーター 必須 既定 説明 tablesいいえ すべての第 1 レベルの表 マクロ本文に含まれ、チャートのデータとして使用される、表 ID または表番号 (1 で開始) をコンマ区切りの一覧にしたものを提供できます。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような事例は、より複雑な書式設定が行われる (例: セクション マクロや列マクロを使用) 場合に生じます。 columnsいいえ すべての列 チャート データに使用される表の列ラベルや列タイトル、列番号をコンマ区切りにした一覧指定できます。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の (html の) title 属性です。 dataOrientation いいえ horizontalvertical - データ表の列が系列と解釈されます。horizontal – データ表の行が系列と解釈されます。timeSeries いいえ falsetrue" の場合、XY プロットの x の値は時系列データとして扱われるため、日付形式に変換されます。dateFormat いいえ Confluence 言語で定義された日付形式 For time series data, the date format allows for additional customisation of the conversion of data to date values. If a dateFormat is specified, it will be the first format used to interpret date values. Specify a format that matches the time series data. See simple date format.timePeriod いいえ daymillisecond, second, minute, hour, day, week, month, quarter, yearlanguageいいえ (なし) country パラメータと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。countryいいえ (なし) Use in combination with the language parameter to form a locale. Valid values are the two-character ISO 3166 codes.forgiveいいえ truetrue - マクロは、既定の形式またはユーザ指定の表示形式に完全に一致しない数値および日付の値の変換を試みます。false — マクロは厳密なデータ形式を適用します。データ形式エラーが生じると、グラフは作成されません。グラフカラー パラメーター
パラメーター 必須 既定 説明 bgColor いいえ 白 グラフの背景色。 borderColor いいえ 枠線なし グラフの周りの枠線の色。 colorsいいえ カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。 チャートの軸のパラメーター
パラメーター 必須 既定 説明 rangeAxisLowerBound いいえ (なし) 縦軸の最小値。 rangeAxisUpperBound いいえ (なし) 縦軸の最大値。 rangeAxisTickUnitいいえ (なし) 縦軸の 1 目盛りの単位。 rangeAxisLabelAngleいいえ (なし) 縦軸ラベルの表示角度。 domainAxisLowerBoundいいえ (なし) XY プロットにのみ適用されます。横軸の下限。日付軸の場合、この値は、 dateFormat パラメータで指定された日付形式である必要があります。domainAxisUpperBoundいいえ (なし) XY プロットにのみ適用されます。横軸の上限。日付軸の場合、この値は、 dateFormat パラメータで指定された日付形式である必要があります。domainAxisTickUnitいいえ (なし) XY プロットにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、 timePeriodパラメーターで指定された単位の数になります。timePeriod 単位は、終了文字を指定することで上書きできます:y (年)、M (月)、d (日)、h (時間)、m (分)、s (秒)、u (ミリ秒)。domainAxisLabelAngleいいえ (なし) XY プロットにのみ適用されます。横軸ラベルの表示角度。 categoryLabelPositionいいえ (なし) up45 - 45 度上向きup90 - 90 度上向きdown45 - 45 度下向きdown90 - 90 度下向きdateTickMarkPositionいいえ startstart - 目盛りをその期間の開始に表示します。middle - 目盛りをその期間の中間に表示します。end - 目盛りをその期間の終了に表示します。Pie チャートのパラメーター
パラメーター 必須 既定 説明 pieSectionLabelいいえ 円グラフのセクションのキー値のみを表示 円グラフのセクション ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。 %0% は円グラフ セクションのキーで置換されます。%1% は円グラフ セクションの数値で置換されます。%2% は円グラフ セクションのパーセント値で置換されます。%0% = %1%
例 2: "Independent = (20%)" のように表示するには、次のようにします。%0% (%2%)
pieSectionExplodeいいえ 切り離しなし 切り離して表示する円グラフのキーをコンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。 チャートの添付ファイルのパラメーター
パラメーター 必須 既定 説明 attachmentいいえ (なし) ^attachmentName.png — チャートは現在のページに添付ファイルとして保存されます。page name^attachmentName.png — チャートは指定したページ名に添付ファイルとして保存されます。spacekey:page name^attachmentName.png — チャートは、指定されたスペースの指定されたページ名に添付ファイルとして保存されます。attachmentVersionいいえ newnew — 新しいバージョンの添付ファイルを作成します。replace — replaces all previous versions of the chart. To replace an existing attachment, the user must be authorised to remove attachments for the page specified.keep — 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。attachmentCommentいいえ (なし) 保存されたチャート添付ファイルに使用されるコメント。 thumbnailいいえ falsetrue の場合、チャート画像の添付ファイルがサムネイル (小さいサイズ、拡大可能) として表示されます。
例:
Below is a simple example of a pie chart. See more examples in Wiki Markup Examples for Chart Macro.{chart:type=pie|title=Fish Sold}
|| Fish Type || 2004 || 2005 ||
|| Herring | 9,500 | 8,300 |
|| Salmon | 2,900 | 4,200 |
|| Tuna | 1,500 | 1,500 |
{chart}
Cheese macro
Displays the words "I like cheese!"
Macro name: マクロ本体: なし。 Parameters: Nonecheese
例:
{cheese}
Children Display macro
Displays the children and descendants of the current page.
Macro name: マクロ本体: なし。 Determines the sort order of the list of child pages. 利用可能な値: A heading style to be applied to the list of child pages. Available values: The name of the parent page. The macro will display the children of the specified page. To specify a page in a different space, use a space key followed by a colon. For example: If the value of this parameter is a forward slash ( If childrenパラメーター名 必須 既定 パラメーターの説明と指定可能な値 reverseいいえ falseReverses the sort order in the list of child pages. Use this parameter in conjunction with the sort parameter described below. A value of true will change the sort order from ascending to descending.sortいいえ Manual if the pages have been manually reordered, otherwise alphabeticalby page title creation – Sort by the date on which the page was created.title – Sort alphabetically by page name.modified – Sort by the date on which the page was last updated.styleいいえ Bullet list h1 (heading level 1) through to h6 (heading level 6).pageいいえ The page that contains the macro MYSPACE:My page/) the macro will list the pages at the root of the current space. In other words, the pages without parents.excerptいいえ falseIf true, Confluence will display any excerpts that are defined on the child pages. The excerpts must be defined via an Excerpt macro.firstいいえ (なし) The maximum number of child pages to be displayed (at the top level). For example, if the value of this parameter is 99, the macro will display the first 99 pages at the top level. It will also display their children, as determined by the depth and all parametersdepthいいえ (なし) The number of levels of child pages to display. For example, if the value is 2, the macro will display 2 levels of child pages.allいいえ falsetrue, Confluence will display all levels of child pages. This setting will override the depth setting.
例:
{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=true|first=99|depth=2|all=true}
コード ブロック マクロ
Displays code in your document with the appropriate syntax highlighting.
Macro name: Macro body: Accepts plain text. Specifies the colour scheme used for displaying your code. Many of these themes are based on the default colour schemes of popular integrated development environments (IDEs). The default theme is Available themes: If If Specifies the language (or environment) for syntax highlighting. If If codeパラメーター名 必須 既定 パラメーターの説明と指定可能な値 titleいいえ (なし) Adds a title to the code macro box. themeいいえ ConfluenceConfluence (also known as Default), which is typically black and coloured text on a blank background.DJangoEmacsFadeToGreyMidnightRDarkEclipseConfluence (same as default)linenumbersいいえ falsetrue, a line number will be shown to the left of each line of code. Numbering is incremented by 1.false, no line numbers are shown.languageいいえ javaactionscript3bashcsharp — that is, C#coldfusioncpp — that is, C++cssdelphidifferlanggroovyjavajavafxjavascriptperlphppowershellpythonrubyscalasqlvb — that is, Visual Basichtml/xmlfirstlineいいえ 1When linenumbers is true, this value defines the number of the first line of code.collapseいいえ falsetrue, the code macro's content will be collapsed upon visiting or refreshing the Confluence page. Clicking the 'expand source' link allows you to view the content.false, the code macro's content is always displayed in full.
例:
{code:title=This is my title|theme=FadeToGrey|linenumbers=true|language=html/xml|firstline=0001|collapse=true}
これは私のコードです
{code}
Column macro
Used with the Section macro to define columns on a page. See Working with page layouts and columns and sections.
Macro name: Macro body: Accepts rich text.columnパラメーター名 必須 既定 パラメーターの説明と指定可能な値 widthいいえ 100%のページ幅をセクション内の列の数で均等に分割。 列幅。ピクセル (例: 400px) または有効なページ幅のパーセント値 (例: 50%) で指定します。
例:
{column:width=100px}
This is the content of *column 1*.
{column}
ラベル別コンテンツ マクロ
Displays a list of content associated with specific labels.
Macro name: マクロ本体: なし。 Filters the results by space. The macro will display only the pages and other content types which belong to the space(s) you specify here. 特別な値: 個人用スペースを指定する場合、 Filters the results by author. The macro will display only the pages and other content types which are written or updated by the author(s) you specify here. To include content from one user, but exclude from another user: 特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを 利用可能な値:contentbylabelパラメーター名 必須 既定 パラメーターの説明と指定可能な値 spacesいいえ @all
You can specify one or more space keys, separated by a comma or a space.
-BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。+GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。@self — 現在のスペース。@personal — All personal spaces.@global — All site spaces.@favorite — The spaces you have marked as favourite.@favourite — 上記の @favorite と同様。@all — Confluence サイトのすべてのスペース。* — 上記の @all と同様。~jbloggs や ~jbloggs@example.com のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。authorいいえ (なし)
You can specify one or more authors, separated by a comma.jsmith,jbrown jsmith,!jbrowntitleいいえ (なし) Adds a heading to the list. showLabelsいいえ trueDetermines whether to display the matching labels in the list of results. reverseいいえ falseUse this parameter in conjunction with the sort parameter. Set reverse=true to change the sort from ascending to descending. This parameter is ignored if the sort parameter is not specified.sortいいえ modifiedDetermines how the results are sorted. To change the sort order from ascending to descending, use the reverse parameter described above.
If this parameter is not specified, the sort order defaults to descending order based on the last modification date.
Values:
maxいいえ 15Determines the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied. excerptいいえ falseIf this parameter is set to true, the macro displays an excerpt from each page listed in the results. Note that you must define the excerpts on each of those pages, by adding the Excerpt macro to each page. If a particular page does not have an excerpt defined, then the Content by Label macro will not attempt to show an excerpt for that page. The Content by Label macro will show only the first few lines of the excerpt for each page.labelsはい (なし) Use this parameter to filter the results by label. The macro will display only the pages and other content types which are tagged with the label(s) you specify here. See also the operator parameter.
You can specify one or more label values, separated by a comma or a space.
-badpage you will get only content which is not labelled with 'badpage'.+superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。showSpaceいいえ trueDetermines whether to display the spaces in the list of results. typeいいえ すべて Filters the restults by content type. The macro will display only the content of the type you specify here.
You can specify one or more types, separated by a comma or a space.-blogpost と指定すると、ページと、ブログ投稿を除くその他すべてのコンテンツを取得できます。page — ages.blogpost or news — blog posts, also known as news items.attachment – attachments.operatorいいえ ORThe operator to apply to the supplied lists of labels. By default, a page with any of the non-prefixed labels (that is, labels without a plus (+) or minus (-) sign immediately preceding it) will be listed. If you specify a value of AND, only pages with all of the supplied non-prefixed labels will be listed.
Note that this parameter only modifies the behaviour of the 'Label(s)' parameter and only affects label values without a plus (+) or minus (-) sign prefix. To avoid confusion or unexpected results, we recommend that you do not use the operator parameter in conjunction with any label values prefixed with '+' or '-' signs.
例:
{contentbylabel:spaces=@personal,@self|author=admin,smaddox|title=My labelled pages|showLabels=false|reverse=true|sort=creation|max=10|excerpt=true|labels=chocolate,cake|showSpace=false|type=page|operator=AND}
Content by User macro
Displays a list of the content items that have been created by a specified Confluence user.
Macro name: マクロ本体: なし。 (Unnamed in wiki markup)content-by-userパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterはい (なし) The Confluence username for the person whose content you wish to display
例:
{content-by-user:jsmith}
コンテンツ レポートテーブル マクロ
このマクロでは Wiki マークアップは使用できません。Wiki マークアップを使用して、このマクロを追加することはできません。
Contributors macro
Displays a list of Confluence users who have made a contribution of some type to a page.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) Limits the number of contributors displayed in the list. 現在のスペース Specifies the space key of the Confluence space to search. Space keys are case sensitive. You can specify one or more space keys or special values, separated by commas. Reverses the order of contributors in the list. Must be used in conjunction with the The specified page only Specifies additional pages to include when generating the list of contributors. 利用可能な値: (なし) Limits the list of contributors to those who created the specified labels on a page. You can specify one or more labels, separated by commas. If the value is true, the macro will display a list of the pages used to generate the list of contributors. "No contributors found for:" (and a summary of selected parameter values) Any message given here will override the default message that is displayed when no contributors are found. false Determines whether the macro will show the number of times each person made a contribution. Both pages and blog posts Restricts the content type that the macro will use when generating the list of contributors. 利用可能な値: authors ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。 You can specify one or more contribution types, separated by commas. Determines how the list of contributors is formatted: Determines whether to include those who contributed anonymously to a page. 投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。 The current page Specifies the page to use when generating the list of contributors. If Determines whether to show the last time each person made a contribution. (None)e Specifies the publication date for a blog post. The date format required is: YYYY/MM/DD.contributors必須 limit いいえ spaces いいえ
Special values:
If no page and labels are specified, all pages from the specified set of spaces are included.reverseいいえ falseorder parameter.scope
いいえ children – only the child pages of the specified page.descendants – all descendants of the specified page.labels いいえ showPages いいえ falsenoneFoundMessage いいえ showCount いいえ contentType
いいえ pages – pagesblogposts – blog posts.include
いいえ authors - ページを作成または編集したユーザーを含むcomments - ページにコメントしたユーザーを含むlabels - ページにラベルを追加したユーザーを含むwatches - includes people who are watching the page(s).mode
いいえ inline
inline — a comma-separated listlist — a bullet list.showAnonymous
いいえ false
order
いいえ count
count – sorts the names based on the total number of contributions to the page(s)name – sorts the names into alphabetical orderupdate – sorts the names by the date of their last contribution to the page(s).ページ
いいえ page and spaces are left blank, the current page is assumed.showLastTime
いいえ false
publishDate
いいえ
例:
この例では、ブログ投稿のコンテンツ タイプを指定しています。 この例では、ページ コンテンツ タイプを指定しています。 {contributors:limit=10|spaces=ds,@personal|reverse=true|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=blogposts|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|showLastTime=true|publishDate=2012/06/30}
{contributors:limit=10|spaces=ds,@personal|reverse=true|scope=descendants|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=pages|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|page=ds:Advanced Topics|showLastTime=true}
Contributors Summary macro
Displays a table of contribution-based statistics for a set of pages.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) Limits the number of contributors or pages displayed in the table. 現在のスペース Specifies the space key of the Confluence space to search. Space keys are case sensitive. You can specify one or more space keys or special values, separated by commas. Reverses the order of items in the table. Must be used in conjunction with the Determines whether to include those who contributed anonymously to a page. The specified page only Specifies additional pages to include when generating the list of contributors. 利用可能な値: Sets the criterion used for sorting items in the table. 利用可能な値: The current page A page title. Specifies the page to use when generating the list of contributors. If (なし) Limits contribution-based statistics to the specified labels only. You can specify one or more labels, separated by commas. Determines the columns that should appear in the table. The statistics or type of information presented depends on the 利用可能な値: You can specify one or more columns, separated by commas. 投稿者ベース統計をグループ化する基準を指定します: Both pages and blog posts Restricts the content type that the macro will use when generating the list of contributors. 利用可能な値: (なし) Specifies the publication date for a blog post. The date format required is: YYYY/MM/DD.contributors-summary必須 limit いいえ spaces いいえ
Special values:
If no page and labels are specified, all pages from the specified set of spaces are included.reverseいいえ falseorder parameter.showAnonymous
いいえ false
scope
いいえ children – only the child pages of the specified page.descendants – all descendants of the specified page.order
いいえ edits
edits – sorts items in the table based on the total number of edits made, either by a contributor or to a page.name – sorts items in the table in alphabetical order, either by contributor or page name.editTime – sorts items in the table based on when the contributor last edited a page (or a specified set of pages) or when the page was lasted edited.update – sorts items in the table based on when the contributor last made any contribution to a page (or a specified set of pages) or when the page last had any contribution made to it.ページ
いいえ page and spaces are left blank, the current page is assumed.labels いいえ 列
いいえ edits,comments,labelsgroupby parameter.edits – the number of times each contributor has edited the page(s) or the number of edits made to each page.edited – a list of the pages edited by each contributor or a list of contributors who have edited each page.comments – the number of times each contributor has added comments to the page(s) or the number of comments on each page.commented – a list of pages to which each contributor has added comments or a list of contributors who have commented on each page.labels – the number of times each contributor has added labels to the page(s) or the number of labels on each page.labeled – a list of pages to which each contributor has added labels or a list of contributors who have added a label to each page.labellist – a list of labels either added by each contributor or on each page.watches – the number of pages being watched by each contributor/person or the number of contributors/people watching each page.watching – a list of pages being watched by each contributor/person or a list of contributors/people watching each page.lastupdate – the last time each contributor made an update or when each page was last updated. Valid updates can include edits, comments or label modifications to a page.groupby
いいえ contributorscontributors – group by the people who have contributed.pages – group by the pages used to find the contributors.contentType
いいえ pages – pagesblogposts – blog posts.showZeroCountsいいえ falseDetermines whether contributors or pages are included for which the calculated statistic is zero. publishDate
いいえ
例:
この例では、ブログ投稿のコンテンツ タイプを指定しています。 この例では、ページ コンテンツ タイプを指定しています。{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|order=update|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=blogposts|showZeroCounts=true|publishDate=2012/06/07}
{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|scope=descendants|order=update|page=ds:Advanced Topics|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=pages|showZeroCounts=true}
テンプレートから作成マクロ
Creates a page from a given template.
このマクロでは Wiki マークアップは使用できません。Wiki マークアップを使用して、このマクロを追加することはできません。
Create Space Button macro
Displays a create space button linked to the create space page.
Macro name: マクロ本体: なし。 Determines the size of the 'create space' icon displayed. Available values: 自然なサイズのアイコン (1:1 ピクセル比) 表示されるアイコン幅をピクセルで指定。Confluence は、アイコン幅を指定したピクセル数に伸縮します。 注意:このパラメータはマクロ ブラウザからは使用できません。 自然なサイズのアイコン (1:1 ピクセル比) 表示されるアイコンの高さをピクセルで指定。Confluence は、アイコンの高さを指定したピクセル数に伸縮します。 注意:このパラメータはマクロ ブラウザからは使用できません。create-space-buttonパラメーター名 必須 既定 パラメーターの説明と指定可能な値 sizeいいえ largelargesmallwidthいいえ heightいいえ
例:
{create-space-button:size=small}
{create-space-button:height=50px|width=50px}
Excerpt Include macro
Allows you to display an excerpt from another page within the current page.
Macro name: マクロ本体: なし。 (Unnamed in wiki markup) The name of the page that contains the excerpt to be displayed. To include an excerpt from a page in another space, type the space key followed by a colon (:) and the page name, like this: Note: The ability to include excerpts from other spaces is available only in Confluence 4.3.2 and later. In earlier versions of Confluence, the Excerpt Include macro does not work across spaces. Use the Include Page macro instead.excerpt-includeパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterはい (なし) SPACEKEY:My page namenopanelいいえ FalseDetermines whether Confluence will display a panal around the excerpted content. The panel includes the title of the page containing the excerpt, and the border of the panel. By default, the panel and title are shown.
例:
{excerpt-include:My page name|nopanel=true}
抜粋マクロ
ページの一部を「抜粋」として定義し、他のページで表示されるようにします。
Macro name: Macro body: Accepts rich text. Determines whether the content of the Excerpt macro body is displayed on the page that contains the Excerpt macro. このオプションは抜粋マクロを含むページにのみ影響します。コンテンツを再利用したページには影響しません。 抜粋マクロ本体に含まれるコンテンツを新たに行を追加して表示するか、インラインで表示するか決定します。 利用可能な値: このオプションは抜粋マクロを含むページにのみ影響します。コンテンツを再利用したページには影響しません。excerptパラメーター名 必須 既定 パラメーターの説明と指定可能な値 hiddenいいえ Falseatlassian-macro-output-typeいいえ BLOCKBLOCK – マクロのコンテンツを新しい行で表示します。INLINE – マクロのコンテンツを前後のテキストと同じ段落の一部として表示します。
例:
{excerpt:hidden=true|atlassian-macro-output-type=BLOCK}
This is the *text* I want to reuse in other pages. This text is inside an Excerpt macro.
{excerpt}
Expand macro
Displays an expandable/collapsible section of text.
Macro name: Macro body: Accepts rich text. (Unnamed in wiki markup)expandパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterいいえ Click here to expand...Text that will be displayed on the line that people can click to expand the hidden text.
例:
{expand:This is my message}
This text is _hidden_ until you expand it.
{expand}
Favourite Pages macro
Displays a list of your favourite pages.
Macro name: マクロ本体: なし。 Parameters: None.favpages
例:
{favpages}
ガジェットマクロ
Allows you to add Confluence gadgets to pages or blog posts.
Macro name: マクロ本体: なし。 マークアップでのガジェットプロパティ(設定)を編集する際の注意:プロパティの値は Wiki マークアップや保存形式で直接編集することが可能ですが、無効な値しか入力できません。ガジェットプロパティが値をサポートしている場合、マクロブラウザはユーザーにプロパティに有効な値を選択させるよう制限します。そのため、ガジェットプロパティの編集には、マクロブラウザを使用することをおすすめします。gadgetパラメーター名 必須 既定 パラメーターの説明と指定可能な値 widthいいえ 450 pixelsThe width of the gadget, using one of the following conventions: px or plain numbers. For example, 500px or 500%. を使用してページ幅のパーセント値を指定。例: 50%autoborderいいえ trueDetermines whether Confluence will draw a border around the gadget. urlはい (none.) ガジェット仕様が設定されている場所(XML ファイル)。 preferencesいいえ (Gadget-dependent.) 各ガジェット固有の、特定のプロパティ設定。
例:
これは Confluence ページ ガジェットの例です。 これは Confluence ニュース ガジェットの例です。{gadget:width=500|border=false|url=rest/gadgets/1.0/g/com.atlassian.confluence.plugins.gadgets:confluence-page-gadget/gadgets/confluence-page-gadget.xml}
spaceName=Documentation&spaceKey=DOC&quickfind-space=Documentation&pageId=753666&pageName=Documentation%20Home&quickfind-page=Documentation%20Home&isEditable=true&isConfigured=true&refresh=15&showLink=false
{gadget}
{gadget:url=rest/gadgets/1.0/g/com.atlassian.confluence.plugins.gadgets:confluence-news-gadget/gadgets/confluence-news-gadget.xml}
{gadget}
ギャラリー マクロ
Forms a thumbnail gallery of all images attached to a page.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) Specify a title to be displayed above your gallery of pictures. Not specified. Sort order is ascending. Used in combination with the 利用可能な値: なし。並べ替え順が指定されていないため、順不同。 Specify an attribute to sort the images by. Sort order is ascending, unless you specify the 利用可能な値: ページが指定されていない場合、ギャラリー マクロはマクロが使用されているページに添付された画像を表示します。 No exclusions. The gallery will include all the pictures on the page. 4 Specify the number of columns for the table that forms the gallery. 除外なし。ページのすべての写真を含める。 Specify images by file name. The gallery will ignore any images specified. You can specify more than one image, separated by commas. ページのすべての写真を含める If you specifically include one or more pictures, the gallery will show only those pictures. You can specify more than one picture, separated by commas. gallery必須 title
いいえ リバース
いいえ sort parameter, to change the sort order from ascending to descending.true – 降順で並べ替え。false – 降順で並べ替え。並べ替え
いいえ reverse parameter.name – file name.comment – comment linked to the attached file.date – date/time last modified.size – size of the attached file.ページ
いいえ 表示する画像を含むページのタイトルを指定します。複数のページ名をカンマ区切りで指定できます。異なるスペースのページを指定するには、以下の構文を使用します: SPACEKEY:Page title.includeLabel いいえ なし。画像はラベルでフィルタリングされません。 The gallery will include only those pictures that have the specified label. If you wish to enter more than one label, separate the labels with commas. Confluence will show only images that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Adding Labels. excludeLabel いいえ The gallery will ignore any pictures that have the specified label. You can specify more than one label, separated by commas. For information on labelling the attachments, see Adding Labels. 列
いいえ excludeいいえ
Note: The file name and file type for this parameter are case sensitive. For example, 'my picture.PNG' will not be recognised as 'my picture.png'.includeいいえ
Note: The file name and file type for this parameter are case-sensitive. For example, 'my picture.PNG' will not be recognised as 'my picture.png'.
例:
{gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}
Global Reports macro
Displays a list of links to global reports within a table.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 99% リンクを表示する表の幅を、ウィンドウ幅のパーセンテージで指定します。global-reports必須 width
いいえ
例:
{global-reports:width=50%}
HTML Include macro
Includes the content of an external HTML file into a Confluence page.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) Specify a URL of the content to be included into your Confluence page.html-include必須 URL
はい
例:
{html-include:url=http://www.example.com}
HTMLマクロ
Renders your specified HTML code within the current page.
Macro name: Macro body: Text, consisting of HTML code. Parameters: None.html
例:
{html}<a href="http://www.atlassian.com">Click here</a> to see the <b>Atlassian</b> website.{html}
IM プレゼンス マクロ
Displays graphically when a contact is online.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 Determines whether the macro shows or hides the user ID of the contact. 利用可能な値: Not specified. The web service that Confluence should query. 利用可能な値: (Unnamed in wiki markup)im必須 showid
いいえ truetrue – User ID is shown on the page.false – User ID is not shown on the page.サービス
はい default-parameterはい Not specified. User ID. Identifies the IM contact by their ID, account name or screen name.
例:
{im:MySkypeName|service=skype|showid=false}
インクルード ページ マクロ
Inserts the contents of the specified page into the current one.
Macro name: マクロ本体: なし。 (Unnamed in wiki markup) The name of the page whose content should be included on the current page To includecontent from a page in another space, type the space key followed by a colon (:) and the page name, like this: To include a blog post, specify the date as well as the title of the blog post. For example: You can include pages from personal spaces using ~username as the space key, where 'username' is the person's username. For example, includeパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterはい (なし) SPACEKEY:My page name/2010/12/01/My blog post.~jsmith:My page name.
例:
{include:DOC:My chocolate page}
Info macro
Displays a block of text in a blue highlight box.
Macro name: Macro body: Accepts rich text.infoパラメーター名 必須 既定 パラメーターの説明と指定可能な値 iconいいえ trueDetermines whether to display the icon in the title bar of the information box.
titleいいえ (なし) The title of the information box. If specified, the title text will be displayed in bold next to the icon.
例:
{info:title=This is my title|icon=false}
This is _important_ information.
{info}
JIRA Issues macro
Displays one or more JIRA issues, and offers the option to create an issue in JIRA.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 いいえ If this parameter is set to 'true', JIRA will return only the issues which allow unrestricted viewing. That is, the issues which are visible to anonymous viewers, as determined by JIRA's viewing restrictions. If this parameter is omitted or set to 'false', then the results depend on how your administrator has configured the communication between JIRA and Confluence. By default, Confluence will show only the JIRA issues which the user is authorised to view. Note: This parameter is available only if you insert the macro via wiki markup or by editing the storage format of the page. The graphic user interface (macro browser) for the JIRA Issues macro does not offer this parameter. いいえ 'url' パラメーターの値 If you specify a 'baseurl', then the link in the header, pointing to your JIRA site, will use this base URL instead of the value of the 'url' parameter. This is useful when Confluence connects to JIRA with a different URL from the one used by other users. いいえ 既定では、次の列が表示されます。 A list of JIRA column names, separated by semi-colons (;). You can include any columns recognised by your JIRA site, including custom columns. See the JIRA documentation for a list of names. いいえ このパラメーターが 'true' に設定されている場合、課題リストには JIRA 課題の数が表示されます。カウントは JIRA サイトにリンクされます。 いいえ マクロは、JIRA クエリの結果の課題のキャッシュを保持します。'cache' パラメーターが 'off' に設定されている場合、キャッシュの関連部分は、マクロが再度ロードされるたびにクリアされます。(値 'false' も使用でき、 と同じ効果があります。) Note: This parameter is available only if you insert the macro via wiki markup or by editing the storage format of the page. The graphic user interface (macro browser) for the JIRA Issues macro does not offer this parameter. いいえ The height in pixels of the table displaying the JIRA issues. Note: This parameter is available only if you insert the macro via wiki markup or by editing the storage format of the page. The graphic user interface (macro browser) for the JIRA Issues macro does not offer this parameter. いいえ 値を「dynamic (動的)」にすると、JIRA 課題マクロは、ユーザーが次のように操作できるインタラクティブ ディスプレイを提供します。 'static' の値は、ダイナミック表示機能を無効化します。 Note: This parameter is available only if you insert the macro via wiki markup or by editing the storage format of the page. The graphic user interface (macro browser) for the JIRA Issues macro does not offer this parameter. はい なし The URL of the XML view of your selected issues in JIRA Issue Navigator. Note: If the URL in the 'url' parameter does not contain a いいえ 100% The width of the table displaying the JIRA issues. Can be indicated either as a percentage (%) or in pixels (px). Note: This parameter is available only if you insert the macro via wiki markup or by editing the storage format of the page. The graphic user interface (macro browser) for the JIRA Issues macro does not offer this parameter.jiraissuesanonymousfalsebaseurlcolumnscountfalsecacheonheight480 (レンダリング モードが dynamic の場合)
Note that this height specification is ignored in the following situations:renderModestaticurltempMax argument, then the value of tempMax will default to 500. If your JIRA server is version 3.12 or earlier, this means that the JIRA Issues macro will return a maximum of 500 issues. If your JIRA server is version 3.13 or later, a value of 500 means that the JIRA Issues macro will return a maximum of 500 issues per page.width
例:
{jiraissues:anonymous=true|url=http://jira.atlassian.com/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?jqlQuery=project+%3D+CONF+AND+%28summary+%7E+jiraissues+OR+description+%7E+jiraissues+OR+comment+%7E+jiraissues%29&tempMax=10|columns=type;key;summary|title=My List of Issues}
JUnit レポート マクロ
Display a summary of JUnit test results.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) URL of a directory containing your test result files. This must be a directory name and not the XML file itself. Overrides the Note: When using a local drive, you must use a directory name and not the XML file itself. Level of detail required in the report. 利用可能な値: (なし) URL of a particular test result XML file. This parameter is overridden by the For Confluence installations that require authentication, you can specify login credentials as part of this parameter, in the form of URL parameters: If the value of this parameter is junitreport必須 directoryMust include either the directory or the url parameterurl parameter if you use both.reportdetailいいえ allallfixturesummaryfailuresonlyurlMust include either the directory or the url parameterdirectory parameter if you use both.os_username — The username of a Confluence user with permission to access the JUnit test results.os_password — os_username パラメータで指定した Confluence ユーザーのパスワード。debugいいえ falsetrue, the report will show the content of failures, as well as the error messages.
例:
ローカル ドライブから JUnit レポートをロードする: If your Confluence site is not accessible by anonymous users, specify login credentials with the {junitreport:directory=file:///C:/TEMP/}
ネットワーク ドライブから JUnit レポートをロードする:{junitreport:url=http://*host*/*path*}
Confluence サイトから JUnit レポートをロードする:{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml}
認証が必要な Confluence サイトから JUnit レポートをロードする:os_username and os_password URL parameters (as part of the macro's url parameter). In this case, we are specifying a username of 'admin' and a password of 'secret'.{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml?os_username=admin&os_password=secret}
ラベル一覧マクロ
Displays a hyperlinked alphabetical index of all labels within the current space.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 現在のスペースlistlabels必須 spaceKeyいいえ ラベルを表示したいスペースのキー。
例:
{listlabels:spaceKey=DOC}
ライブサーチ マクロ
Add a dynamic search box to a wiki page.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (なし) すべてのスペースlivesearch必須 placeholderいいえ Specify the placeholder text to appear in the search field. labelsいいえ (なし) Specify labels to limit the search to content with that label. spaceKeyいいえ Specify a space key to limit the search to the given space. typeいいえ すべて Specify the content types to be included in the search - pages, blogs, comments, space descriptions, or all content types. sizeいいえ 中 Specify the size of the search field - medium or large. additionalいいえ Space Name Display the space name, a page excerpt or none under the search result.
例:
{livesearch:spaceKey=DOC|size=large|placeholder=Search this space}
Loremipsum macro
Display a few paragraphs of pseudo-Latin text.
Macro name: マクロ本体: なし。 パラメーター名 既定 パラメーターの説明と指定可能な値 (No name in wiki markup) 3loremipsum必須 default-parameterいいえ Number of paragraphs. Determines the amount of pseudo-Latin (space-filler) text to display. The macro will display a maximum number of 30 paragraphs.
例:
{loremipsum:2}
Multimedia macro
Displays videos, animations and more, sourced from a file attached to a Confluence page and displayed on your page.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 いいえ 現在のページ Name of the page to which the multimedia file is attached. いいえ 現在のスペース Space key of the page that has the multimedia file attached. はい なし File name of the multimedia file, which is attached to a Confluence page. いいえ 指定されていない場合、ブラウザーはファイルの種類に基づいて幅を決定します。 ページに表示されるムービー ウィンドウの幅。デフォルトでは、この値がピクセルで指定されます。また、ウィンドウの幅のパーセンテージや、HTML で使用可能なその他の値を指定するよう選択することもできます。 いいえ 指定されていない場合、ブラウザーはファイルの種類に基づいて高さを決定します。 ページに表示されるムービー ウィンドウの高さ。デフォルトでは、この値がピクセルで指定されます。また、ウィンドウの高さのパーセンテージや、HTML で使用可能なその他の値を指定するよう選択することもできます。 いいえ パラメータが multimediapagespacenamewidthheightautostartfalsetrue に設定されている場合、ページの読み込みが完了するとすぐにビデオまたはオーディオ ファイルの再生が開始します。このオプションが false に設定されている場合、ユーザーがページのアイコンまたはイメージをクリックするまでファイルは再生されません。
例:
{multimedia:space=DOC|page=My macros|name=ninjas.swf|autostart=true}
ナビゲーションマップ マクロ
Displays a navigable map of the pages tagged with a given label.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 (Unnamed in wiki markup) いいえ The number of cells in a row. いいえ (なし) A title for the navigation map. いいえ Height of the cells, in pixels. いいえ Width of the cells, in pixels. いいえ (なし) Not applicable to Confluence OnDemand. The name of a Velocity template that defines a theme for the navigation map. The name of your theme file must have the following format: Put your theme file in the navmapdefault-parameterはい (なし) The label that pages must contain to be included in the navigation map. wrapAfter5titlecellHeight60cellWidth90themenavmap-mytheme.vm, where mytheme is the name of your theme. That is also the value to use for the theme parameter of the macro. For example, if your theme file is navmap-roundededges.vm, use the value roundededges for this parameter.confluence/WEB-INF/classes/templates/macros directory, in your Confluence installation. (Create the directory if it does not exist.)
例:
{navmap:mylabel|wrapAfter=4|title=My map name|cellHeight=50px|theme=navmap-mytheme.vm|cellWidth=80px}
ネットワーク マクロ
Displays a list of Network activity for users on your Confluence site.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 (Unnamed in wiki markup) The display mode, which determines the set of users to be listed, based on their relationship to the specified user: いいえ 現在のユーザーのユーザー名 The username of the Confluence user whose network interactions you wish to show. いいえ The maximum number of users to show. If the number of users exceeds the specified maximum, then the macro provides a 'Show All' link. This link leads to the specified user's network view, showing the complete list of network interactions. いいえ ユーザーのネットワークの表示方法を指定します。networkdefault-parameterはい followingfollowing – those whom the user is following.followers – those who are following the user.usernamemax30themefullfull – Shows a large version of user's profile pictures. If the display mode is set to 'following', the macro offers the option to follow more users.tiny – Shows only the small version of user's profile pictures.
例:
{network:followers|username=admin|max=10|theme=full}
Noformat macro
Displays a block of text in monospace font.
Macro name: Macro body: Accepts plain text. Determines whether the macro draws a box around the content. 利用可能な値:noformatパラメーター名 必須 既定 パラメーターの説明と指定可能な値 nopanelいいえ falsetrue – Box is removed. In other words, there is no panel.false – Box is drawn. In other words, there is a panel.
例:
{noformat:nopanel=true}http://www.example.com{noformat}
Note macro
Displays a block of text in a yellow highlighted box.
Macro name: Macro body: Accepts rich text. Determines whether an icon appears next to the title. The icon is an exclamation mark inside a yellow triangle. 利用可能な値:noteパラメーター名 必須 既定 パラメーターの説明と指定可能な値 titleいいえ (なし) The words that will appear in the header of the note block. iconいいえ truetrue – the icon appearsfalse – the icon does not appear
例:
{note:icon=false|title=My title}
This is the content of my note.
{note}
Office Excel マクロ
Displays the content of an Excel spreadsheet on a wiki page.
Macro name: viewxls マクロ本体: なし。 表示する Excel スプレッドシートのファイル名。ドキュメントは、Confluence サイトのページに添付する必要があります。 表示する最後の列の番号 (最初の列として '0' から始まる)。 Hint for reducing the size of the spreadsheet: Use the Determines whether the macro will show borders around the cells in the spreadsheet. 許可される値:パラメーター名 必須 既定 パラメーターの説明と指定可能な値 nameはい (なし) pageいいえ マクロを含むページ Excel スプレッドシートが添付されている Confuence ページの名前。 colいいえ コンテンツの最後の列 col and row parameters to reduce the size of the spreadsheet displayed on the wiki page. This is especially useful to prevent the display from showing empty cells. This will also help to prevent 'out of memory' errors.rowいいえ コンテンツの最後の行 表示する最後の行の番号 (最初の行として '0' から始まる)。 gridいいえ truetrue – Shows borders.false – Does not show borders.sheetいいえ 最近表示したワークシート 表示するワークシートの名前。
例:
{viewxls:col=5|page=Docs|name=My document.xls|grid=false|sheet=mysheet|row=5}
Office PowerPoint macro
Displays the content of a PowerPoint presentation on a wiki page.
Macro name: マクロ本体: なし。 表示する PowerPoint プレゼンテーションのファイル名。ドキュメントは、Confluence サイトのページに添付する必要があります。viewpptパラメーター名 必須 既定 パラメーターの説明と指定可能な値 nameはい (なし) pageいいえ マクロを含むページ PowerPoint プレゼンテーションが添付されているされている Confluence ページの名前。 heightいいえ ピクセル (例: 10px または 10) またはウィンドウの高さに対するパーセンテージ (例: 20%) で指定された、マクロ表示の高さ。widthいいえ ピクセル (例: 10px または 10) またはウィンドウの高さに対するパーセンテージ (例: 20%) で指定された、マクロ表示の幅。slideいいえ All slides, starting with the first, as a slide show The number of the slide that you want displayed on the Confluence page, where the first slide is numbered zero. Instead of a slide show, the page will display just the single slide, represented as a JPEG image.
例:
{viewppt:height=20%|page=Docs|width=20%|name=My document.ppt|slide=4}
Office Word マクロ
Displays the content of a Word document on a wiki page.
Macro name: マクロ本体: なし。 表示する Word ドキュメントのファイル名。ドキュメントは、Confluence サイトのページに添付する必要があります。viewdocパラメーター名 必須 既定 パラメーターの説明と指定可能な値 nameはい (なし) pageいいえ マクロを含むページ Word ドキュメントが添付されている Confuence ページの名前。
例:
{viewdoc:page=Docs|name=My document.doc}
Page Index macro
Creates a hyperlinked alphabetical index of all page titles within the current space.
Macro name: マクロ本体: なし。 Parameters: None.index
例:
{index}
Page Properties macro
Allows you to embed metadata into a page and then display that data in tabular form using the Page Properties Report macro .Previously known as the Metadata Details macro.
Macro name: Macro body: Accepts rich text.detailsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 hiddenいいえ falseページ プロパティ マクロのデータを現在のページに表示するかどうかを決定します。この設定は、ページ プロパティ レポート マクロの詳細表示に影響しません。 labelいいえ (なし) The label used to identify the metadata on this page. Confluence will add this label to the page.
例:
{details:hidden=true|label=status}
Project Status: Complete
Team: Green Parrots
Deadline: 2012-09
{details}
ページプロパティ レポート マクロ
Presents a tabulated summary of selected metadata, which has been embedded on pages using the Page Properties macro. Previously known as the Details Summary macro.
Macro name: マクロ本体: なし。detailssummaryパラメーター名 必須 既定 パラメーターの説明と指定可能な値 labelいいえ (なし) Identifies the metadata to be included in the Page Properties Report. The report will show data from the Page Properties macros on the pages in the current space that have this label on the page.
例:
{detailssummary:label=status}
Page Tree macro
Displays a dynamic, hierarchical list of pages starting from a specified parent (root) page.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 Determines whether the page tree will show excerpts from each page. The excerpts must be defined on the individual pages by the Excerpt macro. 利用可能な値: Determines whether the macro will offer the 'expand all' and 'collapse all' options at the top of the page tree. Your readers can click these links to open or close all branches of the tree at once. 利用可能な値: Used in combination with the 利用可能な値: Specifies the parent page for the page tree. The tree will include all children of the given page, plus their children and grand-children, and so on. The tree will not include the root page itself. Determines whether the macro will offer a search box above the page tree. The search box allows your readers to enter a search term, and then searches within the page tree for the specified value. 利用可能な値: Determines the order in which pages are displayed in the tree. This sort order is for display purposes only. It does not permanently re-arrange the page order. 利用可能な値: Indicates how many levels of children the tree should show when it opens for the first time. Available values: Any number greater than 0.pagetreeexcerptいいえ falsetrue – Show excerpts.false – Do not show excerpts.expandCollapseAllいいえ falsetrue – "すべて展開" および "すべて折りたたみ" オプションを表示する。false – オプションを表示しない。reverseいいえ falsesort parameter. Determines the order of pages displayed in the tree, by reversing the default (ascending) order.true – Pages will be displayed in descending order by title.false – Pages will be displayed in ascending order by title.rootいいえ スペースのホームページ
Available values:@home – will include all pages under the home page of the space (default).@self – will include all pages under the current page.@parent – will include all pages under the parent of the current page, including the current page.@none – will include all pages in the space, including orphaned pages and the home page.searchBoxいいえ falsetrue – Include the search box.false – Do not include the search box.sortいいえ positionbitwise – sort alphabetically, for example: title1, title10, title2.creation – sort by date of creation.modified – sort by order of date last modified.natural – sort in 'natural' alphabetical order, for example: title1, title2, title10.position – sort by the default Confluence sorting rules. If your pages have been ordered manually, this sort will respect the defined order. Otherwise the pages will be displayed in the 'natural' alphabetical order, such as: title1, title2, title10.startDepthいいえ 1
例:
{pagetree:root=Page Name|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}
Page Tree Search macro
Adds a search box to your Confluence page and searches a hierarchy of pages starting from a specified parent (root) page.
Macro name: マクロ本体: なし。 パラメーター名 必須 既定 パラメーターの説明と指定可能な値 Specifies the parent page for the page tree. The tree will include all children of the given page, plus their children and grand-children, and so on. The tree will not include the root page itself. pagetreesearchrootいいえ スペースのホームページ
Note: Unlike the Page Tree macro, the Page Tree Search macro does not accept the special values that start with an @ sign, such as @home or @self.
例:
{pagetreesearch:root=My page name}
Panel macro
Displays a block of text within a customisable panel.
Macro name: Macro body: Accepts rich text. The style of the panel's border. 許可される値:panelパラメーター名 必須 既定 パラメーターの説明と指定可能な値 titleいいえ (なし) The words that will appear in the header of the panel. borderStyleいいえ solid soliddashedborderColorいいえ The colour of the panel's border. Colours can be specified as HTML colour names or hexadecimal codes. borderWidthいいえ The width of the panel's border, in pixels. bgColorいいえ The background colour of the panel. Colours can be specified as HTML colour names or hexidecimal codes. titleBGColorいいえ The background colour of the title row of the panel. Colours can be specified as HTML colour names or hexadecimal codes. titleColorいいえ The colour of the text in the title row of the panel. Colours can be specified as HTML colour names or hexadecimal codes.
例:
{panel:title=My title|borderStyle=dashed|borderColor=blue|titleBGColor=#00a400|titleColor=white|bgColor=#72bc72}
A formatted panel
{panel}
PDF macro
Displays the content of a PDF document on a wiki page.
Macro name: viewpdf マクロ本体: なし。 表示するPDF ドキュメントのファイル名。ドキュメントは、Confluence サイトのページに添付する必要があります。パラメーター名 必須 既定 パラメーターの説明と指定可能な値 nameはい (なし) pageいいえ マクロを含むページ PDF ドキュメントが添付されている Confuence ページの名前。
例:
{viewpdf:page=Docs|name=My document.pdf}
人気ラベルマクロ
Displays the most popular labels used throughout your Confluence site or within a space.
Macro name: マクロ本体: なし。 Determines how the macro displays the labels. 許可される値:popular-labelsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 styleいいえ list list – displays the labels as a bullet list, ordered by popularity (highest first).heatmap – displays the labels using different font sizes for each label depending on the label's popularity, ordered alphabetically by label name.countいいえ 100The number of labels to display. spaceKeyいいえ No restriction – include labels from all spaces in the site If a space key is given, the macro will include only labels in that space.
例:
{popular-labels:style=heatmap|count=20|spaceKey=ds}
Profile Picture macro
このマクロでは Wiki マークアップは使用できません。Wiki マークアップを使用して、このマクロを追加することはできません。
Recently Updated Dashboard macro
Displays a list of the most recently changed content within Confluence and is intended for use on the Confluence dashboard.
Macro name: マクロ本体: なし。 Filters content by space. The macro will display only the pages and other content which belong to the space(s) you specify here. 許可される値: Filters by username of the user who updated the content. The macro will only display content created and updated by the user(s) you specify here. You can specify one or more usernames separated by commas. Determines whether the macro displays profile pictures of the users who updated the content. 許可される値: Filters content by label. The macro will display only the pages and other content which are tagged with the label(s) you specify here. You can specify one or more labels, separated by commas. Note: If there are no pages matching any of the specified labels, then Confluence will ignore the labels and will list all recently updated pages, as well as showing a message, "These labels don't exist and were ignored: xxx ". Filters content by type. You can specify one or more types, separated by commas. 許可される値:recently-updated-dashboardパラメーター名 必須 既定 パラメーターの説明と指定可能な値 spacesいいえ The space that contains the page on which the macro is added. usersいいえ All users. widthいいえ 100% The width of the macro display, specified as a percentage of the window width. showProfilePicいいえ falsetrue – the macro will show profile pictures.labelsいいえ None. Labels are not used to filter the content. typesいいえ All content types. pageblogpost または newsspacedescattachmentcommentmailuserinfo
例:
{recently-updated-dashboard:spaces=ds|users=admin|width=50%|showProfilePic=true|labels=choc|types=page}
最近の更新マクロ
Displays a list of recently changed content (pages, news items, comments, etc).
Macro name: マクロ本体: なし。 Filters content by space. The macro will display only the pages and other content which belong to the space(s) you specify here. 特別な値: 個人用スペースを指定する場合、 Filters by the username of the user who updated the content. The macro will only display content created and updated by the user(s) you specify here. To include content from one user, but exclude from another user: The maximum number of results to be displayed. The theoretical maximum value that this parameter can accept is 2 to the power of 31, minus 1 (or 2147483647). But this maximum is limited to 200 in the code, for performance reasons. More details are in this issue: CONF-19096 Determines whether the macro hides or displays the text 'Recently Updated' as a title above the list of content. 許可される値: Choose the appearance of the macro. 許可される値: Determines whether the macro displays profile pictures of the users who updated the content. 許可される値: Filters content by label. The macro will display only the pages and other content which are tagged with the label(s) you specify here. You can specify one or more labels, separated by commas. Note: If there are no pages matching any of the specified labels, then Confluence will ignore the labels and will list all recently updated pages, as well as showing a message, "These labels don't exist and were ignored: xxx ". 結果をラベルで絞り込みます。ここで指定したラベル (複数可) でタグ付けされているページ等のみがマクロで表示されます。 Filters content by type. You can specify one or more types, separated by commas. 特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを 利用可能な値:recently-updatedパラメーター名 必須 既定 パラメーターの説明と指定可能な値 spacesいいえ The space that contains the page on which the macro is added.
-BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。+GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。@self — 現在のスペース。@personal — All personal spaces.@global — All site spaces.@favorite — The spaces you have marked as favourite.@favourite — 上記の @favorite と同様。@all — Confluence サイトのすべてのスペース。* — 上記の @all と同様。~jbloggs や ~jbloggs@example.com のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。authorいいえ All users. jsmith,jbrown jsmith,!jbrownmaxいいえ 15hideHeadingいいえ falsetrue – タイトルは非表示になります。false – タイトルは表示されます。widthいいえ 100%The width of the macro display, specified as a percentage of the window width. themeいいえ conciseconcise – The default list, showing the names of pages which were updated or commented on, the users who made the page modifications, and time when the modifications occurred.social – Shows recent modifications in reverse chronological order, grouped by user in short time segments. A sub list appears within each user's time segment, showing the names of pages which they updated or commented on and the time when these modifications occurred.sidebar – Lists recent updates in reverse chronological order, showing the names of pages which were updated or commented on and time when the page modifications occurred. This theme does not show authorship.showProfilePicいいえ falsetrue – the macro will show profile pictures.labelsいいえ None. Labels are not used to filter the content.
カンマまたはスペースで区切ることで、1 つ以上のラベル値を指定できます。
-badpage you will get only content which is not labelled with 'badpage'.+superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。typesいいえ All content types. -blogpost と指定すると、ページと、ブログ投稿を除くその他すべてのコンテンツを取得できます。page — Pages.blogpost or news — Blog posts, also known as news items.comment — Comments on pages and blog posts.attachment — Attachments.status — Status updates made by other users.
例:
{recently-updated:spaces=ds|author=admin|max=10|hideHeading=true|width=50%|theme=sidebar|showProfilePic=true|labels=choc|types=page}
最近使用したラベルマクロ
Lists labels most recently used in a specified scope (global, space, or personal)
Macro name: マクロ本体: なし。 The scope of labels to be displayed in the list. 許可される値: The style of the list of labels:recently-used-labelsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 titleいいえ なし。 Adds a title to the top of the list in table style. Titles are only visible when the style parameter is set to table.scopeいいえ globalglobal – All spaces (non-personal) in the Confluence installation.space – The current space.personal – Your own personal space.styleいいえ listlist – Displays the list of labels horizontally.table – Includes additional information such as the page to which the label was added and the user who added it.countいいえ 10The maximum number of labels to display in the list.
例:
{recently-used-labels:title=My title|scope=space|style=table|count=20}
関連ラベル マクロ
Lists labels frequently appearing on the same pages as the current page's labels.
Macro name: related-labels マクロ本体: なし。パラメーター名 必須 既定 パラメーターの説明と指定可能な値 labelsいいえ なし The label(s) for which you want to view related labels. If you include more than one label, separate them with commas.
例:
{related-labels:labels=choc,cake}
RSS Feed macro
Displays the contents of an RSS feed.
Macro name: rss マクロ本体: なし。 Determines whether the macro will show only the titles of the news items, or the titles plus content. 許可される値: Determines whether the macro will show a title above the list of news items. 許可される値:パラメーター名 必須 既定 パラメーターの説明と指定可能な値 maxいいえ 15The maximum number of news items to display. showTitlesOnlyいいえ falsetrue – Displays titles only.false – Displays titles and content.urlはい (なし) The URL of the RSS feed. titleBarいいえ truetrue – Displays the title.false – Does not display a title.
例:
{rss:max=10|showTitlesOnly=true|url=http://myblog.com/feed|titleBar=false}
検索結果マクロ
Searches Confluence, and includes the results in the page.
Macro name: マクロ本体: なし。 Defines a period of time in weeks, days, hours and/or minutes. The macro will display the content modified within that time frame. 例: メモ: The search terms which this macro will use to generate its results. You can refine your search query by using operators such as 'AND' and 'OR'. For example: For more information, take a look at the documentation on the Confluence search syntax. The type of content to include in the search results. 許可される値:searchパラメーター名 必須 既定 パラメーターの説明と指定可能な値 lastModifiedいいえ (なし) w = 週d = 日h = 時間m = 分2h 35m3d 30m4d" と "4D" は同じです。queryはい (なし) my_term1 AND my_term2contributorいいえ (なし) The username of a Confluence user. If this parameter is present, the macro will show only content created or updated by the given user. maxLimitいいえ 10The maximum number of search results to display. typeいいえ (なし) pagecommentblogpostattachmentuserinfo – the content of user profilesspacedesc – the content of space descriptions
例:
{search:lastModified=3w|query=choc|contributor=admin|maxLimit=10|type=page|spacekey=ds}
Section macro
Used with the Column macro to define columns on a page. See Working with page layouts and columns and sections.
Macro name: Macro body: Rich text, consisting of one or more Column macros.sectionパラメーター名 必須 既定 パラメーターの説明と指定可能な値 borderいいえ False 値が true の場合、このセクションの列の枠線は破線になります。
例:
{section:border=true}
{column:width=100px}
This is the content of *column 1*.
{column}
{column}
This is the content of *column 2*.
{column}
{section}
Space Attachments macro
Displays a list of attachments belonging to the current space.
Macro name: マクロ本体: なし。 フィルター パネルを表示するかどうかを決定します。このオプションを選択した場合、ページを閲覧する人物はファイルタイプ別 (拡張子) またはラベル別に添付ファイルのリストにフィルターをかけることができます。 許可される値:space-attachmentsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 showFilterいいえ truetrue – Macro displays the filter panel.false – Macro does not display the filter panel.spaceいいえ Current space. Determines the Confluence space containing the attachments that the macro will display.
例:
{space-attachments:showFilter=false|space=ds}
スペース詳細マクロ
Displays the details of a Confluence space, including the space name, description, and more.
Macro name: マクロ本体: なし。space-detailsパラメーター名 必須 既定 パラメーターの説明と指定可能な値 widthいいえ 100%The width of the space details table, specified as a percentage of the page width.
例:
{space-details:width=50%}
Space Jump macro
Allows you to link from a page in one space to a page with the same name in another space, without knowing the name of the page when you create the link.
Macro name: マクロ本体: なし。spacejumpパラメーター名 必須 既定 パラメーターの説明と指定可能な値 aliasいいえ The name of the current page The text to display as the hyperlinked text. spaceはい (なし) The key of the space that contains a page with the same name as the current page. Space keys are case sensitive.
例:
{spacejump:alias=my link|space=ds}
Spaces List macro
Displays a list of the spaces visible to the user.
Macro name: マクロ本体: なし。 (Unnamed in wiki markup) Specify the view from which spaces are listed. 許可される値:spacesパラメーター名 必須 既定 パラメーターの説明と指定可能な値 default-parameterいいえ すべてのスペース all – All spaces in the Confluence site.category – Spaces grouped according to space categories.favourite – Spaces in the reader's list of favourites.new – Spaces created within the last 7 days.widthいいえ 100%The width of the list of spaces, specified as a percentage (%) of the window.
例:
{spaces:favourite|width=80%}
ステータス マクロ
Displays a coloured lozenge, useful for reporting project status.
Macro name: マクロ本体: なし。 The colour of the lozenge. Accepted values: The style of the lozenge and its border. 許可される値:statusパラメーター名 必須 既定 パラメーターの説明と指定可能な値 colourいいえ GreyGrey, Red, Yellow, Green, Bluetitleいいえ The value of the colour parameterThe text that will appear inside the lozenge. If you do not specify any text, the title will be the colour of the lozenge, that is 'Grey', 'Red', 'Yellow', 'Green' or 'Blue'. subtleいいえ falsefalse – The lozenge will have the default style: a solid coloured background with white text.true – The lozenge will have the outline, or subtle, style: a white background with a coloured border and coloured text.
例:
{status:colour=Green|title=On track|subtle=true}
コンテンツ テーブル マクロ
Displays a table of contents based on the headings on the page.
Macro name: マクロ本体: なし。 This parameter applies to vertical lists only ( Use this parameter to indent the list items according to CSS quantities. For example, a value of Specifies the headings to exclude by pattern matching. The value must be a regular expression. If this parameter is specified, the table of contents will include only the headings that match the regular expression. Example: Defines the overall format of the table of contents. 利用可能な値: This parameter applies to flat lists only ( 利用可能な値: Specifies the headings to include by pattern matching. The value must be a regular expression. If this parameter is specified, the table of contents will ignore any headings that do not match the regular expression. Example: See Sun's Regex documentation for examples of constructing regular expression strings.tocパラメーター名 必須 既定 パラメーターの説明と指定可能な値 printableいいえ trueIf you set this parameter to false, the table of contents will not be visible when you print the page.styleいいえ noneThe style of bullet point for each list item. You can use any valid CSS style. For example: none – No list style is displayed.circle – The list style is a circle.disc – The list style is a filled circle. This is the typical bullet list, and is the one we are using in this example list.square — The list style is a square.decimal — The list is numbered (1, 2, 3, 4, 5).lower-alpha — The list style is lower case, alphabetised (a, b, c, d, e).lower-roman — The list style is lower-case roman numerals (i, ii, iii, iv, v, vi).upper-roman — The list style is upper-case roman numerals (I, II, III, IV, V, VI).maxLevelいいえ 7Maximum heading level. Use this parameter to select the highest heading level to include. For example, a value of 2 will list h1 and h2 levels, but will not include h3 and below.indentいいえ (なし) type = list). 10px will successively indent list heading groups by 10 pixels. Level 1 headings will be indented 10px, and level 2 headings by an additional 10px, and so on.minLevelいいえ 1Minimum heading level. The heading level at which the table of contents will start. For example, a value of 2 will list h2, h3, and h4 headings, but will not include h1 headings.classいいえ (なし) A CSS class name. If you have a custom style sheet, you can use this parameter to output the table of contents with the specified class attribute. excludeいいえ (なし) .*\.[1//2]typeいいえ listlist – displays the table of contents in a vertical list.flat – displays a horizontal series of links. For example: [Heading 1] [Heading 2] [Heading 3].outlineいいえ falseA value of true will apply outline numbering to the headings as displayed in the table of contents. For example: 1.1, 1.2, 1.3.separatorいいえ bracketstype = flat). Use this parameter to style the display of a flat list. brackets – Each item is enclosed by square brackets: [ ].braces – Each item is enclosed by braces: { }.parens – Each item is enclosed by parentheses: ( ).pipe – The items are separated by a pipe: |***. If using a custom separator, be aware that text displays exactly as entered, with no additional white space to further separate the characters.includeいいえ (なし) .*\.[1//2]
例:
この例は、リスト タイプの目次を示しています。 この例では、目次のフラット テーブルを示しています。{toc:printable=true|style=square|maxLevel=2|indent=5px|minLevel=2|class=bigpink|exclude=[1//2]|type=list|outline=true|include=.*}
{toc:printable=true|maxLevel=2|minLevel=2|class=bigpink|exclude=[1//2]|type=flat|outline=true|separator=pipe|include=.*}
Table of Content Zone macro
Displays a table of contents from a defined page 'zone'.
Macro name: Macro body: Accepts rich text. Determines where the macro will display the table of contents, relative to the zone delineated by the macro. 許可される値: This parameter applies to vertical lists only ( Use this parameter to indent the list items according to CSS quantities. For example, a value of Specifies the headings to exclude by pattern matching. The value must be a regular expression. If this parameter is specified, the table of contents will include only the headings that match the regular expression. Example: Defines the overall format of the table of contents. 利用可能な値: This parameter applies to flat lists only ( 利用可能な値: Specifies the headings to include by pattern matching. The value must be a regular expression. If this parameter is specified, the table of contents will ignore any headings that do not match the regular expression. Example: See Sun's Regex documentation for examples of constructing regular expression strings.toc-zoneパラメーター名 必須 既定 パラメーターの説明と指定可能な値 locationはい bothtop – The table of contents appears at the start of the zone.bottom – The table of contents appears at the end of the zone.both – The table of contents appears at the start and end of the zone.printableいいえ trueIf you set this parameter to false, the table of contents will not be visible when you print the page.styleいいえ noneThe style of bullet point for each list item. You can use any valid CSS style. For example: none – No list style is displayed.circle – The list style is a circle.disc – The list style is a filled circle. This is the typical bullet list, and is the one we are using in this example list.square — The list style is a square.decimal — The list is numbered (1, 2, 3, 4, 5).lower-alpha — The list style is lower case, alphabetised (a, b, c, d, e).lower-roman — The list style is lower-case roman numerals (i, ii, iii, iv, v, vi).upper-roman — The list style is upper-case roman numerals (I, II, III, IV, V, VI).maxLevelいいえ 7Maximum heading level. Use this parameter to select the highest heading level to include. For example, a value of 2 will list h1 and h2 levels, but will not include h3 and below.indentいいえ (なし) type = list). 10px will successively indent list heading groups by 10 pixels. Level 1 headings will be indented 10px, and level 2 headings by an additional 10px, and so on.minLevelいいえ 1Minimum heading level. The heading level at which the table of contents will start. For example, a value of 2 will list h2, h3, and h4 headings, but will not include h1 headings.classいいえ (なし) A CSS class name. If you have a custom style sheet, you can use this parameter to output the table of contents with the specified class attribute. excludeいいえ (なし) .*\.[1//2]typeいいえ listlist – displays the table of contents in a vertical list.flat – displays a horizontal series of links. For example: [Heading 1] [Heading 2] [Heading 3].outlineいいえ falseA value of true will apply outline numbering to the headings as displayed in the table of contents. For example: 1.1, 1.2, 1.3.separatorいいえ bracketstype = flat). Use this parameter to style the display of a flat list. brackets – Each item is enclosed by square brackets: [ ].braces – Each item is enclosed by braces: { }.parens – Each item is enclosed by parentheses: ( ).pipe – The items are separated by a pipe: |***. If using a custom separator, be aware that text displays exactly as entered, with no additional white space to further separate the characters.includeいいえ (なし) .*\.[1//2]
例:
{toc-zone:printable=false|maxLevel=2|minLevel=2|location=top|type=flat|outline=true|separator=pipe}
Only headings within this block are included in the table of contents.
{toc-zone}
Tasklist macro
Displays a dynamic task list which can be modified in view mode.
Macro name: Macro body: Accepts wiki markup, for defining the tasks. Determines whether the macro allows users to lock individual tasks so that they cannot be changed. 許可される値: Determines whether Confluence will ask the user to confirm the deletion of a task. 許可される値:tasklistパラメーター名 必須 既定 パラメーターの説明と指定可能な値 titleいいえ Task ListThe title to be displayed above the list of tasks. enableLockingいいえ falsetrue – The task list offers the option to lock tasks.false – There is no option to lock a task.widthいいえ 530pxThe width of the task list, specified in pixels (for example: 200px) or as a percentage of page width (for example: 20%).promptOnDeleteいいえ falsetrue – Asks for confirmation before deleting a task.false – Deletes the task without asking for confirmation.
例:
Note: The content inside the macro body (between the { tasklist} tags) defines the tasks in the list. This content is coded in wiki markup, as a table.The first row in the table defines the column headings for the task list. Each subsequent row defines a task.{tasklist:title=My title|enableLocking=true|width=20%|promptOnDelete=true}
||Completed||Priority||Locked||CreatedDate||CompletedDate||Assignee||Name||
|F|M|F|1371784117215| |admin|Book tickets|
|F|M|F|1371784127222| |admin|Check passport expiry|
{tasklist}
Tip macro
Displays a block of text in a green box.
Macro name: Macro body: Accepts rich text.tipパラメーター名 必須 既定 パラメーターの説明と指定可能な値 iconいいえ trueDetermines whether to display the standard Confluence tip icon in the title bar of the tip box. titleいいえ (なし) The title of the tip box. If specified, the title text will be displayed in bold next to the icon.
例:
{tip:icon=false|title=My title}
This is my hint.
{tip}
User List macro
Displays a list of Confluence users in a given group.
Macro name: マクロ本体: なし。 One or more groups containing the Confluence users that the macro will list. 許可される値: Instructs the macro to differentiate between online and offline users. 許可される値: Note: In order to make this parameter functional, a System Administrator needs to enable the User Log In Listener for your Confluence site. Not applicable to Confluence OnDemand.userlisterパラメーター名 必須 既定 パラメーターの説明と指定可能な値 groupsはい (なし) * (an asterisk – The macro will list all users registered on the Confluence site.onlineいいえ 全てのユーザーが true –マクロはオンラインのユーザーのみを表示します。false – マクロはオフラインのユーザーのみを表示します。
例:
{userlister:groups=confluence-users|online=false}
User Profile macro
Displays a summary of a given Confluence user's profile.
Macro name: マクロ本体: なし。 プロフィールの概要を表示する Confluence ユーザーのユーザー名。profileパラメーター名 必須 既定 パラメーターの説明と指定可能な値 userはい (なし)
例:
{profile:user=admin}
User Status List macro
Displays a history of a given Confluence user's status updates.
Macro name: マクロ本体: なし。 The username of the Confluence user whose status updates you wish to show.status-listパラメーター名 必須 既定 パラメーターの説明と指定可能な値 usernameはい (なし)
例:
{status-list:username=admin}
Warning macro
Displays a block of text in a red highlight box.
Macro name: Macro body: Accepts rich text.warningパラメーター名 必須 既定 パラメーターの説明と指定可能な値 iconいいえ trueDetermines whether to display a warning icon in the title bar of the text box. titleいいえ (なし) The title of the warning box. If specified, the title text will be displayed in bold next to the icon.
例:
{warning:icon=false|title=This is my title}
This is _important_ information.
{warning}
Widget Connector macro
Displays videos, slide shows, twitter chats, documents and more, sourced from other web sites and displayed on your Confluence page.
Macro name: マクロ本体: なし。widgetパラメーター名 必須 既定 パラメーターの説明と指定可能な値 heightいいえ The height of the display, in pixels. Specify the number of pixels only. widthいいえ The width of the display, in pixels. Specify the number of pixels only. urlはい (なし) The URL provided by the external website for embedding content from that website onto another web page.
例:
{widget:height=400|width=400|url=http://www.google.com/ig/directory?synd=open&num=24&url=http://www.gadzi.com/gadgets/monkey.xml&output=html}
注意
- [Required (必須)] 列は、データ入力時にパラメーターが必要かどうかを示します。パラメーターが指定されていない場合、Confluence は [デフォルト] 列に示されているように既定値を挿入します。
- Wiki markup is not case sensitive. For example, you can specify a parameter name of
sortByorsortby. - For a few macros in wiki markup, the default parameter may be unnamed. The examples on this page show the macros concerned. In such cases, the unnamed parameter is always the first parameter specified.
- A request from the Atlassian technical writers about comments and feedback: We would like to distinguish between the documentation of the current solution (this page) and any discussion of the solution and possible changes to Confluence wiki markup and/or the XHTML-based storage format. If you have a suggestion for, or correction of, this documentation, please add your suggestion to this page.
