瞭解編輯器功能 id176NC500V5Z

雲端服務：如果您正在使用雲端服務，選取​ Assets ​選項會帶您前往AEM導覽頁面。

內部部署軟體：如果您正在使用Adobe Experience Manager Guides （4.2.1和更新版本），選取​ Assets ​選項會帶您前往Assets UI中的目前檔案路徑。

一般：「一般」設定可讓您設定字典以搭配編輯器使用。 此索引標籤包含四個區段： 拼字檢查、條件、製作 ​以及​ 引文。

{width="650"}

• 拼字檢查：有兩個選項 — AEM拼字檢查 ​和​ 瀏覽器拼字檢查。 依預設，編輯器會使用瀏覽器拼字檢查功能，其中拼字檢查是使用瀏覽器的內建字典執行。 您可以切換至AEM拼字檢查，以使用Adobe Experience Manager的字典，也可以自訂字典以新增自訂字詞清單。 如需自訂AEM字典的詳細資訊，請檢視安裝與設定AEM as a Cloud Service中的自訂Adobe Experience Manager Guides的預設字典區段。

• 狀況

  • 在作者檢視中反白條件文字：選取此選項以在作者檢視中反白條件文字。 條件內容會使用為條件定義的顏色反白顯示。

  • 使用條件屬性進行驗證：選取此選項可允許驗證為屬性定義的值。 這可防止您新增任何不正確的值。

  • 在主旨配置面板中顯示具有標題的金鑰：選取此專案可顯示主旨配置中的金鑰與標題。 如果您未選取此選項，則只會顯示標題。 例如，這裡的索引鍵「os」、「audience」和「other」也會與標題一起顯示。

    {width="550"}

  • 在[條件]面板中顯示主旨配置：選取此專案，在條件面板中檢視主旨配置。 如果取消選取此專案，定義的條件會顯示在「條件」面板中。

• 製作

  • 啟用「全部取代」：選取此項以檢視「尋找和取代」面板中的「全部取代」圖示。

• 引文
  變更引文樣式。 從您要在專案中使用的下拉式清單中選擇引文樣式。 如需詳細資訊，請檢視變更引文樣式。

• AI小幫手
  選取此項以啟用Experience Manager Guides中的AI小幫手功能。 取消選取以停用該功能。

元素清單：身為管理員，您可以控制作者可以插入檔案的元素清單，也可以定義元素的顯示名稱。 「元素」清單設定可讓您根據DITA規格來指定元素名稱，並指定您要使用的標籤，而不是DITA定義的元素名稱：

{width="650"}

屬性清單：與元素清單類似，您可以控制要在元素的屬性清單中顯示的屬性清單及其顯示名稱。 在下列熒幕擷圖中，只有3個屬性已設定為顯示在元素的屬性清單中：

{width="650"}

透過此設定，當您嘗試將屬性新增至元素時，您只會檢視在清單中設定的屬性清單。

{width="300"}

色彩：顯示​ 條件 ​的預先設定背景色彩清單。 使用者可在將條件套用至主題時選取背景顏色。 作為管理員，您還可以建立自訂背景顏色並將其新增到清單中。 若要新增顏色，請在​ 顏色名稱 ​欄位中輸入所要的名稱，選擇自訂顏色，然後選取​ + ​圖示。 自訂顏色會顯示在顏色清單的末尾。

發佈設定檔：這包含可用來發佈​ 知識庫 ​輸出的設定檔。 您可以為目標知識庫建立新的設定檔。 例如，Salesforce或ServiceNow。

• 建立Salesforce設定檔

  必備條件

  • 為Salesforce建立連線應用程式。 如需詳細資訊，請參閱啟用API整合的OAuth設定。

  • 設定連線應用程式時，請確定下列事項：

    • 指定回呼。

      URL: http://<server name>:<port>/bin/dxml/thirdparty/callback/salesforce

    • 選取下列OAuth範圍：

      • 完整存取權（完整）
      • 選取「透過API管理使用者資料(API)」

  設定應用程式後，Salesforce會提供​ 消費者金鑰 ​和​ 消費者機密。 這些可用來建立Salesforce設定檔。

