對於您的大部分空間自訂作業需求,您不需要建立新佈景主題。相反地,您可以使用自訂顏色、影像、橫幅等來自訂空間,而不必處理佈景主題的複雜性。如果您確實需要建立自訂佈景主題,您可以從 Business Space 提供的預設佈景主題開始,然後執行任何所需的其他自訂作業來達到您要的行為及外觀。
開始之前
在您自訂佈景主題之前,請注意下列事項:
- 自訂佈景主題的作業需要熟悉 HTML、CSS、JavaScript、iWidget 規格以及 Dojo 小組件程式庫。您應該檢閱 theme.html 的內容詳細資料,以瞭解哪些元素可以自訂,哪些不可以。
- 如果您自訂佈景主題,則在一般服務或維護活動期間,將不會套用 IBM® 更新至預設佈景主題構件。 自訂的佈景主題必須手動進行維護及更新。
關於這項作業
若要建立新的佈景主題,請執行下列步驟。
程序
- 連線到 WebDAV 資料夾,然後瀏覽至 webDAV_folder/public/themes/bspaceTheme
- 製作 bspaceTheme 資料夾的本端副本,然後將它重新命名。(在步驟及範例中,這些指示使用資料夾名稱 customCompanyTheme。)
- 編輯 theme.html 檔以進行必要的修改。
- 從 customCompanyTheme 的本端副本,以文字編輯器開啟 theme.html 檔。
- 修改 bspaceTheme 區塊的標記,讓您的 CSS 規則範圍限定至 .customCompanyTheme 規則。範圍限定至 .bspaceTheme 的任何現有規則都會保留在適當的位置。
下列範例顯示原始值。
<body class="lotusui tundra mashups bspace">
<div class="themeContent">
<div class=bspaceTheme">
變更原始值,如下所示。如果您不是使用
customCompanyTheme 來作為資料夾的名稱,請改用您的資料夾名稱。
<body class="lotusui tundra mashups bspace">
<div class="themeContent">
<div class=customCompanyTheme">
- 修改載入帷幔影像的路徑,使其成為您的新佈景主題資料夾的相對路徑。
在
theme.html 檔中,請修改下列標記,以指向您的自訂資料夾而不是預設
bspaceTheme 資料夾:
"/mum/mycontenthandler/mm/dav/filestore//public/themes/customCompanyTheme/images/loading32.gif"
- 執行任何其他您需要的編輯(例如,對新的小組件新增標記,或是刪除小組件)。 如需系統小組件(包括哪些可以安全地取代或移除)的相關資訊,請參閱說明文件中的佈景主題元素。
如需如何容許在佈景主題內進行橫幅自訂作業的相關資訊,請參閱在自訂佈景主題中啟用 Business Space 的橫幅自訂作業。
- 儲存並關閉 theme.html 檔。
- 修改 metadata.properties 檔案以指定佈景主題名稱,並設定開發者模式。
- 從 customCompanyTheme 的本端副本,以文字編輯器開啟 metadata.properties 檔。
- 修改檔案中的下列項目:
- unique-name:請以唯一的佈景主題名稱來取代預設值。資料庫會使用此名稱來識別空間和頁面的佈景主題。
- com.ibm.bspace.theme.uniqueId:以唯一 ID 取代預設值。
- developer-mode:如果此項目不存在,請新增它。將值設為 true。
- 儲存並關閉 metadata.properties 檔。
- 修改 localized_en.properties 檔,以指定將出現在「建立空間」對話框中的佈景主題名稱。
- 從 customCompanyTheme/metaData 的本端副本,以文字編輯器開啟 localized_en.properties 檔。
- 更新 title 項目,以便使用您要在建立空間視窗中選取佈景主題時看到的佈景主題名稱。在下列範例中,會使用名稱 "My Company Theme"。
title=My Company Theme
- 儲存並關閉 localized_en.properties 檔。
- 將您的自訂佈景主題資料夾上傳至下列 WebDAV 資料夾:
http://hostName:Bspace_Port/mum/mycontenthandler/mm/dav/filestore/public/themes
- 重新啟動伺服器。
- 清除瀏覽器快取,然後登入 Business Space。
現在即可在「建立空間」視窗中,使用您建立的自訂佈景主題。
結果
雖然現在您的空間可以使用自訂的佈景主題,但此作業中的步驟尚未變更佈景主題的外觀。
若要對新佈景主題進行大幅度的自訂作業,您需要確切瞭解 HTML、CSS、JavaScript、iWidget 規格 及 Dojo 小組件程式庫。
下面鏈結的主題中的資訊提供一些此自訂作業的指引,但該資訊可能不包括特定詳細資料或您嘗試進行之修改的範例。
請記住,您必須上傳任何其他修改,而且在您登入 Business Space 以使用自訂的構件之前,需要先清除快取。