AEM Guides中的內容重複使用性

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

使用者
管理員

AdobeAEM Guides運用DITA的長處，提供使用者易用的介面以重複使用內容。

本文將討論：

使用主題參考可重複使用(
使用內容參考的可重複使用性(
在AEM Guides中拖放以重複使用內容的額外秘訣

使用主題參照(topicref)可重複使用

假設您是一間製造公司，擁有安全預防或疑難排解技巧的一般主題。

這些可在每個機器型號的特定使用者手冊中參考和改寫，減少備援並確保核心安全資訊保持一致。

<map id="user_manual_model 100" title="ABC Model 100 User Manual ">


<topicref href="Safety_Information.dita" format="dita">
</topicref>
.
.
.
.
.
</map>

同樣適用於Model 200

<map id="user_manual_model 200" title="ABC Model 200 User Manual ">

<topicref href="Safety_Information.dita" format="dita">
</topicref>
.
.
.
.
.

</map>

使用內容參考可重複使用(conref & conkeyref)

內容參照(conref)屬性可讓您連結至內容的其他部分。如此可提升可重複使用性，並減少備援。

例如：

假設您是一家金融企業，並且有一個通用的KYC主題，其中包含適用於個人、公司等的KYC程式。

您想要針對「儲存帳戶」和「需求帳戶」主題重複使用個別KYC片段。

<section id="kyc_requirements_saving_account">
  <title>Know Your Customer (KYC) Requirements</title>
  <p>To comply with regulations and ensure customer identification, all individual applicants for savings  accounts must fulfill the KYC requirements as outlined below</p>
  <p conref=kyc_procedures.dita#individual_kyc></p>
</section>

此處conref=kyc_procedures.dita#indvidual_kyc kyc_procedures.dita是檔案識別碼，#individual_kyc是片段識別碼。

Kyc_procedure.dita仍然是唯一的資訊來源。如果法規變更需要更新KYC程式，請使用新的路徑更新主題路徑。這些變更會自動反映在所有參照它的主題中。

使用AEM Guides時，只要按兩下

步驟1：按一下「插入可重複使用的內容」
工具列

步驟2：選取需要重複使用的檔案和片段。
conref

與「conref」類似，您也可以使用「conkeyref」，除了提供內容路徑以外，您還可以透過索引鍵參考內容

程式碼範例：

<section conkeyref="kyc_procedure/individual_kyc_procedure" id="individual_kyc_procedure"></section>

金鑰定義如下：

<map id="ABC_manual">
  <title>ABC_Manual</title>
  <topicref href="kyc_procedure_2020.dita" keys="kyc_procedure" processing-role="resource-only" type="concept">
  </topicref>
  <topicref href="savings_account.dita" type="concept">
  </topicref>
</map>

索引鍵 — 'Kyc_procedure'仍然是單一資訊來源。如果根據法規要求對KYC流程有任何變更，您只需要以新主題路徑更新一個主題路徑，這些變更會自動反映在引用它的所有主題中。

<map id="ABC_manual">
  <title>ABC_Manual</title>
  <topicref href="kyc_procedure_2024.dita" keys="kyc_procedure" processing-role="resource-only" type="concept">
  </topicref>
  <topicref href="savings_account.dita" type="concept">
  </topicref>
</map>

在此處，由於最近的規則變更，主題路徑已從「kyc_procedure_2020.dita」變更為「kyc_procedure_2024.dita」。

使用AEM Guides時，只要按兩下

步驟1：按一下「插入可重複使用的內容」
工具列

步驟2：選取您的根對應（選用）、金鑰以及需要重複使用的片段。
conkeyref