設定全域或資料夾層級設定檔 id181AH2003PF

在企業中,不同的群組或產品可能會使用不同的編寫範本、輸出範本、條件屬性設定檔\(或主旨配置\)和網頁編輯器設定。 僅在企業層級\(或全域\)設定這些專案,可能會讓作者體驗困難,因為他們會看到與他們無關的範本或設定檔。

AEM Guides可讓您在企業\(全域\)層級和檔案夾層級設定編寫\(主題或地圖\)範本、輸出範本、條件屬性和Web編輯器設定。 如此一來,您就可以分隔企業中不同部門或產品的組態。

此外,您也可以將檔案夾特定的設定委派給部門或產品管理員,以分散管理。

使用「參考線」設定中的「資料夾設定檔」圖磚,您可以在下列標籤下設定設定:

{width="800"}

  • 一般: 「一般」標籤只有在您設定資料夾層級\(或專案/產品\)設定時才可用。 您可以進行設定,例如可套用設定的資料夾路徑,以及具有建立或更新設定的管理許可權的使用者。

  • 條件屬性:使用此索引標籤可在全域或資料夾層級設定條件屬性。 條件屬性是屬性名稱和值的組合,您也可以為其定義標籤。 您可以使用標準DITA屬性或您自己的自訂屬性。 您在全域層級定義的條件屬性可供所有專案使用者使用。 如果您已定義資料夾層級的條件屬性,則會將這些屬性與全域定義的條件屬性合併。

  • 製作範本:使用此標籤來設定您的作者用來建立DITA內容的範本。 下列主題範本為現成可用:

    • 字彙表

    • 參考

    • 主題

    • 概念

    • 任務

    • 疑難排解

    • 空白

    • DITAVAL

    note note
    NOTE
    您可以使用任何現有範本作為建立新範本的基礎。 「空白DITA」範本不包含其他範本的任何結構或元素。 您可以使用任何OOTB DITA範本作為基礎,對其進行修改,並以不同的名稱儲存它。 完成必要的變更後,將更新後的範本新增至全域或資料夾層級製作範本組態,即可進行製作。

    除了主題範本以外,您也可以定義作者可用的對映範本。 下列地圖範本為現成可用:

    • 地圖

    • 書籤

  • 輸出預設集:與製作範本類似,有五個預先設定的輸出預設集:

    • AEM網站

    • PDF

    • HTML5

    • ePub

    • 自訂

    發佈者可以使用這些立即可用的輸出預設集來發佈內容。 這些預設集可由全域或資料夾層級設定檔的管理員設定。 設定之後,發佈預設集將可供發佈者用於新建立的DITA map。 您也可以將發佈預設集套用至現有的DITA map,請參閱套用預設集變更以取得詳細資料。

  • XML編輯器設定:使用此標籤來自訂Web編輯器的外觀和各種功能。 Web編輯器可使用下列可配置的設定:

    • XML編輯器UI設定
    • CSS範本佈局
    • XML編輯器代碼片段
    • XML內容版本標籤
    • Rootmap \(僅在資料夾層級\)

您可以同時設定 — 全域設定檔和資料夾層級的設定檔。 在資料夾層級設定檔中,您可以定義將套用設定的資料夾。 這些設定包括條件屬性、製作範本、輸出預設集和XML編輯器設定。 條件預設集、編寫範本和XML編輯器設定隨後可供在設定的資料夾中工作的作者使用。 同樣地,發佈者將可存取在已設定資料夾中定義的已設定輸出預設集。

資料夾層級設定檔會覆寫全域設定檔中設定的設定。 換言之,如果資料夾具有資料夾層級的設定檔,則會顯示在其對應資料夾設定檔中設定的編寫範本、輸出範本和XML編輯器設定。 它不會顯示全域設定檔中設定的設定。 但是,這不適用於條件屬性。 若是條件屬性,條件屬性會在全域和資料夾層級合併。

以下幾節將引導您完成設定全域設定檔和資料夾層級設定檔的過程。

設定全域設定檔

執行以下步驟來設定全域設定檔:

  1. 以管理員身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 指南,然後按一下​ 資料夾設定檔

    首次只顯示「全域設定檔」圖磚的「資料夾設定檔」頁面。

    {width="800"}

  4. 按一下​ 全域設定檔 ​圖磚。

  5. 若要設定​ 條件屬性,請參閱設定全域或資料夾層級設定檔的條件屬性

  6. 若要設定​ 編寫範本,請參閱設定編寫範本

  7. 若要設定​ 輸出預設集,請參閱設定輸出預設集

  8. 若要設定XML編輯器組態,請參閱設定和自訂XML Web編輯器

  9. 完成所有必要的更新後,儲存並關閉​ 全域設定檔