• 若要建立Salesforce設定檔，請從​ 伺服器型別 ​下拉式清單中選取​ Salesforce ​知識庫。 輸入設定檔名稱。 在​ 網站URL ​中，輸入您要用來發佈輸出的消費者網站，然後新增Salesforce消費者網站提供的​ 消費者金鑰 ​和​ 消費者機密。 然後，驗證 ​並​ 儲存 ​新建立的設定檔。

  在編輯器設定中 {width="550"}

  note note
  NOTE
  若要在Experience Manager Guides中設定Salesforce的Proxy，請使用AEM中的Apache HTTP元件Proxy設定。 瞭解如何設定AEM連結檢查器的Proxy。

• 建立ServiceNow設定檔

  必備條件

  設定ServiceNow伺服器以上傳資產。

  • 連線到​ ServiceNow ​伺服器。

  • 瀏覽至​ 系統屬性 > 安全性。

  • 取消核取下列選項：

    此屬性必須設定為啟動用於上傳的MIME型別檢查（所有版本Eureka及以上）。 啟用(true)或停用(false)檔案附件的mime型別驗證。 上傳期間將檢查透過glide.attachment.extensions設定的副檔名是否為MIME型別。

  • 選取「儲存」。

  設定應用程式之後，請建立​ ServiceNow ​設定檔。

• 若要建立設定檔，請從​ 伺服器型別 ​下拉式清單中選取ServiceNow知識庫。 輸入設定檔​ 名稱。 在​ ServiceNow URL ​中，輸入您要用來發佈輸出的消費者網站，然後新增ServiceNow消費者網站所提供的​ 使用者名稱 ​和​ 密碼。 然後，驗證 ​並​ 儲存 ​新建立的設定檔。

  {width="550"}

驗證之後，您可以在DITA Map的輸出預設集中選取發佈設定檔，並使用它產生輸出至您選擇的​ Salesforce ​或​ ServiceNow ​伺服器。

深入瞭解知識庫輸出預設集。

驗證：此索引標籤包含在編輯器中設定Schematron驗證的選項。 您可以啟用下列功能：

• 在儲存檔案之前執行驗證檢查：選取此項以在任何儲存作業之前使用選取的Schematron檔案執行Schematron驗證。 您可以選取+圖示來新增Schematron檔案。 隨即列出選取的Schematron檔案。

  note note
  NOTE
  選取的結構描述檔案將會在選取的資料夾設定檔中持續存在。

  在編輯器設定中進行 {width="550"}

  這可防止使用者儲存任何破壞所選Schematron檔案中定義規則的檔案。 如果未選取此專案，在儲存變更之前，將不會驗證檔案。

• 允許所有使用者在驗證面板中新增Schematron檔案：選取此選項可允許使用者在編輯器的驗證面板中新增任何Schematron檔案。 這可讓使用者新增Schematron檔案，然後針對Schematron檔案驗證主題。 如果未選取此專案，則編輯器​ 驗證面板 ​的使用者無法使用新增結構描述檔案​ 新增結構描述檔案 ​按鈕的選項。

顯示屬性：如同屬性清單一樣，您可以控制要在元素的屬性清單中顯示的屬性清單。 依照預設，有四個​ 顯示屬性 — 對象、平台、產品和prop已設定為顯示在元素的屬性清單中。 您也可以使用上方的​ 新增 ​圖示來新增顯示屬性。 您也可以使用​ 刪除 ​圖示來刪除任何顯示屬性。

為元素定義的屬性會顯示在「配置圖」和「大綱」檢視中。

{width="550"}

翻譯：此索引標籤包含建立語言群組、將來源標籤傳播至目標版本，以及清除翻譯專案的選項。

{width="550"}

