dita-ot-docs/topics/globalization-support.dita at develop · DeltaXML/dita-ot-docs · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->
<concept id="globalization-support">
  <title>Globalization support</title>
  <titlealts>
    <navtitle>Globalization support</navtitle>
  </titlealts>
  <shortdesc>DITA Open Toolkit supports globalization with generated text strings, index sorting, and bi-directional
    text.</shortdesc>
  <prolog>
    <metadata>
      <keywords>
        <indexterm><xmlatt>dir</xmlatt></indexterm>
        <indexterm><xmlatt>index:lang</xmlatt></indexterm>
        <indexterm>languages
          <indexterm>index sorting</indexterm></indexterm>
        <indexterm>languages
          <indexterm>right-to-left</indexterm></indexterm>
        <indexterm>languages
          <indexterm>bi-directional</indexterm></indexterm>
        <indexterm>English</indexterm>
        <indexterm>strings</indexterm>
        <indexterm>index
          <indexterm>sorting</indexterm></indexterm>
        <indexterm>bi-directional languages</indexterm>
        <indexterm>generated text</indexterm>
        <indexterm>CSS
          <indexterm>bi-directional languages</indexterm>
          <indexterm>right-to-left languages</indexterm></indexterm>
      </keywords>
    </metadata>
  </prolog>
  <conbody>
    <p>
      <dl>
        <dlentry>
          <dt>Generated text</dt>
          <dd><term>Generated text</term> is text that is rendered automatically in the output that is generated by
            DITA-OT; this text is not located in the DITA source files. The following are examples of generated text:
            <ul>
              <li>The word <cite>“Chapter”</cite> in a PDF file.</li>
              <li>The phrases <cite>“Related concepts”</cite>, <cite>“Related tasks”</cite>, and <cite>“Related
                  reference”</cite> in HTML output.</li>
            </ul></dd>
        </dlentry>
        <dlentry>
          <dt>Index sorting</dt>
          <dd>DITA-OT can use only a single language to sort indexes.<draft-comment
              author="Kristen James Eberlein"
              time="2012-08-11"
            >What does the ICU for Java provide? Does index sorting occur if ICU for Java is NOT
              installed?</draft-comment></dd>
        </dlentry>
        <dlentry>
          <dt>Bi-directional text</dt>
          <dd>DITA-OT contains style sheets (CSS files) that support both left-to-right (LTR) and right-to-left (RTL)
            languages in HTML-based transformations. PDF supports both LTR and RTL rendering based on the document
            language. The <xmlatt>dir</xmlatt> attribute can be used to override the default rendering direction.</dd>
        </dlentry>
      </dl>When DITA-OT generates output, it takes the first value that it encounters for the <xmlatt>xml:lang</xmlatt>
      attribute, and uses that value to create generated text, sort index entries, and determine which default CSS file
      is used. If no value for the <xmlatt>xml:lang</xmlatt> attribute is found, the toolkit defaults to U.S. English.
      You can use the
      <xref keyref="configuration-properties"/> to change the default language.</p>
  </conbody>
</concept>