建立及設定資料夾層級設定檔

執行以下步驟來設定資料夾層級的設定檔:

  1. 以管理員身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 參考線,然後按一下​ 資料夾設定檔 ​圖磚。

    「資料夾設定檔」頁面第一次只顯示預設的「全域設定檔」圖磚。

  4. 按一下​ 建立

    {width="300"}

  5. 在​ 建立資料夾設定檔 ​對話方塊中輸入下列詳細資料:

    • 資料夾描述檔的名稱。

    • 將套用設定檔的資料夾路徑。

      note note
      NOTE
      您無法在一個資料夾上套用多個資料夾設定檔。 確定您在這裡選取的資料夾沒有套用任何其他設定檔。 如果父 — 子資料夾有自己的特定設定檔,則子資料夾將使用其自身設定檔中的設定。 來自父資料夾的設定不會覆寫子資料夾的設定。
  6. 按一下​ 建立

    在「資料夾設定檔」頁面中會建立具有資料夾設定檔名稱的新圖磚

  7. 按一下資料夾設定檔拼貼以進行編輯。

    會顯示具有資料夾設定檔名稱和已設定資料夾資訊的「一般」標籤。

  8. 按一下​ 編輯,新增多個資料夾,以及擁有管理存取許可權以修改資料夾設定檔的使用者。

    note note
    NOTE
    您在此處新增的使用者將具有管理許可權,可以更新為此資料夾設定檔設定的條件屬性、製作範本和輸出預設集。
  9. 若要新增資料夾,請按一下「資料夾路徑」中的「瀏覽」圖示,並導覽至資料夾並加以選取,然後按一下「新增」,將該資料夾新增至此設定檔。

    note note
    NOTE
    確定您在此選擇的資料夾沒有相關聯的其他資料夾層級設定檔。
  10. 若要新增使用者,請從​ 管理員使用者 ​下拉式清單中選取使用者,然後按一下​ 新增

    note note
    NOTE
    您可以從下拉式清單將多位使用者新增至資料夾設定檔。 您也可以按一下使用者ID旁邊的刪除圖示,從清單中移除現有的管理員使用者。
  11. 將所有必要的資料夾和使用者新增至資料夾設定檔後,按一下​ 儲存

現在您已準備好設定條件屬性、製作範本、輸出預設集和XML編輯器。

IMPORTANT
當您建立資料夾設定檔時,預設情況下它不包含任何編寫範本。 您必須在資料夾設定檔中新增必要的撰寫範本,才能讓作者使用。

設定全域或資料夾層級設定檔的條件屬性 id1889D0I305Z

執行以下步驟,在全域或資料夾層級設定標準DITA支援的條件屬性:

  1. 以管理員或具有檔案夾層級設定檔管理許可權的使用者身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 參考線,然後按一下​ 資料夾設定檔 ​圖磚。

  4. 按一下要設定的設定檔拼貼。

    note note
    NOTE
    您可以選擇在「全域設定檔」或資料夾層級設定檔中設定條件屬性。
  5. 在設定檔頁面上,按一下​ 條件屬性 ​標籤。

  6. 按一下​ 編輯

  7. 按一下​ 新增

  8. 輸入條件屬性的​ NameValue ​和​ Label

    您可以儲存僅具有屬性名稱的設定檔。 但是,屬性只有在指定了值時才可以使用。 如果同時指定屬性的 — 值和標籤,Web編輯器會顯示條件屬性的標籤。 此外,標籤會在建立條件式預設集時顯示給發佈管理員。

    下列熒幕擷圖顯示platform屬性的定義,以及可能的值和標籤。

    {width="650"}

  9. 如果您想要為相同屬性新增更多值,請按一下​ + ​圖示並輸入其他值和標籤。

  10. 若要新增更多屬性,請按一下[新增]。

  11. 按一下「儲存」。

使用自訂屬性