• 語言群組：身為管理員，您可以建立語言群組，並將它們當做一組來翻譯內容。

  執行以下步驟來建立新的語言群組：

  1. 選取「新增」。

  2. 輸入語言群組名稱。 每種語言都應該有唯一的名稱。 如果名稱欄位空白或名稱不是唯一的，您可以檢視錯誤。

  3. 從下拉式清單中選取語言。 您可以選取多種語言。

     輸入語言的前幾個字元，或輸入語言代碼以篩選所需的語言。 例如，輸入'en'以篩選名稱或程式碼開頭包含'en'的所有語言。

  4. 選取「完成」圖示，將選取的語言新增至群組。 隨即顯示語言。 新增三種或更多語言時，會顯示​ 顯示更多 ​選項。 您可以選取​ 顯示更多 ​來檢視群組中存在的所有語言。

     note tip
     TIP
     將​ 顯示更多 ​切換為​ 顯示更少 ​並只檢視幾種語言。

  5. 將滑鼠停留在群組中的語言上以編輯 或刪除 語言群組。

  6. 儲存​ 設定。

     note note
     NOTE
     身為使用者，您可以檢視設定至資料夾設定檔的語言群組。

• 將來源版本標籤傳播到目標版本：選取此選項可將來源檔案版本的標籤傳遞到轉譯的檔案。 預設為停用。

• 翻譯專案完成後的清理：選取此選項可設定在翻譯後自動停用或刪除翻譯專案。 依預設，會選取​ 無，這樣專案在翻譯後就會存在。

  如果您想稍後再使用翻譯專案，可以停用這些專案。 刪除專案會永久刪除專案中存在的所有檔案和資料夾。

中繼資料：您可以控制主題的版本中繼資料及其值顯示在​ 版本記錄 ​對話方塊中。 在中繼資料路徑中，指定您要從中挑選中繼資料的節點位置。 您也可以為中繼資料定義自訂名稱作為標籤。 預設屬性為「標題」、「檔案狀態」和「標籤」。

中繼資料可從資產的/jcr:content節點下的任何屬性中擷取，因此您可以將屬性的路徑新增為中繼資料路徑。

如果中繼資料路徑為空白，則會顯示錯誤。 如果您將標籤保留為空白，則會挑選最後一個元素作為標籤。

編輯器設定中的 {width="550"}

設定​ 版本記錄 ​對話方塊的中繼資料。

您也可以定義這些中繼資料標籤的顯示順序。 若要變更這些標籤的預設順序，請選取虛線以將標籤拖放到所需位置。
中繼資料標籤會以相同的順序顯示在編輯器的​ 版本記錄 ​對話方塊中。

合併主題檔案

若要合併主題中的變更，請執行下列步驟：

1. 在編輯器中開啟主題。

2. 選取​ 合併。

   「合併」對話方塊隨即顯示。

   {width="550"}

3. \（選擇性\） ​您也可以瀏覽並從存放庫的其他位置選取新檔案。

4. 選取要與檔案目前版本進行比較的檔案版本。

5. 從「選項」中選擇：

   • 從選取的版本追蹤變更：此選項會以追蹤變更的形式顯示所有內容更新。 然後，您可以選擇一次接受或拒絕一個檔案變更，或一次接受或拒絕全部檔案變更。

   • 還原至選取的版本：此選項會將檔案的目前版本還原至選取的版本。 此選項無法讓您控制接受或拒絕哪些內容。

6. 選取「完成」。

7. 如果您選取​ 從選取的版本 ​追蹤變更選項，則從選取的版本進行的所有變更都會顯示在右側面板的追蹤變更功能中。

   您可以從「追蹤的變更」面板選擇接受或拒絕所有註解，或接受或拒絕個別註解。

合併對應檔案

若要合併對映檔案中的變更，請執行下列步驟：

1. 在編輯器中開啟對應。

2. 選取​ 合併。

   「合併」對話方塊隨即顯示。

   {width="550"}

3. \（選擇性\） ​您也可以瀏覽並從存放庫的其他位置選取新檔案。

4. 選取要與檔案目前版本進行比較的檔案版本。

5. 從「選項」中選擇：

   • 從選取的版本追蹤變更：此選項會以追蹤變更的形式顯示所有內容更新。 然後，您可以選擇一次接受或拒絕一個檔案變更，或一次接受或拒絕全部檔案變更。

   • 還原至選取的版本：此選項會將檔案的目前版本還原至選取的版本。 此選項無法讓您控制接受或拒絕哪些內容。

6. 選取「完成」。

7. 如果您選取​ 從選取的版本 ​追蹤變更選項，則選取版本的所有變更都會顯示在「追蹤的變更」面板\（在右側\）中。

   您可以選擇從「追蹤的變更」面板接受或拒絕所有變更，或者接受或拒絕對應檔案中的個別變更。

