ソースを表示する

コードブロックマクロを使用すると、以下のように、構文をわかりやすく強調表示したソースコードをページに表示できます。

Confluence 5.8 > Code Block Macro > codeblockmacro-example.png

コードブロックマクロを追加する

エディターのプレースホルダー内に直接コードブロックを入力します。プレースホルダー内に含まれるスペースは、コードブロックマクロでは 処理されないでの注意してください。これにより入力時、柔軟にコードインデントを行えます。

パラメーター

パラメーター	既定	説明
シンタックスハイライト `(language`)	java	構文をハイライトする言語（または環境）を特定します。既定値は java ですが、下記の言語／環境から選択可能です。 actionscript3 bash csharp (C#) coldfusion cpp (C++) CSS delphi diff erlang groovy html/xml java javafx javascript none（構文をハイライトしない） perl php powershell python ruby scala sql vb
タイトル	なし	コードブロックにタイトルを追加します。指定すると、コードブロックの先頭行のヘッダーに表示されます。
折りたたみ可能 `(collapse`)	false	選択すると、コードマクロの内容が、アクセス時やリフレッシュ時に折りたたまれます。`expand source` リンクをクリックすると、コンテンツを確認できます。false の場合、コードマクロの内容は常に全表示されます。
行番号を表示 `(linenumbers`)	false	選択すると、コード行の左側に数字が表示されます。
最初の行番号 `(firstline`)	1	行数を表示を選択すると、この値を最初の行の数字として定義します。
テーマ	既定	コードブロックの表示に使用するカラーテーマを指定します。テーマの多くは人気の統合開発環境 (IDE)のデフォルトのカラースキームをベースにしています。既定のテーマConfluence (Default) は、ブランクの背景にブラックとカラーフォントの一般的なものですが、下記の人気のテーマから他のテーマを選択することも可能です。 DJango Emacs FadeToGrey Midnight RDark Eclipse Confluence

コードブロックマクロを設定する

コードブロックマクロを設定すれば、特定の言語とテーマを既定値として使用したり、新しい言語をアップロードしたりできます。既定値のテーマと言語を変更するにはシステム管理者権限が必要です。また、新しい言語をアップロードするにはConfluence 管理者権限が必要です。

サイトにコードブロックの既定の外観を設定するには：

コードマクロを設定するを選択する
既定のテーマと既定の言語を選択する
保存を選択する

他を指定していない限り、すべての新しいコードブロックに既定のテーマと言語が適用されます。既存のコードブロックは変更されません。

他の言語を追加するには：

コードマクロを設定するを選択する
新しい言語を追加するを選択する
追加する言語ファイルを検索し、新しい言語に対し、名前を入力する（言語の選択時に表示されます）
追加を選択します

Language files must be correctly formatted JavaScript files and adhere to the Custom Brush syntax.

インストールした言語を無効化または削除するには：

アドオンを管理を選択する
ユーザーがインストールしたアドオンから、アップロードしたアドオンを検索する - 「～をハイライトするカスタムコードマクロ」のように表示されます
アンインストールまたは無効にする選択する

言語がコードマクロに表示されなくなります。

コードの例

次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。

マクロ名: code

マクロ本文：プレーンテキストをアクセプトする

保存形式の例

以下の例ではすべてのパラメータと本文を表示しています。

<ac:structured-macro ac:name="code">
  <ac:parameter ac:name="title">This is my title</ac:parameter>
  <ac:parameter ac:name="theme">FadeToGrey</ac:parameter>
  <ac:parameter ac:name="linenumbers">true</ac:parameter>
  <ac:parameter ac:name="language">xml</ac:parameter>
  <ac:parameter ac:name="firstline">0001</ac:parameter>
  <ac:parameter ac:name="collapse">true</ac:parameter>
  <ac:plain-text-body><![CDATA[<b>This is my code</b>></ac:plain-text-body>
</ac:structured-macro>

下記の 3 例はさまざまなオプションのパラメータを使用したコードブロックマクロの例です。

説明

Markup

表示結果

本文にコードブロックマクロ、オプションのパラメータなし

<ac:structured-macro ac:name="code">
  <ac:plain-text-body><![CDATA[this is my code></ac:plain-text-body>
</ac:structured-macro>

this is my code

本文にコードブロックマクロ、オプションの言語パラメータが定義されている

<ac:structured-macro ac:name="code">
  <ac:parameter ac:name="language">html/xml</ac:parameter>
  <ac:plain-text-body><![CDATA[this is my code></ac:plain-text-body>
</ac:structured-macro>

this is my code

本文にコードブロックマクロとオプションのタイトル、行数、言語パラメータが定義されている

<ac:structured-macro ac:name="code">
  <ac:parameter ac:name="title">This is my title</ac:parameter>
  <ac:parameter ac:name="linenumbers">true</ac:parameter>
  <ac:parameter ac:name="language">html/xml</ac:parameter>
  <ac:plain-text-body><![CDATA[this is my code></ac:plain-text-body>
</ac:structured-macro>

this is my code

Wiki マークアップの例

{code:title=This is my title|theme=FadeToGrey|linenumbers=true|language=html/xml|firstline=0001|collapse=true}
これは私のコードです
{code}

コー​​ドブロック マクロを追加する