如果您使用自訂屬性,則它必須是DTD支援的有效DITA屬性。 如果您要使用任何屬性(不是標準DITA屬性),則執行下列額外步驟:

  1. 將自訂屬性新增至DTD檔案。 例如,如果DTD檔案是commonElements.mod,則需要在DTD目錄中尋找此檔案。 系統DTD檔案的預設路徑為:

    /libs/fmdita/dita_resources/DITA-1.3/dtd/base/dtd/commonElements.mod

    note important
    IMPORTANT
    專用的DTD檔案應該是自訂程式碼部署的一部分。 /etc下的DTD屬於產品部署的一部分,因此任何新發行版本的安裝都會加以覆寫。 建議在專案資料夾的/apps下新增專門的DTD,並在DITA設定檔中包含DTD/目錄路徑。如需詳細資訊,請參閱整合DITA專門化
  2. 開啟Adobe Experience Manager Web主控台設定頁面。

  3. 搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

  4. 儲存設定。

    這將會清除系統快取。

  5. 導覽至可在下列位置取得的condAttrList.xml檔案:

    /libs/fmdita/config/condAttrList.xml

  6. apps節點內建立config資料夾的覆蓋節點。

  7. 導覽至apps節點中的condAttrList.xml檔案,並將自訂屬性新增至:

    /apps/fmdita/config/condAttrList.xml

  8. 儲存檔案。

  9. 將自訂屬性新增到全域或資料夾層級的設定檔。

設定編寫範本 id1889D0IL0Y4

AEM Guides隨附7個現成的編寫範本和2個DITA map範本。 您可以選擇僅讓作者使用幾個範本。 若您使用自訂範本,則可設定該範本並供編寫使用。 您可以使用「資料夾設定檔」設定中的「編寫範本」標籤,從全域或資料夾層級的設定檔中新增或移除主題或對應範本。

甚至在全域或資料夾層級設定主題或地圖範本之前,您也可以定義儲存自訂編寫範本的位置。 若要設定自訂位置以儲存編寫範本,請參閱設定自訂DITA範本資料夾路徑

執行以下步驟,將主題或對應範本新增至資料夾設定檔:

  1. 以管理員或具有檔案夾層級設定檔管理許可權的使用者身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 參考線,然後按一下​ 資料夾設定檔 ​圖磚。

  4. 按一下要設定的設定檔拼貼。

    note note
    NOTE
    您可以選擇在「全域設定檔」或資料夾層級的設定檔中設定編寫範本。
  5. 在設定檔頁面上,按一下​ 編寫範本 ​索引標籤。

  6. 按一下​ 編輯

    透過從預設位置搜尋或瀏覽來取得新增主題和地圖範本的選項。

    note note
    NOTE
    依預設,所有編寫範本都會儲存在/content/dam/dita-templates資料夾中。 dita-templates資料夾包含topicsmaps子資料夾,以儲存主題和對應範本。 您可以將自訂範本(.dita、.xml或.ditamapfiles)加入預設範本資料夾中。 將範本新增至預設資料夾後,您就可以將它們新增至全域或資料夾設定檔中。 如需有關使用網頁編輯器建立自訂範本的詳細資訊,請參閱建立自訂編寫範本

    {width="550"}

  7. 新增必要主題並將範本對應至您的設定檔。

    若要新增範本,請執行下列任一項作業:

    • 選擇「搜尋」或「型別」,然後在下拉式清單中輸入或選取範本的名稱。 下拉式清單包含所有預設範本和您已建立的任何新範本。

      {width="350"}

    • 按一下「瀏覽」並從DAM中選取範本。

  8. 按一下​ 新增

    選取的範本會新增至範本清單中。

    {width="550"}

    note note
    NOTE
    您可以將範本拖放到清單中所需的位置以變更範本的順序。 範本的位置可控制範本在主題或地圖建立工作流程的Blueprint頁面中的顯示順序。
  9. 按一下「儲存」。

如果您已在資料夾層級設定檔上設定範本,則已設定的範本會與已設定的資料夾建立關聯。 在已設定的資料夾下建立的所有專案將只能存取在資料夾層級設定檔下設定的那些範本。

建立自訂編寫範本 id1917D0EG0HJ

AEM Guides可讓您輕鬆建立製作範本。 作為系統管理員,您可以使用Web編輯器從頭開始建立編寫範本。 然後,您可以在全域設定檔中新增範本,或使用資料夾特定設定檔將其指派給特定資料夾。

執行以下步驟來建立自訂編寫範本:

  1. 以管理員身分登入Adobe Experience Manager。

  2. 在Assets UI中,導覽至設定用來儲存範本檔案的資料夾。 依預設,所有主題範本都儲存在/content/dam/dita-templates/topics資料夾中。

    note note
    NOTE
    若要設定自訂位置以儲存主題或對應範本,請參閱設定自訂DITA範本資料夾路徑
  3. 按一下​ 建立 > DITA範本

  4. 在Blueprint頁面上,選取您要建立的DITA主題範本型別。

    note note
    NOTE
    您可以使用「空白」範本從頭開始。 「空白」範本沒有任何結構或元素。
  5. 按一下「下一步」。

  6. 在新範本[內容]頁面上,輸入範本的​ TitleName ​和​ Description

    note note
    NOTE
    系統會根據範本的標題自動建議名稱。 如果要手動指定名稱,請確定名稱不含任何空格、單引號或大括弧,且結尾為.dita。
  7. \(選擇性\) ​按一下​ 新增縮圖 ​按鈕到瀏覽器,並選取要與範本關聯的縮圖。

  8. 按一下​ 建立

    「主題已建立」訊息便會顯示。

    您可以選擇在Web編輯器中開啟範本以進行編輯,或將範本檔案儲存在範本存放區位置。 建立範本後,您就可以根據編寫需求,使用網頁編輯器來自訂範本。 設定好範本後,請確定您將其與全域或資料夾層級的設定檔建立關聯。