選取元素：選取元素的開頭或結尾標籤，以選取其內容。

展開或收合標籤：選取+或 — 登入標籤，以展開或收合標籤。

使用內容功能表：內容功能表提供剪下、複製或貼上選取專案的選項。 您也可以在選取的元素之前或之後插入元素。 其他選項可讓您為選取的元素產生ID或開啟「屬性」面板。

拖放元素：選取元素的標籤，然後輕鬆將其拖放到您的檔案中。 如果放置位置是允許元素的有效位置，則元素會放置在放置位置。

目前位置的有效元素：清單會顯示您可在目前游標位置本身插入的元素。

目前位置以外的有效元素：清單會顯示您可以在元素階層內目前元素的任何父項之後插入的元素。

插入儲存格、列或欄

合併向右和向下方向的儲存格

水平或垂直分割儲存格

刪除儲存格、列或欄

產生ID

版本資訊會顯示目前版本的主題或地圖。 版本編號旁會出現星號(*)，表示未儲存的變更。

版本編號會隨著為主題或對應檔案建立的每個新版本而變更。 如果您正在處理新建立的檔案，則版本資訊會顯示為​ none。

另存為新版本 ​按鈕可儲存您在主題中所做的變更，並建立主題的新版本。

瀏覽至[存放庫]檢視中必要的檔案或資料夾，選取​ 選項 ​圖示以開啟內容功能表，然後選擇​ 新增至 > 集合。 在​ 新增至集合 ​對話方塊中，您可以選擇將檔案/資料夾新增至現有的我的最愛，或建立新的我的最愛。

{width="300"}

在編輯器中的檔案索引標籤上按一下滑鼠右鍵，開啟快顯功能表。 選擇​ 新增至 > 集合 ​以將檔案新增至您的最愛清單。

DITA檔案：您可以尋找位於所選路徑上的所有​ DITA主題 ​和​ DITA Map。 預設會選取這些專案。

非DITA檔案：您可以在選取的路徑中搜尋​ Ditaval檔案、影像檔案、多媒體、檔案 ​和​ JSON。

{width="300"}

使用快速篩選器搜尋 DITA 和非 DITA 檔案。

DITA元素：您也可以在指定的DITA元素的屬性中搜尋特定值。

• 選取​ 新增元素 ​以新增元素、屬性和值。
• 套用您選取的篩選器。

選取​ 全部清除 ​以清除所有套用的篩選器。

選取​ 關閉篩選器 圖示以關閉篩選器並返回存放庫的樹狀檢視。

新增：建立新的DITA主題、DITA map或資料夾。

建立新主題的步驟：

1. 選取​ 新增 > 主題。

2. 顯示​ 新主題 ​對話方塊。

   {width="300"}

3. 在​ 新主題 ​對話方塊中，提供下列詳細資料：

   • 主題的標題。

   • (Optional)*主題的檔案名稱。 會根據主題「標題」自動建議檔案名稱。 如果您的管理員已根據UUID設定啟用自動檔案名稱，則您將不會檢視「名稱」欄位。

   • 主題將依據的範本。 例如，對於現成可用的設定，您可以從「空白」、「概念」、「DITAVAL」、「參考」、「任務」、「主題」、「Markdown」、「字彙表」和「疑難排解」範本中選擇。 如果您的資料夾上設定了「資料夾設定檔」，則您將只會檢視在「資料夾設定檔」上設定的主題範本。

   • 您要儲存主題檔案的路徑。 依預設，存放庫中目前所選資料夾的路徑會顯示在「路徑」欄位中。

4. 選擇 建立。主題是在指定的路徑中建立。 此外，主題也會在編輯器中開啟以進行編輯。

建立新DITA map的步驟：

1. 選取​ 新增 > DITA對應。

2. 顯示​ 新地圖 ​對話方塊。

   {width="300"}

