在 Confluence 官方 前期釋出的消息
中，文檔主題在 Confluence 6.0 及其後續版本中已經不可用。我們知道你可能對這個有很多好好奇的問題，是以我們在這裡設定了一個問答用于幫助你将這個主題更新到 Confluence 6.0。
如果你還有其他問題，你可以在本頁面的底部向 Confluence 的官方提出，我們将會盡我們最大的努力幫助你解決你遇到的問題。
- 預設的主題看起來是什麼樣子的？
- 如果還确定在我的空間中，我使用的是文檔主題？
- 如果檢查在我的站點中有哪些地方使用了文檔主題？
- 有關文檔空間的自定義部分在我更新的時候有什麼影響？
- 我的空間将會在我更新後損壞嗎？
- 我可以全局的為邊欄，頁頭，頁尾添加自定義内容嗎？
- 我還可以在邊欄，頁頭或頁尾使用宏嗎？
- 我在哪裡添加邊欄，頁頭或頁尾自定義内容？
- 如何在邊欄的頂部關閉頁面和部落格的快捷連結？
- 我可以全局編輯預設主題的邊欄嗎？
- 我希望檢視頁面樹而不是子頁面，我應該如何做？
- 空間管理者和空間操作員在哪裡？
- 我必須在邊欄，頁頭和頁腳上使用 wiki 标記嗎？
- 我可以隐藏或者修改空間辨別的顯示嗎？
- 我可以隐藏預設的頁面樹而插入我自己的嗎？
- 我如何讓我的頁面标題在邊欄中包裹起來？
- 我可以在邊欄中修改顯示順序嗎？
- 我還可以使用空間跳轉宏（space jump macro）嗎？
- 為什麼子頁面不能顯示在頁面下面？
- 我可以限制值搜尋這個空間嗎？
- 如何在空間中按字母檢視頁面？
- 導入一個使用文檔主題的空間将會發生什麼？
下面是文檔主題的一個示例，文檔主題和預設的主題的對比如下：
- 文檔主題（Documentation theme）： 可以自定義邊欄内容。
- 預設主題（Default theme）：在邊欄中有自定義的内容。
在你的空間中，檢查你這個空間十分使用的是文檔主題的最簡單的方法是，在頭部查找 浏覽（Browse）菜單，通常這個在 建立（Create）按鈕的附近。（如果你已經正在使用預設主題，你将會在邊欄中看見空間工具菜單）。
通常沒有很好的方法來在一個站點中列出正在使用的文檔主題清單。如果你的 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 标記能夠讓你老的自定義内容不需要太多修改就可以應用到新的主題上。你僅僅需要複制張貼就可以了。
你可以使用任何圖檔作為你的空間圖示，但是你不能修改這個圖檔在邊欄中的顯示（這個圖檔總是圓形的并且會一直在頁面的頂部）。
是的。在邊欄中你對頁面樹的顯示有完全的控制權。你可以隐藏預設的頁面數，同時你也可以在邊欄中添加
Page Tree macro宏
{pagetree}，來顯示自定義内容。
頁面标題不能在邊欄的預設主題中包裹起來（不管你是使用預設的頁面樹還是使用
{pagetree}
來顯示自定義的内容）。不能對這個進行修改。
你可以對邊欄中的一些内容的顯示順序繼續修改，例如快捷連結的順序，但是邊欄中的分類顯示（sections）是不能對順序進行調整的。任何具有
圖示的項目都是可以移動的。
自定義的内容顯示在頁面樹的上面。你可以對預設的頁面樹進行隐藏，然後在自定義區域使用 WIki 标記将隐藏的頁面樹再添加回來。這個對你打算對頁面樹和自定義内容的顯示順序進行修改的時候比較有效。
不可以。空間跳轉宏是提供給文檔主題使用的，當文檔主題被删除後，這個宏就不再可以使用了。如果你在空間的頁面，頁頭，頁腳使用了這個宏，那麼在更新的時候将會顯示錯誤資訊如下：
unknown macro: {spacejump}。
要早點在你的站點中的那些頁面上使用了空間跳轉宏，你可以在站點的搜尋對話框中輸入
macroName:spacejump
。所有含有這個宏的頁面将會傳回顯示出來（這個搜尋隻能搜尋頁面，不能搜尋邊欄，頁頭或頁腳）。
預設空間主題不會在邊欄下面列出子頁面，你可以在頁腳中使用
Children Display macro宏來達到類似的效果。
不可以。這個就是我們要删除文檔主題所具有的一個特性。
一個可選的方案是通過添加一個
Livesearch macro宏到邊欄或者空間首頁中。在空間參數中使用
@self
來限制搜尋隻搜尋目前的空間。
如果你使用的是預設的主題，那麼在這個主題中你不能按照字母順序檢視所有頁面。
你應該不會遇到什麼問題，在導入這個空間的時候。但是預設的主題将會被應用到導入的空間中。如果你使用了自定的 Wiki 标記，也會自動合并到預設的主題中。在導出空間前，你應該拷貝邊欄，頁頭，頁腳中字段中的标記内容。這樣你可以在導入成功後再将這些内容重新添加回來。
https://www.cwiki.us/display/CONF6ZH/Documentation+theme+migration+FAQ