globalization-support.dita 3.2 KB

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