3. 在​ 新對應 ​對話方塊中，提供下列詳細資料：

   • 地圖的標題。
   • (Optional) ​對應的檔案名稱。 會根據地圖示題自動建議檔案名稱。 如果您的管理員已根據UUID設定啟用自動檔案名稱，則您將不會檢視「名稱」欄位。
   • 作為地圖基礎的範本。 例如，對於現成可用的設定，您可以從Bookmap或DITA map範本中選擇。
   • 您要儲存地圖檔案的路徑。 依預設，存放庫中目前所選資料夾的路徑會顯示在「路徑」欄位中。

4. 選擇 建立。會在路徑欄位中指定的資料夾中建立並新增對應。 此外，對應會在「對應」檢視中開啟。 您可以在地圖編輯器中開啟地圖檔案，並在其中新增主題。 如需新增主題至地圖檔案的詳細資訊，請檢視建立地圖。 或者，選取​ 在地圖主控台中開啟，在地圖主控台中開啟地圖。

建立新資料夾的步驟：

1. 選取​ 新增 > 資料夾。

2. 顯示​ 新資料夾 ​對話方塊。

   {width="300"}

3. 在​ 新資料夾 ​對話方塊中，提供下列詳細資料：

   • 資料夾的標題，會自動轉換為資料夾名稱。
   • 您要儲存資料夾的路徑。 依預設，存放庫中目前所選資料夾的路徑會顯示在「路徑」欄位中。

4. 選擇 建立。會在執行「建立資料夾」選項的資料夾中建立並新增資料夾。

上傳Assets：將檔案從您的本機系統上傳至Adobe Experience Manager存放庫中選取的資料夾。 您也可以將檔案從本機系統拖放至目前的工作主題上。 如果您想要將本機系統中的影像插入主題中，這會非常有用。

{width="300"}

您可以選取要上傳檔案的資料夾，系統也會顯示影像預覽。 如果要重新命名檔案，可在「檔案名稱」文字方塊中重新命名。 選取​ 上傳 ​以完成檔案上傳程式。 如果您在主題上拖放了影像檔案，則影像檔案會新增到文章中，並且也會上傳。

如果您的管理員已在​ XMLEditorConfig ​中啟用UUID選項，則您將會在​ Source ​屬性中檢視已上傳影像的UUID。

尋找資料夾 ​中的檔案：將焦點移至存放庫搜尋，您可以在其中輸入搜尋字詞。 搜尋會在存放庫中選取的資料夾下執行。 您也可以套用濾鏡以傳回DITA檔案、影像檔案或兩者。

{width="300"}

您也可以使用檔案的UUID進行搜尋。 在此情況下，搜尋結果會顯示DITA/XML檔案的標題，而如果檔案是影像檔案，則會顯示檔案的UUID。 在下列搜尋範例中，會搜尋影像檔案的UUID，搜尋結果會顯示原始影像檔案的UUID和參照該影像之檔案的主題標題。

{width="300"}

收合：收合存放庫中選取的資料夾。

新增至集合：將選取的資料夾新增至我的最愛。 您可以選擇將其新增至現有或新的集合。

重新整理：從存放庫取得新的檔案和資料夾清單。

在Assets UI中檢視：在Assets UI中顯示資料夾內容。

編輯：開啟檔案以進行編輯。 如果是.ditamap/.bookmap檔案，則會在地圖編輯器中開啟該檔案以進行編輯。

複製：使用此選項建立所選檔案的複製或復本。 您也可以選擇在重複資產提示中重新命名重複檔案。 依預設，檔案會以尾碼\（如filename_1.extension\）建立。 檔案的標題與來源檔案相同，新檔案從1.0版開始。複製所有參照、標籤和中繼資料時，基線不會複製到重複的檔案中。

鎖定：鎖定選取的檔案以進行編輯。 如果檔案已鎖定，將滑鼠指標停留在鎖定圖示上會顯示您​ 已鎖定（若您已鎖定），或是​ 已鎖定（若有其他使用者已鎖定）[使用者名稱]。

預覽：取得檔案（.dita、.xml、音訊、視訊或影像）的快速預覽，而不需要開啟它。 您可以調整預覽窗格的大小。 如果內容包含任何<xref>或<conref>，您可以選取它以在新的索引標籤中開啟。 檔案的標題會顯示在視窗中。 如果沒有任何標題，則會顯示檔案名稱。 若要關閉​ 預覽 ​面板，您可以選取關閉圖示或選取窗格之外的任何位置。

