<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN"
"http://docs.oasis-open.org/dita/dtd/topic.dtd">
<topic id="readme">
  <title>About "<filepath>demo/dita-sample.ditamap</filepath>"</title>

  <prolog>
    <critdates>
      <revised modified="2017-06-22"/>

      <revised modified="2019-02-01"/>
    </critdates>
  </prolog>

  <body>
    <p>The goal of <filepath>demo/dita/dita-sample.ditamap</filepath> is very
    modest: allow the curious person to see how DITA <image
    href="data:image/svg+xml;base64, "
    scale="25"/> topics and maps looks styled by <xref format="html"
    href="http://www.xmlmind.com/xmleditor/" scope="external">XMLmind XML
    Editor (<ph status="changed"><b>XXE</b></ph> for short)</xref>. This
    document is by no mean a DITA tutorial.</p>

    <note id="remember" type="remember"><p>If you use <ph
    status="changed"><b>XXE</b></ph> to author DITA documents, you can:</p><ul>
        <li>Use not only PNG, JPEG and GIF images to illustrate your
        documents, but also any image format supported by an <i>image toolkit
        plug-in</i>.<indexterm>Scalable Vector
        Graphics<index-see>SVG</index-see><index-see>Batik</index-see></indexterm><indexterm>SVG</indexterm><indexterm>image</indexterm><indexterm>fig</indexterm><fig
            frame="all" id="tux">
            <title>The <xmlelement>image</xmlelement> element contained in
            this <xmlelement>fig</xmlelement> element points to an SVG file.
            (Requires the add-on called "<cite>Batik image toolkit
            plug-in</cite>".)</title>

            <image align="center" href="../../graphics/tux.svg" width="400"/>
          </fig><fig frame="all" id="Barbe_Noire">
            <title>The <xmlelement>image</xmlelement> element contained in
            this <xmlelement>fig</xmlelement> element points to a WebP file.
            (Requires the add-on called "<cite>WebP Support</cite>".)</title>

            <image align="center" href="../../graphics/Barbe_Noire.webp"
                   scale="33"/>
          </fig></li>

        <li otherprops="math=yes">Embed <xref format="html"
        href="http://www.w3.org/TR/MathML2/"
        scope="external"><term>MathML</term></xref> equations in your topics
        and, using the <uicontrol>MathML</uicontrol> tool, to edit these
        equations without really having to learn
        MathML.<indexterm>mml:math<index-sort-as>math</index-sort-as></indexterm><indexterm>foreign</indexterm><indexterm>fig</indexterm><equation-figure>
            <title>This <xmlelement>equation-figure</xmlelement> element
            contains a <xmlelement>mathml</xmlelement> element itself
            containing a <xmlelement>m:math</xmlelement> element. (Requires
            the add-on called "<i>MathML support</i>" in order to be able to
            edit the equations and also the add-on called "<i>JEuclid image
            toolkit plug-in</i>" to convert the equations to SVG or
            PNG.)</title>

            <mathml status="changed">
              <m:math display="block"
                      xmlns:m="http://www.w3.org/1998/Math/MathML">
                <m:mrow>
                  <m:mo>{</m:mo>

                  <m:mtable>
                    <m:mtr>
                      <m:mtd>
                        <m:mrow>
                          <m:mrow>
                            <m:maligngroup/>

                            <m:mo>∇×</m:mo>

                            <m:mi mathvariant="bold">E</m:mi>
                          </m:mrow>

                          <m:maligngroup/>

                          <m:mo>=</m:mo>

                          <m:mrow>
                            <m:maligngroup/>

                            <m:mo>-</m:mo>

                            <m:mstyle mathsize="100%">
                              <m:mfrac>
                                <m:mrow>
                                  <m:mo>∂</m:mo>

                                  <m:mo>⁡</m:mo>

                                  <m:mi mathvariant="bold">B</m:mi>
                                </m:mrow>

                                <m:mrow>
                                  <m:mo>∂</m:mo>

                                  <m:mo>⁡</m:mo>

                                  <m:mi>t</m:mi>
                                </m:mrow>
                              </m:mfrac>
                            </m:mstyle>
                          </m:mrow>
                        </m:mrow>
                      </m:mtd>
                    </m:mtr>

                    <m:mtr>
                      <m:mtd>
                        <m:mrow>
                          <m:mrow>
                            <m:maligngroup/>

                            <m:mo>∇×</m:mo>

                            <m:mi mathvariant="bold">B</m:mi>
                          </m:mrow>

                          <m:maligngroup/>

                          <m:mo>=</m:mo>

                          <m:mrow>
                            <m:mrow>
                              <m:maligngroup/>

                              <m:msub>
                                <m:mi>μ</m:mi>

                                <m:mn>0</m:mn>
                              </m:msub>

                              <m:mo>⁢</m:mo>

                              <m:mi mathvariant="bold">J</m:mi>
                            </m:mrow>

                            <m:mo>+</m:mo>

                            <m:mrow>
                              <m:msub>
                                <m:mi>μ</m:mi>

                                <m:mn>0</m:mn>
                              </m:msub>

                              <m:mo>⁢</m:mo>

                              <m:msub>
                                <m:mi>ε</m:mi>

                                <m:mn>0</m:mn>
                              </m:msub>

                              <m:mo>⁢</m:mo>

                              <m:mstyle mathsize="100%">
                                <m:mfrac>
                                  <m:mrow>
                                    <m:mo>∂</m:mo>

                                    <m:mo>⁡</m:mo>

                                    <m:mi mathvariant="bold">E</m:mi>
                                  </m:mrow>

                                  <m:mrow>
                                    <m:mo>∂</m:mo>

                                    <m:mo>⁡</m:mo>

                                    <m:mi>t</m:mi>
                                  </m:mrow>
                                </m:mfrac>
                              </m:mstyle>
                            </m:mrow>
                          </m:mrow>
                        </m:mrow>
                      </m:mtd>
                    </m:mtr>
                  </m:mtable>
                </m:mrow>
              </m:math>
            </mathml>
          </equation-figure></li>

        <li status="new">Embed TeX/LaTeX math in your topics by inserting a
        <xmlelement>foreign</xmlelement> element<indexterm>foreign</indexterm>
        having attribute
        <xmlatt>outputclass</xmlatt><codeph>="embed-latex"</codeph> in an
        <xmlelement>equation-inline</xmlelement>,
        <xmlelement>equation-block</xmlelement> or
        <xmlelement>equation-figure</xmlelement> element.<equation-figure>
            <title>This <xmlelement>equation-figure</xmlelement> element
            contains a
            <codeph>&lt;foreign outputclass="embed-latex"&gt;</codeph> element
            itself containing TeX/LaTeX math. (Requires the add-on called
            "<i>JLaTeXMath image toolkit plug-in</i>" in order to be able to
            preview the equations and convert the equations to SVG or
            PNG.)</title>

            <foreign outputclass="embed-latex">\begin{matrix}
f: &amp; ]1,+\infty[ &amp; \rightarrow &amp; \mathbb{R} \\ 
   &amp; x           &amp; \mapsto     &amp; \dfrac{\sqrt{x-1}}{\sqrt{x-1}+1}
\end{matrix} </foreign>
          </equation-figure></li>
      </ul><p>Of course, converting DITA documents making use of the above
    features to formats such as HTML, PDF, <ph status="deleted">RTF</ph>, <ph
    status="new">DOCX</ph>, etc, works fine. You may need to install the
    following add-ons:</p><ul compact="yes">
        <li>The add-on called "<i>XSL-FO processor plug-in</i>". Note that due
        to add-on dependencies, installing this add-on will automatically
        install the add-on called "<i>Batik image toolkit
        plug-in</i>".<indexterm>Batik<index-sort-as>batik</index-sort-as></indexterm></li>

        <li>The add-on called "<i>MathML support</i>".</li>

        <li>The add-on called "<i>JEuclid image toolkit plug-in</i>".</li>

        <li>The add-on called "<i>JLaTeXMath image toolkit plug-in</i>".</li>
      </ul><p>Installing add-ons consists in selecting menu item <menucascade>
        <uicontrol>Options</uicontrol>

        <uicontrol>Install Add-ons</uicontrol>
      </menucascade>, selecting the desired add-ons, clicking
    <uicontrol>OK</uicontrol> and then restarting <ph
    status="changed"><b>XXE</b></ph> as instructed by the
    application.</p></note>
  </body>
</topic>
