diff --git a/index.dita b/index.dita index a0abf7339..8ed6cfee5 100644 --- a/index.dita +++ b/index.dita @@ -21,53 +21,37 @@
DITA-OT documentation -

The DITA Open Toolkit documentation provides information about installing, running, configuring and extending +

The DITA Open Toolkit documentation provides information about installing, running, configuring, and extending the toolkit.

diff --git a/parameters/index.dita b/parameters/index.dita index 6ae812ca3..2f79b4516 100644 --- a/parameters/index.dita +++ b/parameters/index.dita @@ -2,12 +2,12 @@ - DITA Open Toolkit parameters + Configuring DITA-OT - Parameters + Configuring - You can adjust DITA Open Toolkit behavior via dita command arguments and - options, DITA-OT parameter settings, and configuration properties. + You can adjust DITA Open Toolkit behavior via dita command arguments and + options, parameter settings, and configuration properties. diff --git a/parameters/parameters.ditamap b/parameters/parameters.ditamap index 01c9c9ab9..846dff179 100644 --- a/parameters/parameters.ditamap +++ b/parameters/parameters.ditamap @@ -2,7 +2,7 @@ - Parameter Reference + Configuration @@ -26,4 +26,10 @@ + + + + + + diff --git a/reference/markdown-formats.ditamap b/reference/markdown-formats.ditamap index 371b50861..a1c576fb7 100644 --- a/reference/markdown-formats.ditamap +++ b/reference/markdown-formats.ditamap @@ -18,12 +18,8 @@ Source and target - - Sourceonly: links to → - - - Targetonly - + + diff --git a/reference/reference.ditamap b/reference/reference.ditamap index 290981fcb..7e4dc6406 100644 --- a/reference/reference.ditamap +++ b/reference/reference.ditamap @@ -54,7 +54,16 @@ - + + + + + + + + + + diff --git a/resources/common-toc.ditamap b/resources/common-toc.ditamap index 0309a3f09..9a717bdfd 100644 --- a/resources/common-toc.ditamap +++ b/resources/common-toc.ditamap @@ -4,48 +4,27 @@ DITA Open Toolkit <keyword keyref="release"/> - - - + + - + - + - - - - - - - - - - - - - + - - - - - - - - diff --git a/resources/reltable.ditamap b/resources/reltable.ditamap index 803c420da..529301efd 100644 --- a/resources/reltable.ditamap +++ b/resources/reltable.ditamap @@ -351,7 +351,7 @@ - + diff --git a/resources/source-files.ditamap b/resources/source-files.ditamap index e82ad7b8d..d348362ca 100644 --- a/resources/source-files.ditamap +++ b/resources/source-files.ditamap @@ -8,12 +8,10 @@ - - @@ -56,6 +54,7 @@ + @@ -80,11 +79,11 @@ - + + - @@ -194,6 +193,7 @@ + diff --git a/topics/building-output.dita b/topics/building-output.dita deleted file mode 100644 index 404bf0776..000000000 --- a/topics/building-output.dita +++ /dev/null @@ -1,8 +0,0 @@ - - - - - Building output - You can use the dita command-line tool, Ant, or the Java API to transform DITA content - to the various output formats that DITA Open Toolkit supports. - diff --git a/topics/dita-ot-day-2014.ditamap b/topics/dita-ot-day-2014.ditamap index 8c6b1ba98..f74fc5386 100644 --- a/topics/dita-ot-day-2014.ditamap +++ b/topics/dita-ot-day-2014.ditamap @@ -119,7 +119,7 @@ - + diff --git a/topics/dita-ot-day-2015.ditamap b/topics/dita-ot-day-2015.ditamap index 52319cd79..7657352fa 100644 --- a/topics/dita-ot-day-2015.ditamap +++ b/topics/dita-ot-day-2015.ditamap @@ -107,7 +107,7 @@ - + diff --git a/topics/adding-plugins.dita b/topics/extending.dita similarity index 64% rename from topics/adding-plugins.dita rename to topics/extending.dita index 92efb6dc0..aa8b9e868 100644 --- a/topics/adding-plugins.dita +++ b/topics/extending.dita @@ -2,19 +2,20 @@ - Adding and removing plug-ins + Extending DITA-OT with plug-ins - Adding plug-ins + Extending - You can extend DITA-OT with additional plug-ins to change the default output types in various ways, add - entirely new kinds of output formats, or implement DITA specializations. A variety of open source plug-ins are - available from the plug-in registry at + You can extend DITA Open Toolkit with plug-ins that change the default transformations, add new output + formats, or implement DITA specializations. A variety of open source plug-ins are available from the plug-in + registry at . DITA specializations + extending plug-ins plug-ins working with diff --git a/topics/installing-client.dita b/topics/installing.dita similarity index 89% rename from topics/installing-client.dita rename to topics/installing.dita index 45a6ec86e..ff3020d9e 100644 --- a/topics/installing-client.dita +++ b/topics/installing.dita @@ -1,13 +1,13 @@ - + Installing DITA Open Toolkit - Installing DITA-OT + Installing - The DITA-OT distribution package can be installed on Linux, macOS, and Windows. It - contains everything that you need to run the toolkit except for Java. + The DITA-OT distribution package can be installed on Linux, macOS, and Windows. It contains everything that + you need to run the toolkit except for Java. diff --git a/topics/intro.ditamap b/topics/intro.ditamap new file mode 100644 index 000000000..c5f7f19ba --- /dev/null +++ b/topics/intro.ditamap @@ -0,0 +1,17 @@ + + + + + Intro topics + + + + + + + + + + + + diff --git a/topics/output-formats.dita b/topics/output-formats.dita index 2360b0c03..aca57d841 100644 --- a/topics/output-formats.dita +++ b/topics/output-formats.dita @@ -2,10 +2,7 @@ - DITA-OT transformations (output formats) - - Output formats - + Output formats DITA Open Toolkit ships with several core transformations that convert DITA content to different output formats. Additional formats are available from the plug-in registry at . @@ -22,6 +19,6 @@ For information on how to install other formats, see - . + . diff --git a/topics/pdf-customization.dita b/topics/pdf-customization.dita index b69b99582..fcd793106 100644 --- a/topics/pdf-customization.dita +++ b/topics/pdf-customization.dita @@ -7,7 +7,8 @@ Customizing PDF You can adjust various aspects of PDF output by changing parameter settings or using - a theme file. For more complex customizations, you can create custom DITA-OT plug-ins. + a theme file. For more complex customizations, you can create or install + custom plug-ins. diff --git a/topics/plugins-registry.dita b/topics/plugins-registry.dita index 0adeb6ff9..86be72b61 100644 --- a/topics/plugins-registry.dita +++ b/topics/plugins-registry.dita @@ -6,8 +6,9 @@ Plug-in registry - DITA-OT 3.2 supports a new plug-in registry that makes it easier to discover and - install new plug-ins. The registry provides a searchable list of plug-ins at + + DITA-OT supports a plug-in registry that makes it easier to discover and install new + plug-ins. The registry provides a searchable list of plug-ins at . diff --git a/topics/publishing.dita b/topics/publishing.dita new file mode 100644 index 000000000..868e56b61 --- /dev/null +++ b/topics/publishing.dita @@ -0,0 +1,11 @@ + + + + + Publishing DITA content + + Publishing + + You can use the dita command, Ant, or the Java API to publish DITA content to other + formats, or build output from a containerized environment such as Docker or GitHub Actions. + diff --git a/topics/troubleshooting-overview.dita b/topics/troubleshooting-overview.dita index 2bdc0b8fb..f90d72307 100644 --- a/topics/troubleshooting-overview.dita +++ b/topics/troubleshooting-overview.dita @@ -1,11 +1,10 @@ - + Error messages and troubleshooting Troubleshooting - This section contains information about problems that you might encounter and how to resolve - them. + This part contains information about problems that you might encounter and how to resolve them. diff --git a/topics/using-plugins.ditamap b/topics/using-plugins.ditamap index 8d614380b..c74458910 100644 --- a/topics/using-plugins.ditamap +++ b/topics/using-plugins.ditamap @@ -7,6 +7,9 @@ + + + diff --git a/userguide-book.ditamap b/userguide-book.ditamap index fbbc786ad..4a6405e0e 100644 --- a/userguide-book.ditamap +++ b/userguide-book.ditamap @@ -16,46 +16,27 @@ - + + + + - + - - - - - - - - - - - - - + - - - - - - - - - -