本頁說明如何自訂你的 [[Obsidian Publish 介紹|Obsidian Publish]] 網站的外觀與風格。 ## 靜態資源 你可以透過[[發佈內容#發佈筆記|發佈]]以下檔案來自訂你的網站： - `publish.css` 用於新增自訂 CSS - `publish.js` 用於新增自訂 JavaScript - `favicon-32x32.png` 用於設定網站圖示 **注意事項：** - [Publish 的 CSS 變數](https://docs.obsidian.md/Reference/CSS+variables/Publish/Publish)可在我們的文件網站上找到。 - 由於 Obsidian 不支援 CSS 或 JavaScript 檔案，你需要使用其他應用程式來建立和編輯這些檔案。 - `publish.css` 和 `publish.js` 都必須位於保管庫的根目錄（`/`）中。 - 預設情況下，`publish.css` 和 `publish.js` 不會顯示在檔案總管中，但你仍可透過**發佈變動內容**對話方塊來發佈它們。 - 若要使用 `publish.js` 的自訂 JavaScript，你需要設定[[自訂網域]]。 對於網站圖示，Obsidian Publish 支援以下命名慣例，其中 `32` 代表圖示的像素尺寸： - `favicon-32.png` - `favicon-32x32.png` - `favicon.ico` 我們建議你提供以下一種或多種尺寸： - `favicon-32x32.png` - `favicon-128x128.png` - `favicon-152x152.png` - `favicon-167x167.png` - `favicon-180x180.png` - `favicon-192x192.png` - `favicon-196x196.png` 你可以靈活地將網站圖示放置在保管庫中的任何位置，只要它們有被發佈到你的網站即可。 ## 使用社群佈景主題 若要為你的網站使用社群佈景主題： 1. 使用作業系統的預設檔案總管開啟你的保管庫。 2. 前往保管庫設定資料夾（預設為 `.obsidian`）。 3. 開啟 `themes` 資料夾。 4. 複製你想要用於網站的主題 CSS 檔案。 5. 將檔案貼到保管庫的根目錄。 6. 將 CSS 檔案重新命名為 `publish.css`。 7. [[發佈內容#發佈筆記|發佈]] `publish.css`。 **注意事項：** - 如果樣式在幾分鐘內沒有更新，請嘗試清除瀏覽器快取。 - 你可以在[[管理網站#檢視網站選項|網站選項]]中切換明亮和暗黑模式。 - 許多社群佈景主題使用 **Style Settings** 進行自訂樣式設定，但這些設定在 Obsidian Publish 上不適用。 > [!tip] 開發佈景主題 > 找不到適合你的主題？了解如何自行[建立 Publish 主題](https://docs.obsidian.md/Themes/Obsidian+Publish+themes/Build+a+Publish+theme)。 ## 啟用 UI 功能 你可以為網站切換多種 UI 功能，例如圖譜檢視或目錄。 在[[管理網站#檢視網站選項|網站選項]]中的**閱讀體驗**和**元件**區段瀏覽可用的 UI 功能。 ### 自訂導覽 在 Obsidian Publish 中，你可以自訂 Publish [[檔案管理器]]中檔案和資料夾的導覽順序和顯示方式。導覽項目預設按發佈順序列出。未發佈的筆記不會出現在此面板中。 #### 存取自訂導覽選項 1. 在[[功能區選單]]中，選擇**發佈變動內容** ![[lucide-send.svg#icon]]，或開啟[[命令面板]]並輸入 **Publish: Publish changes...** 2. 在**發佈變動內容**對話方塊中，選擇**變更網站選項** ![[lucide-cog.svg#icon]]。 3. 在**元件設定**底下，**自訂導覽**旁邊，選擇**管理**按鈕。 一個標題為**導覽**的新彈出視窗會出現在**變更網站選項**視窗上方。 #### 調整導覽項目 在標示為**導覽預覽**的區段中，你可以調整已發佈內容的顯示順序。 1. 選擇你要調整的資料夾或筆記。 2. 將筆記或資料夾向上或向下拖曳到你想要的位置。 3. 在**導覽**視窗的右下角，選擇**完成**。 Publish 會將你的導覽變更傳送到你的網站。 #### 隱藏與取消隱藏導覽項目 如果有些筆記或資料夾你已經發佈，但不希望它們顯示在導覽中，你可以選擇隱藏這些項目。 1. 選擇你要調整的資料夾或筆記。 2. 右鍵點擊並選擇**在導覽中隱藏**。該項目現在應該會從**導覽預覽**中消失。 3. 在**導覽**視窗的右下角，選擇**完成**。 Publish 會將你的導覽變更傳送到你的網站。 > [!tip] 你可以透過選擇**導覽預覽**標題右側的核取方塊來**顯示隱藏項目** ## 常見問題 **我可以在導覽中將檔案從一個資料夾移到另一個資料夾嗎？** 不行。資料夾內筆記的檔案導覽結構需要維持不變。你可以調整資料夾內（包括保管庫根目錄）的筆記順序，以及其他資料夾內的資料夾順序。 **我可以在選擇完成之前編輯多個筆記和資料夾的順序嗎？** 可以。 **我要如何還原這些變更？** - **顯示順序**：選擇**導覽項目顯示順序**旁的**還原至預設值**圖示（逆時針旋轉箭頭）。這會將你的導覽項目還原為按字母排序。 - **隱藏狀態**：選擇**從導覽中隱藏頁面或資料夾**旁的**還原至預設值**圖示（逆時針旋轉箭頭）。這會將你隱藏的導覽項目還原為可見狀態。