カスタマイズ済みのサイトとスペース レイアウトのアップグレード

ステップ 1.カスタム レイアウトを取得する

Ideally, you should keep a record of each customisation you have applied to each of your Confluence site or space layouts.

If not, you should be able to find your customisations using the following method. This method extracts all site- and space-level layouts from your Confluence site as a single output. From this output, you should be able to identify your customisations.

カスタム レイアウトは、Confluence データベース内の DECORATOR テーブルに保存されます。次のような SQL を使用してレイアウトのソースを SELECT (選択) できます。

mysql> select SPACEKEY,DECORATORNAME,BODY from DECORATOR;
+----------+---------------------+------+
| SPACEKEY | DECORATORNAME       | BODY |
+----------+---------------------+------+
| NULL     | decorators/main.vmd| ...  |
+----------+---------------------+------+
1 row in set (0.03 sec)

この例は、MySQL でテストされましたが、すべての SQL データベースに適用可能です。

Step 2. Reapply your Customisations

When you upgrade Confluence to another major release of Confluence, you will need to manually reapply any customisations you made to any site-wide or space-specific layouts. Unless otherwise stated, you should not need to reapply customisations after conducting a minor release upgrade of Confluence.

「メジャー」および「マイナー」リリースとは? メジャー リリースは、アップグレード後に Confluence のバージョン番号の 1 桁目、または小数点第 1 桁目の後 1 番目の桁数が異なるものです (例: Confluence 3.0 から 3.1、または 2.8 から 3.0 へのアップグレードなど)。マイナー リリースは、アップグレード後に Confluence のバージョン番号の 1 桁目、および小数点第 1 位の後の 1 番目の数字が同じとなるものです (例: Confluence 3.0 から 3.0.1 へのアップグレードなど)。

If you have made Confluence site-wide layout customisations:

1. Choose the cog icon  at top right of the screen, then choose Confluence Admin.
2. 左側のナビゲーション パネルにあるレイアウトを選択します。デコレーターは サイト、コンテンツ および エクスポート レイアウトにグループ化されます。
3. Ensure you have all your customisations available (preferably in a form which can be copied and pasted).
4. Click Reset Default next to the layout whose customisations need to be reapplied.
5. Click Create Custom next to the same layout and reapply your customisations (by copying and pasting them) into the appropriate locations within the new default layout.
6. [保存] ボタンをクリックします。
7. Repeat this procedure from step 4 for each layout whose customisations need to be reapplied.

If you have made space-specific layout customisations:

1. Visit any page in the relevant space.
2. Go to the space and choose Space tools on the sidebar.
   Note: The 'Space tools' option  appears only if you are a space administrator for the space or you are a super user (a member of the confluence-administrators group).
3. Click Layouts in the left-hand navigation panel. The decorators are grouped under Site, Content and Export layouts.
4. Ensure you have all your customisations available (preferably in a form which can be copied and pasted).
5. Click Reset Default next to the layout whose customisations need to be reapplied.
6. Click Create Custom next to the same layout and reapply your customisations (by copying and pasting them) into the appropriate locations within the new default layout.
7. [保存] ボタンをクリックします。
8. Repeat this procedure from step 5 for each layout whose customisations need to be reapplied.

ステップ 3.変更を慎重にテストする

変更は、Confluence の今後のバーションで予測できない相互作用を与える場合があります。アップグレードする場合、稼働中のサイトに展開する前に、常にカスタム変更をテストする必要があります。これらの変更のテストとデプロイは、アトラシアン サポートの範囲外です。

キャッシュをオフにする

Velocity はテンプレートをメモリにキャッシュするように設定されています。Confluence 内からページを編集する場合、そのページをディスクからリロードします。ディスク上のページを編集する場合、変更を可視化するには WEB-INF/classes/velocity.properties で Velocity のキャッシングを一時的にオフにするか、サーバを再起動する必要があります。

velocity.properties ファイルは confluence-x.x.x.jar ファイルで利用可能です (x.x.x は Confluence のバージョン番号です)。JAR ファイルは WEB-INF/lib ディレクトリにあります。JAR のファイルを変更したい場合は、次の手順をおすすめします。

1. Confluence を停止します。
2. JAR ファイルのバックアップ コピーを作成します。
3. ファイルを解凍します。
4. 変更したい適切なファイルを見つけて編集します。
5. confluence-x.x.x.jar ファイルを再度 jar ファイルにします。
6. 適切なディレクトリへ JAR ファイルを再配置します。
7. Confluence を再起動します。

関連トピック

サイトおよびスペース レイアウトのカスタマイズ