設定輸出預設集 id18AGD0IH0Y4

在典型的企業設定中,不同的輸出範本可用於不同的產品或使用手冊。 此外,也可能會有一些供所有發行者使用的通用輸出產生程式,以及一組用於特定發行者群組或專案的特定輸出產生程式。

AEM Guides可讓管理員使用特定設定建立輸出預設集,然後供所有或特定發佈者集使用以產生輸出。 例如,管理員可以建立一個輸出預設集,以產生所有發佈者通用的使用手冊。 此外,還有一份可建立一組發佈者專用的程式設計使用者手冊。 這兩個預設集都可設定為使用不同的輸出範本。 在此範例中,產生使用手冊的常見發佈預設集可在全域層級設定。 此外,產生程式設計使用者手冊的輸出預設集可在資料夾層級設定。

在系統中建立預設輸出預設集後,所有在此之後建立的DITA map都會使用預設預設集來產生輸出。 但是,所有現有DITA map都會繼續使用先前使用它們設定的輸出預設集。 如果您想要在所有現有DITA map上套用新的輸出預設集,則需要執行套用預設集變更工作流程。

除了在全域或企業層級設定的預設集之外,發行者仍然有權建立更多輸出預設集。 但是,這些預設集會繫結到為其建立預設集的DITA map。 如需有關為DITA map建立一般輸出預設集的詳細資訊,請參閱​ 使用Adobe Experience Manager Guides ​中的​ 建立、編輯、複製或移除輸出預設集

執行以下步驟來設定全域或資料夾特定的輸出預設集:

  1. 以管理員或具有檔案夾特定設定檔之管理許可權的使用者身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 參考線,然後按一下​ 資料夾設定檔 ​圖磚。

  4. 按一下要設定的設定檔拼貼。

    note note
    NOTE
    您可以選擇在全域設定檔或資料夾特定設定檔中設定輸出預設集。
  5. 在設定檔頁面上。 按一下​ 輸出預設集 ​索引標籤。

    隨即顯示現成可用的輸出預設集清單,其中包括「AEM網站」、「PDF」、「HTML5」、「EPUB」和「自訂」。

  6. 執行下列任一項作業,以建立或編輯輸出預設集:

    • 按一下[建立​ ]從頭開始建立新的輸出預設集。

    • 按一下「複製」以建立所選輸出預設集的副本。 您可以變更並儲存重複的預設集。

    • 按一下​ 編輯,開啟選取的預設集組態以進行編輯。

      如需輸出預設集設定的相關資訊,請參閱「使用Adobe Experience Manager Guides」中的​ 瞭解輸出預設集

  7. 按一下​ 儲存 ​以儲存預設集設定。

在此之後建立或上傳的所有DITA map都會有新的或更新後的輸出預設集。

套用預設集變更 id18AGD0K0OHS

在全域性層級建立的新輸出預設集可用於以後建立的所有新DITA map。 同樣地,如果在資料夾層級建立新的輸出預設集,則該預設集可用於將在已設定資料夾中建立的所有對映。 依預設,新的輸出預設集不適用於任何現有的DITA map。