重新命名：使用此選項來重新命名選取的檔案。 在​ 重新命名資產 ​對話方塊中輸入新檔案的名稱。

• 您可以重新命名任何型別的檔案。
• 您無法變更檔案的副檔名。
• 兩個檔案不能有相同的名稱。 因此，您無法將檔案重新命名為已存在的名稱。 顯示錯誤。

移至：使用此選項將選取的檔案移至其他資料夾。

• 您可以輸入目的地資料夾的名稱，或選擇​ 選取路徑 ​來選取目的地資料夾。
• 您可以將任何型別的檔案移動到「內容」資料夾內的任何目的地。
• 兩個檔案不能有相同的名稱。 因此，您無法將檔案移至相同名稱的檔案已經存在的資料夾。

如果您嘗試將檔案移動到某個資料夾，而該資料夾中存在名稱相同但標題不同的檔案，則會顯示「重新命名並移動檔案」對話方塊，而且您需要在移動檔案之前重新命名檔案。 目的地資料夾中移動的檔案具有新檔案名稱。

{width="550"}

排除情況

在下列情況下，Experience Manager Guides不允許您重新命名或移動檔案：

• 如果檔案是稽核或翻譯工作流程的一部分，則無法移動或重新命名檔案。

• 如果有任何其他使用者鎖定檔案，您無法重新命名或移動它，則不會檢視檔案的「重新命名」或「移至」選項。

刪除：使用此選項刪除選取的檔案。 刪除檔案前會顯示確認提示。

• 刪除檔案前會顯示確認提示。

• 如果檔案未從任何其他檔案參照，則會刪除檔案並顯示成功訊息。

• 如果檔案已鎖定，您就無法將其刪除，且會顯示錯誤訊息。

  note note
  NOTE
  如果您的管理員已阻止刪除鎖定的檔案，則只會顯示錯誤訊息。 如需詳細資訊，請檢視「安裝與設定Adobe Experience Manager Guides as a Cloud Service」中的​ 防止刪除取出檔案 ​區段。

• 如果檔案已新增至集合，則會顯示​ 強制刪除 ​對話方塊，您可以強制刪除它。

• 如果從任何其他檔案參照檔案，則會顯示包含確認訊息的​ 強制刪除 ​對話方塊，您可以強制刪除檔案：

  {width="300"}

  note note
  NOTE
  如果您的管理員已授予檔案刪除許可權，則會啟用​ 強制刪除。 否則，強制刪除 ​已停用，且會顯示一則訊息，指出您沒有許可權刪除參考的檔案。 如需詳細資訊，請檢視「安裝與設定Adobe Experience Manager Guides as a Cloud Service」中的​ 防止刪除參考的檔案 ​區段。

• 如果刪除參照主題並開啟包含要編輯參照的檔案，將會顯示參照檔案的斷開連結。

複製：您可以選擇下列選項：

• 複製UUID：將所選檔案的UUID複製到剪貼簿。

• 複製路徑：將所選檔案的完整路徑複製到剪貼簿。

新增至：您可以選擇下列選項：

• 集合：將選取的檔案新增至集合。 您可以選擇將其新增至現有或新的集合。

• 可重複使用的內容：將選取的檔案新增至左側面板中的[可重複使用的內容]清單。

屬性：使用此開啟所選檔案的屬性頁面。 也可以從Assets UI存取此屬性頁面，方法是選取檔案，然後選取工具列中的「屬性」圖示。

在地圖儀表板中開啟：如果選取的檔案是DITA map，則此選項會開啟地圖儀表板。

在對應主控台中開啟：如果選取的檔案是DITA map，則此選項會開啟對應主控台。

在氧氣中編輯：選取此選項可編輯氧氣聯結器外掛程式中選取的檔案。 已開啟檔案進行編輯。

在Assets UI中檢視：使用此專案來顯示Assets UI中.dita/.xml檔案的預覽。 若是.ditamap/.bookmap檔案，對應中的所有主題檔案都會以單一統一的逐頁檢視顯示。

下載為PDF：使用選項來產生PDF輸出並下載。

產生：使用選項將地圖或地圖內的主題發佈到網站頁面、內容片段或體驗片段。