基本的なテーマ構造
テーマの基本構造には、Oracle Content Managementに格納されているフォルダで指定されているデザイン、ナビゲーションおよびスタイルが含まれます。 テーマは、サイトのテンプレートに組み込まれています。
ユーザーが新しいサイトを作成するためにテンプレートを選択すると、関連付けられているテーマ・データが自動的にロードされます。 JETスタータ・テンプレートまたはスタータ・テンプレートを使用する場合、テーマは参照されるかわりに自動的にコピーされます。 開発者は、スタータ・テンプレートを使用している場合は、独自のテーマのコピーが必要です。
テーマは、基本的なフォルダおよびファイルを示すこの例のとおり、特定のフォルダおよびファイル構造で編成されます:
theme
assets
css
main.css
js
topnav.js
designs
default
design.css
design.json
layouts
publish
responsepages
404.html
viewport.json
_folder.json
_folder_icon.png
components.json
特定のフォルダには、次のフォルダを含む特定のタイプの情報が含まれています:
-
assets
: JavaScript、カスケード・スタイル・シート(CSS)、イメージ、およびレイアウトによって参照されるその他のサポート・ファイル。 -
designs
:design.css
およびdesign.json
ファイル。コンポーネントのスタイル・オプションを指定するために使用されます。 -
layouts
: ページ・テンプレート用のHTMLファイル。サイトのページの表示に使用されます。ノート:
すべてのHTMLファイルは、このように見えるファイルの先頭にDOCTYPE要素を持つ必要があります:<!DOCTYPE html>
-
publish
: 公開されたサイトでテーマが使用されると、このディレクトリがリストされ、ファイルのコピーが含まれます。 このディレクトリは、デスクトップ・アプリケーションを使用してテーマを同期した場合に表示されますが、テンプレートの一部としてテーマをエクスポートした場合には含まれません。 -
responsepages
: エラー処理のための特別なページ(404)。ノート:
サイト内のページに「エラー・ページ」のフラグが付けられている場合、テーマからの404エラー・メッセージは無視され、指定された「エラー・ページ」がかわりに使用されます。 -
viewport.json
: テーマのビューポート設定を指定します。 -
_folder.json
: テーマの名前とGUIDを指定します。 たとえば:{ "themeName":"MarketingCampaignTheme", "itemGUID":"TB79D65F699B022AC4E11F4D4EE870070A1ADD86BBBB" }
このGUIDは、テーマが最初にインポートされたときまたはコピーされたときに、Oracle Content Managementによって作成されます。 テーマ名は、テーマ作成時に、テーマの開発者によって割り当てられます。
-
components.json
: テーマ内で使用されるカスタム・コンポーネントを記録します。
新しいテーマを作成する際には、2つの重要なファイルがあります。 これらのファイルは、コンポーネントのスタイルを設定します:
-
design.css
-
design.json
ナビゲーション情報を1つのJavaScriptファイルに格納することをお勧めします。たとえば、nav.js
という名前のファイルです。 テーマの/assets/js/
フォルダは、そのようなファイルに適した場所です。