Confluence Wiki Markup for Macros

利用可能な値:

• false - Displays only the latest version of each attachment.
• true – Displays all versions of each attachment, including the old versions.

正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:

• "jpg" のファイル拡張子を検索するには「.*jpg」を使用します (「*.jpg」ではありません )。
• 「jpg」または「png」で終わるファイル名を検索するには、「.*jpg」、「.*png」を使用します。

Here is a tutorial on regular expressions.

利用可能な値:

• date
• size
• name

The default sort order is determined by the sortBy type:

• Reverse chronological for 'date'.
• Largest to smallest for 'size'.
• Alphabetical for 'name'.

利用可能な値:

• ascending
• descending

利用可能な値:

• entire – Display the whole content of each blog post.
• excerpts – Display a short extract from each blog post.
• titles – Display a list of blog posts, showing titles only.

One or more space keys, separated by a comma or a space.

• 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。
• 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。

特別な値:

• m — 分
• h — Hours
• d — Days
• w — 週

例:

• time=12h – Display blog posts created in the last twelve hours.
• time=7d  – Display blog posts created in the last seven days.

利用可能な値:

• タイトル — タイトルのアルファベット順で並べ替え
• 作成日 - コンテンツが追加された日付で並べ替え。
• 更新日 - コンテンツが最後に更新された日付で並べ替え。

One or more label values, separated by a comma or a space.

• To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
• 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

表示するチャートの種類。XY グラフは x 軸と y 軸の数値軸を持ちます。x の値は必要に応じて時間ベースにできます。timeSeries パラメーターをご参照ください。

利用可能な値:

• 標準グラフ - pie, bar, line, area
• XY プロット – xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries
• Other charts – gantt (beta)

表示の向き。area、bar、および line チャートに適用されます。

利用可能な値:

• vertical - y 軸が垂直軸
• horizontal - x 軸が垂直軸

3 次元で表示します。area、bar、および line チャートに適用されます。

• 3D チャートの場合 75 パーセント
• 非積み上げの area チャートの場合 50 パーセント
• 他のすべてのチャートは 100 パーセント

データ表で構成される、マクロ本文を表示するかどうかを決定します。既定では、チャートのデータ表は表示されません。

利用可能な値:

• false - データは表示されません。
• true または after - データがチャートのあとに表示されます。
• before – - データがチャートの前に表示されます。

チャートに使用される画像のフォーマット。

利用可能な値:

• png
• jpg

コンテンツの向きです。既定では、データ表の (水平方向の) 列が定義域および x の値を表していると解釈されます。

利用可能な値:

• vertical  - データ表の列が系列と解釈されます。
• horizontal – データ表の行が系列と解釈されます。

"true" の場合、XY プロットの x の値は時系列データとして扱われるため、日付形式に変換されます。

時系列データに使用される期間。データの解釈粒度を定義します。

利用可能な値: millisecond, second, minute, hour, day, week, month, quarter, year

ロケールを形成するために、country パラメータと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。

Available values are the two-character ISO 639-1 alpha-2 codes.

マクロがデータ形式エラーを容認 (許可) するかどうかを決定します。

利用可能な値:

• true - マクロは、既定の形式またはユーザ指定の表示形式に完全に一致しない数値および日付の値の変換を試みます。
• false — マクロは厳密なデータ形式を適用します。データ形式エラーが生じると、グラフは作成されません。

カテゴリの軸ラベルのテキストの位置。

利用可能な値:

• up45 - 45 度上向き
• up90 - 90 度上向き
• down45 - 45 度下向き
• down90 - 90 度下向き

日付の目盛りの位置。

利用可能な値:

• start - 目盛りをその期間の開始に表示します。
• middle - 目盛りをその期間の中間に表示します。
• end - 目盛りをその期間の終了に表示します。

• %0% は円グラフ セクションのキーで置換されます。
• %1% は円グラフ セクションの数値で置換されます。
• %2% は円グラフ セクションのパーセント値で置換されます。

例 1: "Independent = 20" のように表示するには、次のようにします。

%0% = %1%

例 2: "Independent = (20%)" のように表示するには、次のようにします。

%0% (%2%)

名前とグラフ画像が添付ファイルとして保存される場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。

このパラメータで利用可能な構文は次のとおりです。

• ^attachmentName.png — チャートは現在のページに添付ファイルとして保存されます。
• page name^attachmentName.png — チャートは指定したページ名に添付ファイルとして保存されます。
• spacekey:page name^attachmentName.png — チャートは、指定されたスペースの指定されたページ名に添付ファイルとして保存されます。

保存されたチャートのバージョン管理方法を定義します。

利用可能な値:

• new — 新しいバージョンの添付ファイルを作成します。
• 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 — 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。

 true の場合、チャート画像の添付ファイルがサムネイル (小さいサイズ、拡大可能) として表示されます。

Determines the sort order of the list of child pages.

利用可能な値:

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

A heading style to be applied to the list of child pages.

Available values: h1 (heading level 1) through to h6 (heading level 6).

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:
MYSPACE:My page

If the value of this parameter is a forward slash (/) the macro will list the pages at the root of the current space. In other words, the pages without parents.

If true, Confluence will display all levels of child pages. This setting will override the depth setting.

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 Confluence (also known as Default), which is typically black and coloured text on a blank background.

Available themes:

• DJango
• Emacs
• FadeToGrey
• Midnight
• RDark
• Eclipse
• Confluence (same as default)


