Merge Parameters & Customizing to “Configuring”

Signed-off-by: Roger Sheen <[email protected]>

index.dita

@@ -38,16 +38,8 @@
           content to other formats, including the <cmdname>dita</cmdname> command, Ant, and the Java API, along with
           information on building output from a containerized environment such as Docker or GitHub Actions.</li>
         <li outputclass="list-group-item list-group-item-action">
-          <xref keyref="parameters" outputclass="stretched-link"/> explains how to adjust the behavior of DITA Open
-          Toolkit via <cmdname>dita</cmdname> command arguments and options, DITA-OT parameter settings, and
-          configuration properties.</li>
-        <li outputclass="list-group-item list-group-item-action">
-          <xref keyref="html-customization" outputclass="stretched-link"/> shows how to <ph
-            conkeyref="html-customization/shortdesc-ph"
-          />.</li>
-        <li outputclass="list-group-item list-group-item-action">
-          <xref keyref="pdf-customization" outputclass="stretched-link"/> explains how to <ph
-            conkeyref="pdf-customization/shortdesc-ph"
+          <xref keyref="parameters" outputclass="stretched-link"/> explains how to <ph
+            conkeyref="parameters/ph_docs-pr-desc"
           />.</li>
         <li outputclass="list-group-item list-group-item-action">
           <xref keyref="extending" outputclass="stretched-link"/> explains how to install, remove, and discover

parameters/index.dita

@@ -2,12 +2,12 @@
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
 <!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->
 <reference id="ID">
-  <title>DITA Open Toolkit parameters</title>
+  <title>Configuring DITA-OT</title>
   <titlealts>
-    <navtitle>Parameters</navtitle>
+    <navtitle>Configuring</navtitle>
   </titlealts>
   <shortdesc>
-    <ph id="ph_docs-pr-desc">You can adjust DITA Open Toolkit behavior via <cmdname>dita</cmdname> command arguments and
-      options, DITA-OT parameter settings, and configuration properties.</ph>
+    You can <ph id="ph_docs-pr-desc">adjust DITA Open Toolkit behavior via <cmdname>dita</cmdname> command arguments and
+      options, parameter settings, and configuration properties</ph>.
   </shortdesc>
 </reference>

parameters/parameters.ditamap

@@ -2,7 +2,7 @@
 <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
 <!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->
 <map>
-  <title>Parameter Reference</title>
+  <title>Configuration</title>
   <topicref keyref="dita-command-arguments"/>
   <topicref keyref="parameters_intro" keys="dita-ot-params">
     <topicref keyref="parameters-base"/>
@@ -26,4 +26,10 @@
     <topicref keyref="configuration-properties-file"/>
     <topicref keyref="internal-ant-properties"/>
   </topicref>
+  <topicref keyref="html-customization" collection-type="family">
+    <mapref href="../topics/html-customization.ditamap"/>
+  </topicref>
+  <topicref keyref="pdf-customization">
+    <mapref href="../topics/pdf-customization.ditamap"/>
+  </topicref>
 </map>

resources/common-toc.ditamap

@@ -16,12 +16,6 @@
   <topicref keyref="parameters">
     <mapref href="../parameters/parameters.ditamap"/>
   </topicref>
-  <topicref keyref="html-customization" collection-type="family">
-    <mapref href="../topics/html-customization.ditamap"/>
-  </topicref>
-  <topicref keyref="pdf-customization">
-    <mapref href="../topics/pdf-customization.ditamap"/>
-  </topicref>
   <topicref keyref="extending">
     <mapref href="../topics/using-plugins.ditamap"/>
   </topicref>

topics/pdf-customization.dita

@@ -7,7 +7,8 @@
     <navtitle>Customizing PDF</navtitle>
   </titlealts>
   <shortdesc>You can <ph id="shortdesc-ph">adjust various aspects of PDF output by changing parameter settings or using
-      a theme file</ph>. For more complex customizations, you can create custom DITA-OT plug-ins.</shortdesc>
+      a theme file</ph>. For more complex customizations, you can create or install 
+    <xref keyref="extending">custom plug-ins</xref>.</shortdesc>
   <prolog>
     <metadata>
       <keywords>

userguide-book.ditamap

@@ -28,12 +28,6 @@
   <part keyref="parameters">
     <chapter href="parameters/parameters.ditamap" format="ditamap"/>
   </part>
-  <part keyref="html-customization">
-    <chapter href="topics/html-customization.ditamap" format="ditamap"/>
-  </part>
-  <part keyref="pdf-customization">
-    <chapter href="topics/pdf-customization.ditamap" format="ditamap"/>
-  </part>
   <part keyref="extending">
     <chapter href="topics/using-plugins.ditamap" format="ditamap"/>
   </part>