在 Confluence 官方 前期釋出的訊息 中，文件主題在 Confluence 6.0 及其後續版本中已經不可用。我們知道你可能對這個有很多好好奇的問題，因此我們在這裡設定了一個問答用於幫助你將這個主題升級到 Confluence 6.0。

如果你還有其他問題，你可以在本頁面的底部向 Confluence 的官方提出，我們將會盡我們最大的努力幫助你解決你遇到的問題。

• 預設的主題看起來是什麼樣子的？
• 如果還確定在我的空間中，我使用的是文件主題？
• 如果檢查在我的站點中有哪些地方使用了文件主題？
• 有關文件空間的自定義部分在我升級的時候有什麼影響？
• 我的空間將會在我升級後損壞嗎？
• 我可以全域性的為邊欄，頁頭，頁尾新增自定義內容嗎？
• 我還可以在邊欄，頁頭或頁尾使用巨集嗎？
• 我在哪裡新增邊欄，頁頭或頁尾自定義內容？
• 如何在邊欄的頂部關閉頁面和部落格的快捷連結？
• 我可以全域性編輯預設主題的邊欄嗎？
• 我希望檢視頁面樹而不是子頁面，我應該如何做？
• 空間管理員和空間操作員在哪裡？
• 我必須在邊欄，頁頭和頁尾上使用 wiki 標記嗎？
• 我可以隱藏或者修改空間標識的顯示嗎？
• 我可以隱藏預設的頁面樹而插入我自己的嗎？
• 我如何讓我的頁面標題在邊欄中包裹起來？
• 我可以在邊欄中修改顯示順序嗎？
• 我還可以使用空間跳轉巨集（space jump macro）嗎？
• 為什麼子頁面不能顯示在頁面下面？
• 我可以限制值搜尋這個空間嗎？
• 如何在空間中按字母檢視頁面？
• 匯入一個使用文件主題的空間將會發生什麼？

預設的主題看起來是什麼樣子的？

下面是文件主題的一個示例，文件主題和預設的主題的對比如下：

1. 文件主題（Documentation theme）： 可以自定義邊欄內容。
2. 預設主題（Default theme）：在邊欄中有自定義的內容。

如果還確定在我的空間中，我使用的是文件主題？

在你的空間中，檢查你這個空間十分使用的是文件主題的最簡單的方法是，在頭部查詢 瀏覽（Browse）

如果檢查在我的站點中有哪些地方使用了文件主題？

通常沒有很好的方法來在一個站點中列出正在使用的文件主題列表。如果你的 Confluence 站點比較龐大，你的 Confluence 管理員可以使用下面的查詢語句來從資料庫中載入所有使用文件主題的列表。

這個查詢只會找到使用文件主題的空間。這個查詢不會包含空間使用的外觀和佈局（這些空間將會在你修改為站點主題的時候自動修改，你不需要每一個空間都去修改一次）。

有關文件空間的自定義部分在我升級的時候有什麼影響？

在升級的過程中，我們將會對當前使用文件主題的空間應用預設的主題。如果你對這些文件主題進行了自定義（例如，新增 Wiki 標記到邊欄，頁頭，頁尾），我們將會把這些 Wiki 標記放置到預設主題的變數，頁頭，頁尾。

預設的主題將會新增一些新的部分到邊欄中。例如連結到頁面，部落格和空間的快捷連結。你也選擇是否對這些連結進行隱藏，進入空間工具（Space Tools）> 配置邊欄（Configure Sidebar），然後使用  按鈕來隱藏你不希望顯示的快捷連結。

我的空間將會在我升級後損壞嗎？

這個與你對空間的自定義化程度有關。在大部分情況下，你的空間在升級後會看起來有些不同，但是不至於出現完全不同，或者損壞的情況。

如果你使用了 CSS 來對你的空間進行了修改（不管你是否使用 Adaptavist Content Formatting 巨集 來修改了空間的樣式表，例如  {style} 和 {div}，並且這些修改應用到了文件主題的邊欄，頁頭，頁尾）。你可能需要對你 CSS 檔案中的一些名字進行修改才能讓你的主題看起來是正確的。

例如，你在文件主題中指定了 #splitter-sidebar ，你將會需要在預設主題中使用 .acs-side-bar。

如果你通過 Confluence UI 自定義了預設的空間佈局，並且你將這個預設佈局應用到了你前期使用的文件空間中後，

如果你發現你遇到了這個問題，你需要重置損壞的佈局。

 通過 UI 重置損壞的自定義佈局...

 從資料庫中刪除自定義佈局...

我可以全域性的為邊欄，頁頭，頁尾新增自定義內容嗎？

答案是可以的。進入  > 基本配置（General Configuration） > 邊欄，頁頭和頁尾（Sidebar, Header and Footer）。所有的空間使用的全域性外觀和佈局將會繼承你自定義的內容。任何自定義新增到邊欄，頁頭和頁尾中的內容將會被全域性配置覆蓋。

我還可以在邊欄，頁頭或頁尾使用巨集嗎？

是的，如果巨集能夠在文件主題中正確的工作的話，那麼這些巨集應該也是可以在預設主題中工作的。

我在哪裡新增邊欄，頁頭或頁尾自定義內容？