如果您已更新現有的輸出預設集,或想要讓新的輸出預設集可用於現有DITA map,則請執行下列步驟:

  1. 以管理員或具有檔案夾特定設定檔之管理許可權的使用者身分登入Adobe Experience Manager。

  2. 按一下頂端的Adobe Experience Manager連結,然後選擇​ 工具

  3. 從工具清單中選取​ 參考線,然後按一下​ 資料夾設定檔 ​圖磚。

  4. 按一下要設定的設定檔拼貼。

    note note
    NOTE
    您可以選擇在全域設定檔或資料夾特定設定檔中設定輸出預設集。
  5. 在設定檔頁面上。 按一下​ 輸出預設集 ​索引標籤。

    隨即顯示現成可用的輸出預設集清單,其中包括「AEM網站」、「PDF」、「HTML5」、「EPUB」和「自訂」。

  6. 選取要套用至現有DITA map的輸出預設集。

  7. 按一下主工具列中的​ 套用預設集變更

  8. 在「套用預設集變更」對話方塊中,您可以選擇以下選項:

    • 選取「覆寫現有的預設集」選項:如果您選取此選項,則您在現有輸出預設集中所做的任何更新都會覆寫使用該預設集的所有現有DITA map中的設定。 但是,這樣做會遺失與地圖相關聯的任何現有條件預設集和基線資訊。

    • 未選取覆寫現有預設集選項:如果您未選取此選項,則您在現有輸出預設集中所做的任何更新都不會影響現有的DITA map。 只有新加入的預設集會加入至現有的DITA map。 請注意,新建立的DITA map會同時取得更新後的輸出預設集和新加入的預設集。

  9. 按一下​ 確定,在所有現有DITA map上套用所選輸出預設集的變更。

設定和自訂XML Web編輯器 id2065G300O5Z

依預設,XML Web編輯器附帶許多功能,可協助您的作者建立DITA檔案。 如果您在限制性的環境中工作,您可以選擇向作者公開哪些功能。 XML編輯器設定索引標籤可讓您輕鬆控制功能,並且變更網頁編輯器的外觀。 身為管理員,您可以自訂Web編輯器的下列元件:

XML編輯器UI組態

此設定控制網頁編輯器的工具列和其他使用者介面元素。 按一下「下載」圖示,在本機系統上下載最新的ui_config.json檔案。 然後,您可以對檔案進行變更,並上傳相同的檔案。 按一下​ 下載預設值 ​圖示,將預設的ui_config.json檔案下載到您的本機系統。 您一律可以下載預設檔案、變更及上傳檔案。根據您上傳檔案的位置(全域或資料夾層級設定檔),變更會據此套用。 如需有關如何使用ui_config.json檔案自訂XML編輯器的詳細資訊,請參閱自訂工具列

CSS範本配置

下載此區段中可用的檔案,以自訂在網頁編輯器中預覽或開啟檔案以進行編輯時的外觀。 可供下載的預設CSS檔案只是一個測試檔案,不應將其用於自訂。 您可以建立包含網頁編輯器自訂的CSS檔案並上傳相同的CSS檔案。 例如,您可以使用以下程式碼建立.css檔案:

.title {    font-size: 9em;}

儲存此檔案並將其上傳至「CSS範本配置」區段。 下次下載檔案時,您將會取得網頁編輯器中使用的最新CSS檔案。

XML編輯器程式碼片段

使用本節中的設定檔案,您可以建立一些預設程式碼片段,並與作者共用。 檔案的預設結構如下:

{
   "snippetID": {
      "name": "snippet Name",
      "description": "snippet Description",
      "value": "<i>this is snippet value</i>"
  }
}

建立程式碼片段需要下列詳細資料:

  • 代碼片段識別碼: 程式碼片段的唯一ID。 它可以採用英數字元值。

  • 名稱: 用於識別程式碼片段的描述性名稱。 此名稱會顯示在「代碼片段」面板中。

  • 描述: 為程式碼片段新增描述性資訊。

  • 值: 提供程式碼片段的XML程式碼。

NOTE
您可以在程式碼片段定義結尾加上逗號(,),重複下一個程式碼片段的相同結構,以新增更多程式碼片段。

XML內容版本標籤

依預設,作者可建立自己選擇的標籤,並將標籤與主題檔案建立關聯。 但是,這可能會導致同一標籤的許多變化,例如可能會有「版本1.0」、「版本1.0」、「版本1」標籤,用於識別主題的相同階段。 為了避免系統中的標籤不一致,您可以建立預先定義的標籤清單,讓作者從中進行選擇。 擁有一致的標籤有助於更好地管理系統中的檔案。

使用版本標籤設定,您可以上傳組織的有效標籤清單。 下載預設的label.json檔案並加以修改,如下所示:

{
"label1":"Draft",
"label2":"PM-Review",
"label3":"Engg-Review",
"label4":"QE-Review",
"label5":"Ready for Loc",
"label6":"Ready for Publish"
}

在上述範例中,「label1」是標籤順序的識別碼,只要需要標籤,就會將標籤附加至作者。 儲存此檔案並將其上傳至「XML內容版本標籤」區段。

IMPORTANT
為了讓檔案夾層級設定生效,使用者必須在網頁編輯器中,於其「使用者偏好設定」下選取設定檔。

Rootmap

如果您的作者使用特定的根對應,您可以在此處瀏覽並選取該根對應。 請注意,您只能為資料夾層級的設定檔定義rootmap。

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178