If true, a line number will be shown to the left of each line of code. Numbering is incremented by 1.

If false, no line numbers are shown.

Specifies the language (or environment) for syntax highlighting.

• (none) — that is, no syntax highlighting
• actionscript3
• bash
• csharp — that is, C#
• coldfusion
• cpp — that is, C++
• css
• delphi
• diff
• erlang
• groovy
• java
• javafx
• javascript
• perl
• php
• powershell
• python
• ruby
• scala
• sql
• vb — that is, Visual Basic
• html/xml

If true, 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.

If false, the code macro's content is always displayed in full.

width

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.

You can specify one or more space keys, separated by a comma or a space.

• 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。
• 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。

特別な値:

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.

You can specify one or more authors, separated by a comma.

• タイトル — タイトルのアルファベット順で並べ替え
• 作成日 - コンテンツが追加された日付で並べ替え。
• 更新日 - コンテンツが最後に更新された日付で並べ替え。

• To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
• 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを -blogpost と指定すると、ページと、ブログ投稿を除くその他すべてのコンテンツを取得できます。

利用可能な値:

• page — ages.
• blogpost or news — blog posts, also known as news items.
• attachment – attachments.

default-parameter

(Unnamed in wiki markup)

limit

(なし)

Limits the number of contributors displayed in the list.

spaces

現在のスペース

Specifies the space key of the Confluence space to search. Space keys are case sensitive.

Special values:

• @global — All global spaces.
• @personal — All personal spaces.
• @all — All spaces in the Confluence site.

You can specify one or more space keys or special values, separated by commas.

If no page and labels are specified, all pages from the specified set of spaces are included.

reverse

false

Reverses the order of contributors in the list. Must be used in conjunction with the order parameter.

scope

The specified page only

Specifies additional pages to include when generating the list of contributors.

利用可能な値:

• children – only the child pages of the specified page.
• descendants – all descendants of the specified page.

labels

(なし)

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.

false

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.

showCount

false

Determines whether the macro will show the number of times each person made a contribution.

contentType

Both pages and blog posts

Restricts the content type that the macro will use when generating the list of contributors.

利用可能な値:

• pages – pages

• blogposts – blog posts.

include

authors

ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。

• authors - ページを作成または編集したユーザーを含む
• comments - ページにコメントしたユーザーを含む
• labels - ページにラベルを追加したユーザーを含む
• watches - includes people who are watching the page(s).

You can specify one or more contribution types, separated by commas.

mode

inline

Determines how the list of contributors is formatted:

• inline — a comma-separated list
• list — a bullet list.

showAnonymous

false

Determines whether to include those who contributed anonymously to a page.

order

count

投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。

• count – sorts the names based on the total number of contributions to the page(s)
• name – sorts the names into alphabetical order
• update – sorts the names by the date of their last contribution to the page(s).

ページ

The current page

Specifies the page to use when generating the list of contributors. If page and spaces are left blank, the current page is assumed.

showLastTime

false

Determines whether to show the last time each person made a contribution.

publishDate

(None)e

Specifies the publication date for a blog post. The date format required is: YYYY/MM/DD.

limit

(なし)

Limits the number of contributors or pages displayed in the table.

spaces

現在のスペース

Specifies the space key of the Confluence space to search. Space keys are case sensitive.

Special values:

• @global — All global spaces.
• @personal — All personal spaces.
• @all — All spaces in the Confluence site.

You can specify one or more space keys or special values, separated by commas.

If no page and labels are specified, all pages from the specified set of spaces are included.

reverse

false

Reverses the order of items in the table. Must be used in conjunction with the order parameter.

showAnonymous

false

Determines whether to include those who contributed anonymously to a page.

scope

The specified page only

Specifies additional pages to include when generating the list of contributors.

利用可能な値:

• children – only the child pages of the specified page.
• descendants – all descendants of the specified page.

order

edits

Sets the criterion used for sorting items in the table.

利用可能な値:

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

ページ

The current page

A page title. Specifies the page to use when generating the list of contributors. If page and spaces are left blank, the current page is assumed.

labels

(なし)

Limits contribution-based statistics to the specified labels only. You can specify one or more labels, separated by commas.

列

edits,comments,labels

Determines the columns that should appear in the table. The statistics or type of information presented depends on the groupby 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.

You can specify one or more columns, separated by commas.

groupby

投稿者ベース統計をグループ化する基準を指定します：

• contributors – group by the people who have contributed.
• pages – group by the pages used to find the contributors.

contentType

Both pages and blog posts

Restricts the content type that the macro will use when generating the list of contributors.

利用可能な値:

• pages – pages

• blogposts – blog posts.

publishDate

(なし)

Specifies the publication date for a blog post. The date format required is: YYYY/MM/DD.

default-parameter

(Unnamed in wiki markup)

border

• 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).

This parameter applies to vertical lists only (type = list). 

Use this parameter to indent the list items according to CSS quantities. For example, a value of 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.

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: .*\.[1//2]

Defines the overall format of the table of contents.

利用可能な値:

• list – displays the table of contents in a vertical list.
• flat – displays a horizontal series of links. For example: [Heading 1] [Heading 2] [Heading 3].

This parameter applies to flat lists only (type = 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: |
• anything – The items are separated by the value you enter. You can enter any text as a separator, for example ***. If using a custom separator, be aware that text displays exactly as entered, with no additional white space to further separate the characters.

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: .*\.[1//2]

 See Sun's Regex documentation for examples of constructing regular expression strings.