你可以針對每一個空間獨立的在邊欄，頁頭和頁尾新增內容。使用下面的路徑進行訪問：空間工具（Space Tools） > 外觀和佈局（Look and Feel） > 邊欄，頁頭和頁尾（Sidebar, Header and Footer）或者全域性的   > 基本配置（General Configuration） > 邊欄，頁頭和頁尾（Sidebar, Header and Footer）。

Confluence 為所有空間顯示全域性的自定義內容，直到空間具有自己自定義的內容（空間自定義的內容將會覆蓋關鍵的自定義內容）。這個內容是通過一個欄位，一個欄位覆蓋的，因此你有可能看到自定義的綜合版本。例如，你可能全域性的修改了頁尾，但是一些獨立的空間，你有一些頁頭的修改，那麼你就會看到全域性的頁尾和獨立的頁頭的修改。

如何在邊欄的頂部關閉頁面和部落格的快捷連結？

進入 空間工具（Space Tools）> 配置邊欄（Configure Sidebar），然後使用  按鈕來隱藏你不希望顯示的快捷連結。

我可以全域性編輯預設主題的邊欄嗎？

不可以。你可以對全域性邊欄的內容進行自定義，但是對邊欄中內容的隱藏，這是空間圖示和新增快捷連結，你只能針對每一個空間獨立的操作。

我希望檢視頁面樹而不是子頁面，我應該如何做？

進入 空間工具（Space Tools）> 配置邊欄（Configure Sidebar） 然後在導航選項中選擇 頁面樹（Page Tree）。

空間管理員和空間操作員在哪裡？

為了體會在空間操作員和空間管理員中進行選擇，文件主題有一個 空間工具（Space Tools）菜單鏈接能夠然你進行許可權選項，內容工具，外觀佈局和整合。

 這裡是你新老主題的索引列表...

我必須在邊欄，頁頭和頁尾上使用 wiki 標記嗎？

是的。我們新增這個特性的主要目的是幫助任何能夠從文件主題遷移到預設主題而不會有太多的影響。保持這些欄位任然使用 Wiki 標記能夠讓你老的自定義內容不需要太多修改就可以應用到新的主題上。你僅僅需要複製張貼就可以了。

我可以隱藏或者修改空間標識的顯示嗎？

你可以使用任何圖片作為你的空間圖示，但是你不能修改這個圖片在邊欄中的顯示（這個圖片總是圓形的並且會一直在頁面的頂部）。

我可以隱藏預設的頁面樹而插入我自己的嗎？

是的。在邊欄中你對頁面樹的顯示有完全的控制權。你可以隱藏預設的頁面數，同時你也可以在邊欄中新增 Page Tree macro 巨集 {pagetree}，來顯示自定義內容。

我如何讓我的頁面標題在邊欄中包裹起來？

頁面標題不能在邊欄的預設主題中包裹起來（不管你是使用預設的頁面樹還是使用 {pagetree}  來顯示自定義的內容）。不能對這個進行修改。

我可以在邊欄中修改顯示順序嗎？

你可以對邊欄中的一些內容的顯示順序繼續修改，例如快捷連結的順序，但是邊欄中的分類顯示（sections）是不能對順序進行調整的。任何具有  圖示的專案都是可以移動的。

自定義的內容顯示在頁面樹的上面。你可以對預設的頁面樹進行隱藏，然後在自定義區域使用 WIki 標記將隱藏的頁面樹再添加回來。這個對你打算對頁面樹和自定義內容的顯示順序進行修改的時候比較有效。

我還可以使用空間跳轉巨集（space jump macro）嗎？

不可以。空間跳轉巨集是提供給文件主題使用的，當文件主題被刪除後，這個巨集就不再可以使用了。如果你在空間的頁面，頁頭，頁尾使用了這個巨集，那麼在升級的時候將會顯示錯誤資訊如下： unknown macro: {spacejump}。

要早點在你的站點中的那些頁面上使用了空間跳轉巨集，你可以在站點的搜尋對話方塊中輸入 macroName:spacejump 。所有含有這個巨集的頁面將會返回顯示出來（這個搜尋只能搜尋頁面，不能搜尋邊欄，頁頭或頁尾）。

為什麼子頁面不能顯示在頁面下面？

預設空間主題不會在邊欄下面列出子頁面，你可以在頁尾中使用 Children Display macro 巨集來達到類似的效果。

我可以限制值搜尋這個空間嗎？

不可以。這個就是我們要刪除文件主題所具有的一個特性。

一個可選的方案是通過新增一個 Livesearch macro 巨集到邊欄或者空間主頁中。在空間引數中使用 @self 來限制搜尋只搜尋當前的空間。

如何在空間中按字母檢視頁面？

如果你使用的是預設的主題，那麼在這個主題中你不能按照字母順序檢視所有頁面。

匯入一個使用文件主題的空間將會發生什麼？

你應該不會遇到什麼問題，在匯入這個空間的時候。但是預設的主題將會被應用到匯入的空間中。如果你使用了自定的 Wiki 標記，也會自動合併到預設的主題中。在匯出空間前，你應該拷貝邊欄，頁頭，頁尾中欄位中的標記內容。這樣你可以在匯入成功後再將這些內容重新添加回來。

https://www.cwiki.us/display/CONF6ZH/Documentation+theme+migration+FAQ