基本主題結構

主題的基本結構包括 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)、影像,以及版面配置參照的其他支援檔案。

  • designsdesign.cssdesign.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:(已不再使用)。記錄主題內使用的自訂元件。僅保留供回溯相容性之用。

建立新主題時,將會用到兩個重要檔案。這兩個檔案主要設定元件樣式:

  • design.css

  • design.json

建議將導覽資訊放到一個 JavaScript 檔案中;例如,nav.js 檔案。主題的 /assets/js/ 資料夾對此類檔案而言是很適合的位置。