Confluence 6 文檔主題合併問答

在 Confluence 官方 前期發佈的消息 中，文檔主題在 Confluence 6.0 及其後續版本中已經不可用。咱們知道你可能對這個有不少好好奇的問題，所以咱們在這裏設置了一個問答用於幫助你將這個主題升級到 Confluence 6.0。

若是你還有其餘問題，你能夠在本頁面的底部向 Confluence 的官方提出，咱們將會盡咱們最大的努力幫助你解決你遇到的問題。

• 默認的主題看起來是什麼樣子的？
• 若是還肯定在個人空間中，我使用的是文檔主題？
• 若是檢查在個人站點中有哪些地方使用了文檔主題？
• 有關文檔空間的自定義部分在我升級的時候有什麼影響？
• 個人空間將會在我升級後損壞嗎？
• 我能夠全局的爲邊欄，頁頭，頁尾添加自定義內容嗎？
• 我還能夠在邊欄，頁頭或頁尾使用宏嗎？
• 我在哪裏添加邊欄，頁頭或頁尾自定義內容？
• 如何在邊欄的頂部關閉頁面和博客的快捷連接？
• 我能夠全局編輯默認主題的邊欄嗎？
• 我但願查看頁面樹而不是子頁面，我應該如何作？
• 空間管理員和空間操做員在哪裏？
• 我必須在邊欄，頁頭和頁腳上使用 wiki 標記嗎？
• 我能夠隱藏或者修改空間標識的顯示嗎？
• 我能夠隱藏默認的頁面樹而插入我本身的嗎？
• 我如何讓個人頁面標題在邊欄中包裹起來？
• 我能夠在邊欄中修改顯示順序嗎？
• 我還可使用空間跳轉宏（space jump macro）嗎？
• 爲何子頁面不能顯示在頁面下面？
• 我能夠限制值搜索這個空間嗎？
• 如何在空間中按字母查看頁面？
• 導入一個使用文檔主題的空間將會發生什麼？

默認的主題看起來是什麼樣子的？

下面是文檔主題的一個示例，文檔主題和默認的主題的對好比下：

1. 文檔主題（Documentation theme）： 能夠自定義邊欄內容。
2. 默認主題（Default theme）：在邊欄中有自定義的內容。

若是還肯定在個人空間中，我使用的是文檔主題？

在你的空間中，檢查你這個空間十分使用的是文檔主題的最簡單的方法是，在頭部查找 瀏覽（Browse）菜單，一般這個在 建立（Create）按鈕的附近。（若是你已經正在使用默認主題，你將會在邊欄中看見空間工具菜單）。

若是檢查在個人站點中有哪些地方使用了文檔主題？

一般沒有很好的方法來在一個站點中列出正在使用的文檔主題列表。若是你的 Confluence 站點比較龐大，你的 Confluence 管理員可使用下面的查詢語句來從數據庫中載入全部使用文檔主題的列表。

SELECT * FROM BANDANA B, SPACES S WHERE B.BANDANAKEY='atlassian.confluence.theme.settings' AND S.SPACEKEY=B.BANDANACONTEXT AND B.BANDANAVALUE LIKE ('%documentation%') ORDER BY S.SPACENAME;

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

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

在升級的過程當中，咱們將會對當前使用文檔主題的空間應用默認的主題。若是你對這些文檔主題進行了自定義（例如，添加 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