コード ブロック マクロ
このマクロは、Confluence Data Center と Confluence Cloud で使用できます。マクロの詳細については、「Confluence Cloud」を参照してください。
シンタックス ハイライトを使用してコード例を表示するには、コード ブロック マクロをページに追加します。
これは、以下のようなコード スニペットの共有に役立ちます。
- サンプル コード
- ターミナル コマンド
- アプリケーション ログからの抜粋
On this page:
スクリーンショット: ダーク テーマでシンタックス ハイライトを使用したコード ブロック マクロのコード例
コード ブロック マクロをページに追加する
コード ブロック マクロをページに追加するには、次の手順を実行します。
- エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
- [形式設定] カテゴリから [コード ブロック] を選択します。
- シンタックス ハイライトの言語を選択します。
- 以下のパラメーターを使用して、ページでのコード ブロックの表示方法をカスタマイズします。
- [挿入] をクリックします。
- コードをマクロ プレースホルダーに入力するか貼り付けます。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: コード ブロック マクロでのシンタックス ハイライトの言語とテーマの選択
注: コード ブロックはエディタのマクロ プレースホルダーに直接入力します。プレースホルダー内に含まれるスペースは、コード ブロック マクロでは処理されないので注意してください。これにより入力時、柔軟にコード インデントを行えます。
マクロ パラメーターを変更する
マクロ パラメーターは、マクロの動作を変えるために使用します。
マクロ パラメーターを変更するには、次の手順を実行します。
- エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
- 必要に応じてパラメーターを更新し、[挿入] を選択します。
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
---|---|---|
シンタックス ハイライト | java | シンタックス ハイライトに使用する言語 (または環境) を指定します。既定の言語は Java です。 |
タイトル | なし | コードブロックにタイトルを追加します。指定すると、コードブロックの先頭行のヘッダーに表示されます。 |
折りたたみ可能 | false | 選択すると、コード マクロの内容が、アクセス時やリフレッシュ時に折りたたまれます。 |
行番号を表示 | false | 選択すると、コード行の左側に数字が表示されます。 |
最初の行番号 | 1 | 行数を表示を選択すると、この値を最初の行の数字として定義します。 |
テーマ | 既定 | コードブロックの表示に使用するカラーテーマを指定します。テーマの多くは人気の統合開発環境 (IDE)のデフォルトのカラースキームをベースにしています。 既定のテーマConfluence (既定) は、ブランクの背景にブラックとカラーフォントの一般的なものですが、下記の人気のテーマから他のテーマを選択することも可能です。
|
Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
コード ブロック マクロを管理する
コード ブロック マクロは、既定で特定の言語とテーマを使用するように設定できます。既定のテーマと言語を変更するには、Confluence 管理者権限が必要です。
サイトにコードブロックの既定の外観を設定するには:
- [管理] > [一般設定] > [コード マクロの設定] に移動します。
- [既定のテーマ] と [既定の言語] を選択します。
- 保存を選択します 。
他を指定していない限り、すべての新しいコードブロックに既定のテーマと言語が適用されます。既存のコードブロックは変更されません。
カスタム言語のアップロードは不可になり、過去にアップロードした言語はサポートされなくなりました。これらはシステムからアンインストールしてかまいません。
ユーザーがインストールした言語を削除するには、次の手順に従います。
- [管理] > [アプリの管理] に移動します。
- [ユーザーがインストールしたアプリ] に移動し、独自にアップロードした言語のアプリを探します。
「Custom Code Macro Highlighting for...」のように表示されます。アプリが多数ある場合は、com.atlassian.confluence.ext.code.custom
名前空間を検索したほうがよいこともあります。 - [アンインストール] または [無効化] を選択します。
言語がコードマクロに表示されなくなります。
このマクロを追加するその他の方法
手入力でこのマクロを追加する
Wiki マークアップを使用してこのマクロを追加する
これは、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: code
マクロ本文:プレーンテキストをアクセプトする
{code:title=This is my title|theme=FadeToGrey|linenumbers=true|language=java|firstline=0001|collapse=true}
This is my code
{code}
Confluence を使いこなす
Atlassian Marketplace で提供されている数百ものマクロを使用して、Confluence を拡張できます。人気のあるアプリの一部を紹介します。
- Code Pro for Confluence - Confluence の任意のソースでコードをリアルタイムで表示
- Include Bitbucket Server for Confluence - Bitbucket Server へ自動的に同期されるコード スニペットをConfluence 内に簡単に追加
- Markdown Extension for Confluence - 公開および非公開 Github & Bitbucket リポジトリのマークダウンを Confluence に埋め込み