DITA oOTb

TD
by think DITA0 views·Updated Jan 30, 2019
Powered by AI

Need to present on this topic?

Create your own polished presentation in minutes. Just describe what you need.

Free to try, no credit card required

Slide outline

  1. Option 2:
  2. Option 3:
  3. Option 1:

Transcript

Where does the OT fit

into the DITA picture?

Example of properties file:

TechPubs process:

Ant build script template:

.property file

http://www.dita-ot.org/3.2/topics/using-dita-properties-file.html

...

Cannot set args.input and transtype!

ant builds

Copy a sample from DITA-OT3.x\docsrc\samples\properties locally or on a share, for example under /styles.

Ant is a Java tool, used to declare a sequence of build actions.

Copy a build template from:

--propertyfile=<file>

<dita-ot-3.2>\docsrc\samples\ant_sample

Run from OT directory:

bin\ant -f build-script target

--parameter=value | -Dparameter=value

command line

For example, to build output with <draft-comment> and <required-cleanup> content, or to control related links:

--args.draft=yes

--args.rellinks=none | nofamily | noparent | all

  • The GNU-style --parameter=value form is only available for parameters that are configured in the plug-in configuration file;
  • The Java-style -D form can also be used to specify additional non-configured parameters or set system properties.

dita-ot-dir/bin/dita --input=input-file --format=format [options]

http://www.dita-ot.org/3.2/parameters/dita-command-arguments.html

Using out-of-the-box

OT parameters

Example:

dita -i C:/Users/macoi/Documents/div/gitprojects/dita-users/clever-tank-en-one/clevertank-one.ditamap -o C:/Users/macoi/Documents/div/gitprojects/dita-users/clever-tank-en-one/out-OT-CL/clevertank-one-pdf --format=pdf

Publishing scenarios

Sample DITA project:

https://github.com/dita-users/demo-project

  • in XML Editor
  • in CCMS

Building output via:

  • command line
  • property files
  • Ant builds
  • (scenarios in Editor/ CCMS)

OT folder structure

Priority:

1. Any property passed to Ant from the command line with -Dproperty or --property=value

2. A custom property file passed with --propertyfile

3. A local.properties file in the root directory of the DITA-OT installation

4. The lib/org.dita.dost.platform/plugin.properties file

5. The configuration.properties file

If a given property is set in multiple places, the first value “wins” and subsequent entries for the same property are ignored.

This session does not cover:

  • installation of OT
  • customisation

OT parameters

  • input map and output dir
  • output type
  • output formatting
  • filtering
  • linking
  • labels
  • styling
  • scoping
  • ...

Output:

common

PDF

HTML-based

HTML5

XHTML

HTML Help

Eclipse Help

Other

Publishing oOTb

1

Option 2:

DITA-XML editor

2

Option 3:

CCMS

3

samples

4

ant.bat

dita.bat

5

command line

6

Option 1:

(open-source publishing engine

for DITA content)

stand-alone

7

properties file samples

8

ant build templates

9

DITA-XML editor