Using a macro, you can add extra functionality or include dynamic content on a page. For example, the Attachments macro will list a page's attachments in the page itself, so that readers do not have to visit the Attachments tab.

Adding a Macro to your Page

マクロ ブラウザを使用してマクロを含める

ページにマクロを追加する方法

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

マクロ パラメーター

Many macros allow you to include optional parameters to control the macro's output.

例えば、添付ファイル マクロにはオプションのパラメーターが 2 つあり、これによって次のことが可能です。

  • Specify the file formats of the attachments displayed.
  • Choose whether or not you want old versions of the attachments displayed.

マクロ プレースホルダー

マクロ プレースホルダーはエディタ内に表示され、ページにマクロを追加した場所を示します。

ページの編集時に次の操作が可能です。

  • Double-click a macro placeholder (or click the placeholder and choose Edit) to open the macro dialog window, where you can edit the macro's parameters.
  • Select a macro placeholder to cut, copy and paste the macro.

Macros Shipped with your Confluence Installation

When you download your Confluence installation file, many macros are shipped with the download. Below is a list of the macros currently shipped with Confluence. Click a macro name for details of the usage, including optional parameters and examples.

アクティビティ ストリーム マクロ
アンカー マクロ

Allows you to link to a specific part of a page.

添付ファイル マクロ

Displays a list of attachments on a given page.

ブログ投稿マクロ

Lists the most recent news items in the space.

変更履歴マクロ

Displays a history of updates made to a page.

チャート マクロ

Displays a chart based on tabular data.

チーズ マクロ

Displays the words "I like cheese!"

子ページ表示マクロ

Displays the children and descendants of the current page.

コー​ド ブロック マクロ

Displays code in your document with the appropriate syntax highlighting.

列マクロ

Used with the Section macro to define columns on a page. See  Working with page layouts and columns and sections.

ラベル別コンテンツ マクロ

Displays a list of content associated with specific labels.

ユーザー別コンテンツ マクロ

Displays a list of the content items that have been created by a specified Confluence user.

コンテンツ レポート テーブル マクロ

Displays a set of pages and blog posts in tabular format, based on the labels specifed in the macro parameters.

投稿者マクロ

Displays a list of Confluence users who have made a contribution of some type to a page.

投稿者の概要マクロ

Displays a table of contribution-based statistics for a set of pages.

スペース作成ボタンマクロ

Displays a create space button linked to the create space page.

抜粋インクルード マクロ

Allows you to display an excerpt from another page within the current page.

抜粋マクロ

ページの一部を「抜粋」として定義し、他のページで表示されるようにします。

展開マクロ

Displays an expandable/collapsible section of text.

お気に入りページ マクロ

Displays a list of your favourite pages.

ガジェット マクロ

Allows you to add Confluence gadgets to pages or blog posts.

ギャラリー マクロ

Forms a thumbnail gallery of all images attached to a page.

グローバル レポート マクロ

Displays a list of links to global reports within a table.

HTML インクルード マクロ

Includes the content of an external HTML file into a Confluence page.

HTML マクロ

Renders your specified HTML code within the current page.

IM Presence マクロ

Displays graphically when a contact is online.

ページを含めるマクロ

Inserts the contents of the specified page into the current one.

情報マクロ

Displays a block of text in a blue highlight box.

Jira 課題マクロ

Displays a list of JIRA issues in a page.

JIRA Macro

Displays one or more JIRA issues on your Confluence page.

JUnit レポート マクロ

Display a summary of JUnit test results.

ラベルのリストマクロ

Displays a hyperlinked alphabetical index of all labels within the current space.

Livesearch マクロ

Add a dynamic search box to a wiki page.

Loremipsum マクロ

Display a few paragraphs of pseudo-Latin text.

Multimedia マクロ

Displays videos, animations and more, sourced from a file attached to a Confluence page and displayed on your page.

ナビゲーション マップ マクロ

Renders the list of pages associated with a specified label as a navigable map.

ネットワーク マクロ

Displays a list of Network http://confluence.atlassian.com/display/DOC/Network+Overview activity for users in your Confluence site

書式設定済みマクロ

Displays a block of text in monospace font.

注意マクロ

Displays a block of text in a yellow highlight box.

ページ インデックス マクロ

Creates a hyperlinked alphabetical index of all page titles within the current space.

ページ プロパティ マクロ

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.

ページ プロパティ レポート マクロ

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.

ページ ツリー マクロ

Displays a dynamic, hierarchical list of pages starting from a specified parent (root) page.

ページ ツリー検索マクロ

Adds a search box to your Confluence page and searches a hierarchy of pages starting from a specified parent (root) page.

パネル マクロ

Displays a block of text within a fully customisable panel.

人気のあるラベル マクロ

Displays the most popular labels used throughout your Confluence site or within a space.

プロフィール画像マクロ

Displays a user's profile picture on a page.

最近更新されたダッシュボード マクロ

Displays a list of the most recently changed content within Confluence and is intended for use on the Confluence dashboard.

最近の更新マクロ

Displays a list of recently changed content (pages, news items, comments, etc).

最近使用されたラベル マクロ

Lists labels most recently used in a specified scope (global, space, or personal)

関連ラベル マクロ

Lists labels frequently appearing on the same pages as the current page's labels.

RSS フィード マクロ

Displays the contents of an RSS feed.

検索結果マクロ

Searches Confluence, and includes the results in the page.

セクション マクロ

Used with the Column macro to define columns on a page. See  Working with page layouts and columns and sections.

スペースの添付ファイル マクロ

Displays a list of attachments belonging to the current space.

スペース詳細マクロ

Includes the summary of a Confluence space in the page.

スペース ジャンプ マクロ

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.

スペースの一覧マクロ

Displays a list of all spaces visible to the user.

ステータス マクロ

Displays a coloured lozenge, useful for reporting project status.

目次マクロ

Displays a table of contents from your page headings.

目次の領域マクロ

Displays a table of contents from a defined page 'zone'.

タスク一覧マクロ

Displays a dynamic task list which can be modified in 'view' mode.

ヒント マクロ

Displays a block of text in a green highlight box.

ユーザー リスト マクロ

Displays a list of Confluence users, from an optional group.

ユーザープロファイル マクロ

Displays a short summary of any Confluence user's profile on your Confluence page or blog.

ユーザーステータス一覧マクロ

Displays a history of any Confluence user's status updates on your Confluence page or blog.

ファイル マクロの表示

Embeds an Office document or PDF file into your Confluence page.

警告マクロ

Displays a block of text in a red highlight box.

ウィジェット コネクタ マクロ

Displays videos, slide shows, twitter chats, documents and more, sourced from other web sites and displayed on your Confluence page.

Information about Other Macros

Other macros are available as plugins or as user macros, and can be installed by your Confluence administrator. For example, macros that may be of interest are available from Adaptavist, CustomWare and the Confluence SharePoint Connector. Not applicable to Confluence OnDemand.

Writing your own Macros

To learn how to write your own macro, take a look at the following documentation:

  • User macros are simple template-like macros that allow you to create simple formatting macros using the Confluence web interface. Read more about Writing User Macros. Not applicable to Confluence OnDemand.
  • The Confluence Plugin Guide tells you how to develop a plugin for Confluence.

コー​​ドの例

参照先: