Administering Collaborative Editing

昵稱16099352 2019-08-16

展開全文

修改編輯模式

編輯模式確定了你站點所有用戶使用協(xié)同編輯的體驗，這個是你對協(xié)同編輯進行啟用和關閉的地方。

希望修改編輯模式：

進入 > 基本配置（General Configuration） > 協(xié)同編輯（Collaborative editing）。
選擇 編輯模式（Change mode）。
選擇一個模式，然后選擇 修改（Change）。

修改編輯模式其實是不重要的，一些修改可能會導致你的用戶丟失他們的草稿，因此針對某個模式，你最好需要知道修改將會導致那些問題。

有下面的模式可用：

模式（Mode）

提示（Implications）

啟用（On）

這個模式允許你的小組可用同時進行編輯和分享操作，同時實時的能夠看到其他用戶的修改。

這是推薦的編輯模式。

限制（Limited）

如果你需要對 Synchrony 進行問題排除的話，這個模式將會包含你用戶分享草稿。建議僅僅在當你覺得你的系統(tǒng)在編輯和發(fā)布的時候遇到問題了，選擇這個模式。

你用戶的編輯體驗將會受限：

只有一個用戶可以編輯一個共享的草稿，而且僅僅只有這個用戶可以編輯。
你不可以在頁面的歷史中恢復到早期的版本。
你不可以移動頁面。
你不可以在頁面中進行行標注。

當 Synchrony 再次運行后，我們推薦你將協(xié)同編輯設置回啟用模式。

關閉（Off）

這個模式意味著你的小組僅僅可以編輯自己的頁面草稿。Confluence 將會嘗試在保存的時候合并有沖突的編輯。這個模式與 Confluence 5 編輯使用的模式相同。

這個模式在你不能在你的系統(tǒng)中成功運行 Synchrony 的時候有用，或者你決定協(xié)同編輯模式并不適用你的環(huán)境（例如，你現(xiàn)在正在審計需求，你不希望頁面被編輯，在這個情況下，協(xié)同編輯對你并不合適）。

在你將協(xié)同編輯模式修改為關閉的時候，你應該確保你的用戶保存的所有草稿都已經(jīng)被發(fā)布了。

最大編輯者的限制

我們限制為最多 12 個用戶可以同時對一個頁面進行編輯。這個意味著當一個頁面已經(jīng)有 12 個用戶正在編輯了，13 個用戶是不能進入編輯界面的，直到 12 個用戶中有一個用戶已經(jīng)離開了。

系統(tǒng)管理員可以使用 Configuring System Properties 頁面中描述的配置來增加或者減少這個限制。當你覺得在多個用戶進行協(xié)同編輯的時候遇到了性能問題，你應該考慮降低允許協(xié)同編輯的用戶數(shù)量。

審計的考慮

我們知道一些客戶對審計是主要考慮的方面。我們不能保證在協(xié)同編輯的時候具有審計，審查功能。所有頁面的修改當前附加到用戶發(fā)布頁面的屬性中而不是用戶的特定修改。

如果這個對你來說是一個問題的話，我們建議你在你的站點中關閉協(xié)同編輯。

在未發(fā)布的草稿中沒有版本歷史

我們現(xiàn)在保存了在系統(tǒng)編輯中的所有時間的編輯，但是我們不會保存沒有發(fā)布修改的的版本。當你恢復到早期頁面的版本的時候，你僅僅可以恢復到一個已經(jīng)存在的發(fā)布版本中。當你恢復到前一個版本的時候，所有未發(fā)布的的修改都會丟失。

匿名用修改的內容是否可見

當你為匿名用戶賦予 添加（Add ）頁面權限的時候有其他的一些事情你需要注意（和全局權限的 可以使用（Can use））。

當一個為發(fā)布頁面是由匿名用戶創(chuàng)建的時候，關閉一個編輯或者發(fā)布一個頁面的時候你不會收到警告。這個可能會導致登錄的用戶的編輯會被中斷和打擾。

他們自己的修改是可以在頁面中可見，但是通常警告對話框將不會出現(xiàn)，如果是沒有登錄用戶做的修改的話。

針對登錄的用戶和匿名用戶都有未發(fā)布的修改，這個對話框將會顯示，但是僅僅是登錄的用戶才能看到對話框。所有用戶的修改（包括匿名用戶）將會被包括進來，當你從對話框中查看修改的內容進行查看的話。

修改你的 Synchrony 配置

你不能通過 Confluence UI 修改 Synchrony 的配置。配置的修改是通過系統(tǒng)屬性進行修改的。在絕大部分情況下，你不需要對默認的配置進行修改。

修改 Synchrony 運行的端口...

修改 Synchrony 的最大 heap 值

請參考 Recognized System Properties 頁面中的內容來獲得所有有關 Synchrony 的系統(tǒng)屬性。

如果你需要針對 Synchrony 虛擬機傳遞其他的參數(shù)，創(chuàng)建一個名為 synchrony-args.properties 的屬性文件。這個文件位于 Confluence 的 home 目錄中，然后在這個文件中輸入你希望傳遞進去的參數(shù)，每行一個參數(shù)。

property1=value1

property2=value2

這個將會添加 -Dproperty1=value1 -Dproperty2=value2 到 Synchrony 命令行中。這個功能只能在 Confluence 6.0.2 及其后續(xù)版本中有效。

你不能使用這個方法傳遞在系統(tǒng)數(shù)據(jù)中已經(jīng)有的值，例如端口， Xmx 或 Xss 等。請參考 Configuring System Properties 頁面中的內容來獲得所有的屬性列表。

代理和 SSL 的考慮

對于你如何連接 Synchrony 是與你的環(huán)境有關的。我們知道絕大部分的 Confluence 站點是運行在反向代理后面的，同時還使用了 SSL。這里是幫助你在你環(huán)境中識別正確的配置的一些信息和一些針對你環(huán)境需要做的一些協(xié)同合作方面的修改。

SSL

Synchrony 運行在一個獨立的 JVM，這個并不需要支持直接的 HTTPS 連接。如果你沒有使用反向代理，SSL 應該在 Tomcat 中定義，如果你使用了方向代理或者負載均衡。那么 SSL 應該在你的反向代理和負載均衡中進行配置和定義。

Proxies

在下面的圖表中，我們使用 Confluence 運行的環(huán)境下通常的代理和反向代理配置，同時 Confluence 也運行在 /confluence 上下文路徑，（例如， www./confluence）。如果你的 Confluence 沒有使用上下文，那么這個概念和配置也是一樣的（例如，www.）。

下面的配置只是特定于 Confluence 服務器，如果你使用的是數(shù)據(jù)中心，請參考 Configuring Synchrony for Data Center 頁面中的內容來獲得更多信息。

沒有反向代理

如果你沒有在 Confluence 中使用反向代理，那么你的會通過 Confluence 的內部 Synchrony 代理連接到 Synchrony。如果使用了 SSL 的話，那么這個是通過 Tomcat 決定的。這個是默認的配置，針對這個情況你在啟用協(xié)同編輯的時候不需要進行任何進一步的修改。

使用一個反向代理

如果你的 Confluence 是運行在一個反向代理后面的話，你需要通過 Confluence 內部 Synchrony 代理來連接 Synchrony 。這個是反向代理的默認設置，如果你不希望開發(fā) 8091 端口的話，這個也是一個很好的選擇。SSL 應該通過你的額反向代理服務器來配置和確定。

針對 Synchrony 配置你不需要做任何進一步的反向代理配置，但是在最好的情況下，你的反向代理應該支持 WebSocket 連接（你需要在你的代理中手動啟動這個）。

為了告訴 Confluence 你希望使用內部代理，設置 synchrony.proxy.enabled system property 中的配置設置為 true。（這個是可選的，但是這個可以避免 Confluence 在通過內部代理之前來通過 /synchrony 來找到 synchrony）。

如果 Synchrony 不能訪通過 /synchrony-proxy 進行訪問，我們將會自動的嘗試 /confluence/synchrony-proxy （/confluence 是你 Confluence 的上下文）。

Synchrony 使用一個反向代理目錄

如果你的 Confluence 是運行在一個反向代理的后面，但是你在通過 Confluence 的內部 Synchrony 代理進行連接的時候遇到了問題或者無法連接的情況，你可以選擇連接目錄到 Synchrony。這個是最佳的設置，但是不需要你環(huán)境做一些改變。你需要打開 8091 端口，同時添加 /synchrony 到你的反向代理配置中。SSL 還是通過你反向代理服務器決定和定義的，Synchrony 還不能接受 HTTPS 的連接。