Halaman utama Jelajahi Bantuan
Masuk
bn
/
se
2
0
Fork 0
Berkas Masalah 0 Permintaan Tarik 0 Wiki
Pohon: a4b429aad5
Ranting Tag
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.3.3
/
doc
/
topics
/
lwdita-input.html

lwdita-input.html 9.6 KB
Riwayat Mentahan

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2019"><meta name="DC.rights.owner" content="(C) Copyright 2019"><meta name="DC.type" content="topic"><meta name="description" content="DITA-OT provides preview support for the authoring formats proposed for Lightweight DITA, or “LwDITA”. The XDITA, MDITA and HDITA formats are alternative representations of DITA content in XML, Markdown and HTML5."><meta name="DC.subject" content=", topicref, format, authoring formats, Lightweight DITA, metadata, DITA 1.3"><meta name="keywords" content=", topicref, format, authoring formats, Lightweight DITA, metadata, DITA 1.3"><meta name="DC.relation" scheme="URI" content="../topics/alternative-input-formats.html"><meta name="DC.relation" scheme="URI" content="../topics/markdown-input.html"><meta name="DC.relation" scheme="URI" content="../topics/markdown-dita-syntax-reference.html"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="lwdita-input"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Preview support for Lightweight DITA</title></head><body id="lwdita-input"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/alternative-input-formats.html">Authoring formats</a><ul><li><a href="../topics/markdown-input.html">Markdown content</a></li><li class="active"><a href="../topics/lwdita-input.html">Lightweight DITA</a></li><li><a href="../topics/markdown-dita-syntax-reference.html">Markdown DITA syntax</a></li></ul></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../parameters/index.html">Setting parameters</a></li><li><a href="../topics/customizing.html">Customizing DITA-OT</a></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Preview support for Lightweight DITA</h1>
    8. 

  8.   
    9. 

  9.   
    10. 

  10.   
    11. 

  11. 

  12.   <div class="body"><p class="shortdesc">DITA-OT provides preview support for the authoring formats proposed for
    13. 

  13.     <a class="xref" href="http://docs.oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.pdf" target="_blank">Lightweight DITA</a>, or “<dfn class="term">LwDITA</dfn>”. The XDITA, MDITA and HDITA formats are alternative
    14. 

  14.     representations of DITA content in XML, Markdown and HTML5.</p>
    15. 

  15.     <div class="note attention note_attention"><span class="note__title">Attention:</span> Since
    16. 

  16.       <a class="xref" href="http://docs.oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.pdf" target="_blank">Lightweight DITA</a> has not yet been released as a formal specification, the implementation for XDITA, MDITA
    17. 

  17.       and HDITA authoring formats is subject to change. Future versions of DITA Open Toolkit will be updated as LwDITA
    18. 

  18.       evolves.</div>
    19. 

  19.     <section class="section"><h2 class="title sectiontitle">XDITA</h2>
    20. 

  20.       
    21. 

  21.       <p class="p">XDITA is the LwDITA authoring format that uses XML to structure information. XDITA is a subset of DITA, with
    22. 

  22.         new multimedia element types added to support interoperability with HTML5. XDITA is designed for users who want
    23. 

  23.         to write DITA content but who do not want (or need) the full power of DITA.</p>
    24. 

  24.       <p class="p">The XDITA parser included in the <code class="ph codeph">org.lwdita</code> plug-in provides preliminary support for XDITA
    25. 

  25.         maps and XDITA topics.</p>
    26. 

  26.       <p class="p">To apply XDITA-specific processing to topics in an XDITA map or a full DITA 1.3 map, set the
    27. 

  27.           <code class="keyword markupname xmlatt">@format</code> attribute on a <code class="keyword markupname xmlelement">&lt;topicref&gt;</code> to <code class="ph codeph">xdita</code>:</p>
    28. 

  28.       <div class="p">
    29. 

  29.         <pre class="pre codeblock language-xml normalize-space show-line-numbers show-whitespace"><code>&lt;map&gt;
    30. 

  30.   &lt;topicref href="xdita-topic.xml" <strong class="ph b">format="xdita"</strong>/&gt;
    31. 

  31. &lt;/map&gt;</code></pre>
    32. 

  32.       </div>
    33. 

  33.       <div class="note tip note_tip"><span class="note__title">Tip:</span> For examples of cross-format content sharing between topics in XDITA, HDITA, extended-profile
    34. 

  34.         MDITA, and DITA 1.3, see the LwDITA sample files in the DITA-OT installation directory under
    35. 

  35.           <span class="ph filepath">plugins/org.oasis-open.xdita.v0_2_2/samples</span>.</div>
    36. 

  36.     </section>
    37. 

  37.     <section class="section"><h2 class="title sectiontitle">MDITA</h2>
    38. 

  38.       
    39. 

  39.       <p class="p">MDITA is the LwDITA authoring format based on Markdown. It is designed for users who want to write structured
    40. 

  40.         content with the minimum of overhead, but who also want to take advantage of the reuse mechanisms associated
    41. 

  41.         with the DITA standard and the multi-channel publishing afforded by standard DITA tooling.</p>
    42. 

  42.       <p class="p">Recent proposals for LwDITA include two profiles for authoring MDITA topics:</p>
    43. 

  43.       <ul class="ul">
    44. 

  44.         <li class="li">The “<dfn class="term">Core profile</dfn>” is based on
    45. 

  45.           <a class="xref" href="https://github.github.com/gfm/" target="_blank">GitHub-Flavored Markdown</a> and includes elements that are common to many other Markdown implementations.</li>
    46. 

  46.         <li class="li">The “<dfn class="term">Extended profile</dfn>” borrows additional features from other flavors of Markdown to represent
    47. 

  47.           a broader range of DITA content with existing plain-text syntax conventions.</li>
    48. 

  48.       </ul>
    49. 

  49.       <p class="p">The Markdown DITA parser included in the <code class="ph codeph">org.lwdita</code> plug-in provides preliminary support for
    50. 

  50.         these profiles and additional Markdown constructs as described in the syntax reference.</p>
    51. 

  51.       <p class="p">To apply LwDITA-specific processing to Markdown topics, set the <code class="keyword markupname xmlatt">@format</code> attribute to
    52. 

  52.           <code class="ph codeph">mdita</code>:</p>
    53. 

  53.       <div class="p">
    54. 

  54.         <pre class="pre codeblock language-xml normalize-space show-line-numbers show-whitespace"><code>&lt;map&gt;
    55. 

  55.   &lt;topicref href="mdita-topic.md" <strong class="ph b">format="mdita"</strong>/&gt;
    56. 

  56. &lt;/map&gt;</code></pre>
    57. 

  57.       </div>
    58. 

  58.       <p class="p">In this case, the first paragraph in the topic will be treated as a short description, for example, and
    59. 

  59.         additional metadata can be specified for the topic via a YAML front matter block.</p>
    60. 

  60.       <div class="note note note_note"><span class="note__title">Note:</span> Setting the <code class="keyword markupname xmlatt">@format</code> attribute to <code class="ph codeph">mdita</code> triggers stricter parsing than the
    61. 

  61.         more lenient document parsing approach that is applied to <code class="ph codeph">markdown</code> documents.</div>
    62. 

  62.       <div class="note attention note_attention"><span class="note__title">Attention:</span> The MDITA map format is not yet supported. To include Markdown content in publications, use
    63. 

  63.         an XDITA map or a DITA 1.3 map.</div>
    64. 

  64.     </section>
    65. 

  65. 

  66.     <section class="section"><h2 class="title sectiontitle">HDITA</h2>
    67. 

  67.       
    68. 

  68.       <p class="p">HDITA is the LwDITA authoring format based on HTML5, which is intended to support structured content authoring
    69. 

  69.         with tools designed for HTML authoring. HDITA also uses custom data attributes to provide interoperability with
    70. 

  70.         DITA.</p>
    71. 

  71.       <p class="p">The HDITA parser included in the <code class="ph codeph">org.lwdita</code> plug-in provides preliminary support for these
    72. 

  72.         constructs.</p>
    73. 

  73.       <p class="p">To apply LwDITA-specific processing to HTML topics, set the <code class="keyword markupname xmlatt">@format</code> attribute to
    74. 

  74.           <code class="ph codeph">hdita</code>:</p>
    75. 

  75.       <div class="p">
    76. 

  76.         <pre class="pre codeblock language-xml normalize-space show-line-numbers show-whitespace"><code>&lt;map&gt;
    77. 

  77.   &lt;topicref href="hdita-topic.html" <strong class="ph b">format="hdita"</strong>/&gt;
    78. 

  78. &lt;/map&gt;</code></pre>
    79. 

  79.       </div>
    80. 

  80.       <div class="note attention note_attention"><span class="note__title">Attention:</span> The HDITA map format is not yet supported. To include HDITA content, use an XDITA map or a
    81. 

  81.         DITA 1.3 map.</div>
    82. 

  82.     </section>
    83. 

  83.   </div>
    84. 

  84. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/alternative-input-formats.html" title="DITA-OT³ supports several alternative input formats in addition to standard DITA XML, including Markdown and the proposed XDITA, MDITA and HDITA authoring formats currently in development for Lightweight DITA.">Alternative authoring formats</a></div></div><div class="linklist relinfo"><strong>Related information</strong><br><ul class="linklist"><li class="linklist"><a class="link" href="../topics/markdown-input.html" title="Markdown is a lightweight markup language that allows you to write using an easy-to-read plain text format and convert to structurally valid markup as necessary.">Markdown content</a></li><li class="linklist"><a class="link" href="../topics/markdown-dita-syntax-reference.html" title="Markdown DITA uses CommonMark as the underlying markup language.">Markdown DITA syntax reference</a></li></ul></div></nav></article></main></body></html>
    85.