Panel Preformatted with Specific Colours - Example of a User Macro

## @param Title:title=Title|type=string|desc=Title

@param defines the metadata for your macro parameters. When users select this macro, the macro will contain a parameter called "Title" where they can enter data. A macro dialog window appears when the user selects this macro using Insert > Other Macros or when a user clicks the macro placeholder and chooses Edit. The macro will, later on, use the data stored in this parameter to enter data in the title section of the Panel macro.

@param Title

このパラメーターは "Title" ト呼ばれます。

title=Title

defines the parameter title that will appear in the macro dialog window as "Title".

type=string

は、パラメーターのフィールド タイプをテキスト フィールドとして定義します。

desc=Title

defines the description of the parameter.

 <ac:macro ac:name="panel">

This command activates the Confluence Panel macro.

Hint: To discover the code name of a Confluence macro, see Confluence Storage Format for Macros. If the macro you want is not documented there, follow these steps:

1. Create and save a page containing a Confluence macro you want to investigate.
2. Choose Tools > View Storage Format. This option is available to Confluence administrators only, and shows the XML source code for the page. (See Confluence Storage Format.)

3. A Confluence macro starts with the following string: <ac: macro ac:name=

<ac:parameter ac:name="titleBGColor">#ccc</ac:parameter>
<ac:parameter ac:name="borderStyle">solid</ac:parameter>
<ac:parameter ac:name="borderColor">#6699CC</ac:parameter>
<ac:parameter ac:name="borderWidth">2</ac:parameter>
<ac:parameter ac:name="titleColor">#000000</ac:parameter>

Sets the parameters for the macro: the background colour, border style, border colour, border width and title colour.

Hint: To discover the names of the parameters for a Confluence macro, see Confluence Storage Format for Macros. If the macro you want is not documented there, follow these steps:

1. Create and save a page containing a Confluence macro you want to investigate.
2. Choose Tools > View Storage Format. This option is available to Confluence administrators only, and shows the XML source code for the page. (See Confluence Storage Format.)
3. The macro parameters start with the following string: <ac: parameter ac:name

<ac:parameter ac:name="title">$!paramTitle</ac:parameter>

'Title' パラメーターに保存されている値を、マクロの title セクションに入力します。

「!」は、「タイトル」パラメーターにデータがないときに、タイトルを空白のまま残すようマクロに伝えます。

<ac:rich-text-body>$body</ac:rich-text-body>

ユーザーは、マクロの本文に保存されているデータを使用できます。この行により、マクロはマクロに渡された本文コンテンツへのアクセスと保存が可能になります。

</ac:macro>

このコマンドは、マクロの終了を示します。