Skip to content

Commit

Permalink
Update site for 4.2.2 (#813)
Browse files Browse the repository at this point in the history 
Update DITA-OT 4.2.2 docs to `/4.2`.

Built from commits:
* dita-ot/docs@3cfb005 ()
* dita-ot/dita-ot (4.2.2)
* dita-ot/org.dita-ot.html (master)
  • Loading branch information
@infotexture
infotexture authored Mar 24, 2024
2 parents c136f2d + 02ea39b commit 34f6c6f
Show file tree
Hide file tree
Showing 22 changed files with 195 additions and 39 deletions.
2 changes: 1 addition & 1 deletion 4.2/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ <h1 class="title topictitle1" id="ariaid-title1">DITA Open Toolkit <span class="
the toolkit.</p>
<ul class="ul list-group mb-5">
<li class="li list-group-item list-group-item-action">See the
<a class="xref stretched-link" href="release-notes/index.html" title="DITA Open Toolkit 4.2.1 is a maintenance release that fixes issues reported in DITA-OT 4.2, which uses map-first pre-processing for HTML5 output and includes a new local configuration file, better CLI messages with support for overrides, a new version of the Lightweight DITA plug-in with enhancements to Markdown processing, and updates for the latest DITA 2.0 draft standard.">DITA Open Toolkit 4.2 Release Notes</a> for information on the changes in the current
<a class="xref stretched-link" href="release-notes/index.html" title="DITA Open Toolkit 4.2.2 is a maintenance release that fixes issues reported in DITA-OT 4.2, which uses map-first pre-processing for HTML5 output and includes a new local configuration file, better CLI messages with support for overrides, a new version of the Lightweight DITA plug-in with enhancements to Markdown processing, and updates for the latest DITA 2.0 draft standard.">DITA Open Toolkit 4.2 Release Notes</a> for information on the changes in the current
release.</li>
<li class="li list-group-item list-group-item-action">
<a class="xref stretched-link" href="topics/installing-client.html" title="The DITA-OT distribution package can be installed on Linux, macOS, and Windows. It contains everything that you need to run the toolkit except for Java.">Installing DITA Open Toolkit</a> shows how to install the toolkit and run a
Expand Down
2 changes: 1 addition & 1 deletion 4.2/reference/docs-dita-features.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ <h1 class="title topictitle1" id="ariaid-title1">DITA features in the documentat
<div class="p"><pre class="pre codeblock language-xml normalize-space"><code>&lt;keydef keys="maintenance-version"&gt;
&lt;topicmeta&gt;
&lt;keywords&gt;
&lt;keyword&gt;4.2.1&lt;/keyword&gt;
&lt;keyword&gt;4.2.2&lt;/keyword&gt;
&lt;/keywords&gt;
&lt;/topicmeta&gt;
&lt;/keydef&gt;</code></pre></div>
Expand Down
71 changes: 60 additions & 11 deletions 4.2/release-notes/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Generated from DITA source
layout: 'base'
title: 'DITA Open Toolkit 4.2 Release Notes'
description: 'DITA Open Toolkit 4.2.1 is a maintenance release that fixes issues
description: 'DITA Open Toolkit 4.2.2 is a maintenance release that fixes issues
reported in DITA-OT 4.2, which uses map-first pre-processing for HTML5 output and includes a new local configuration file,
better CLI messages with support for overrides, a new version of the Lightweight DITA plug-in with
enhancements to Markdown processing, and updates for the latest DITA 2.0 draft standard.'
Expand All @@ -15,7 +15,7 @@ <h1 class="title topictitle1" id="ariaid-title1">DITA Open Toolkit <span class="


<div class="abstract">
<p class="shortdesc">DITA Open Toolkit <span class="keyword">4.2.1</span> is a maintenance release that fixes issues
<p class="shortdesc">DITA Open Toolkit <span class="keyword">4.2.2</span> is a maintenance release that fixes issues
reported in DITA-OT <span class="keyword">4.2</span>, which <span class="ph">uses map-first pre-processing for HTML5 output and includes a new local configuration file,
better CLI messages with support for overrides, a new version of the Lightweight DITA plug-in with
enhancements to Markdown processing, and updates for the latest DITA 2.0 draft standard</span>.</p>
Expand All @@ -24,7 +24,7 @@ <h1 class="title topictitle1" id="ariaid-title1">DITA Open Toolkit <span class="
<var class="keyword varname">major</var> versions may include incompatible API changes, <var class="keyword varname">minor</var> versions add
functionality in a backwards-compatible manner and <var class="keyword varname">patch</var> versions are maintenance releases
that include backwards-compatible bug fixes.</p>
<div class="note tip note_tip"><span class="note__title">Tip:</span> <div class="note__body"><span class="ph">Download the <span class="ph filepath">dita-ot-<span class="keyword">4.2.1</span>.zip</span>
<div class="note tip note_tip"><span class="note__title">Tip:</span> <div class="note__body"><span class="ph">Download the <span class="ph filepath">dita-ot-<span class="keyword">4.2.2</span>.zip</span>
package from the project website at
<a class="xref" href="https://www.dita-ot.org/download" target="_blank" rel="external noopener">dita-ot.org/download</a>.</span></div></div>
</div>
Expand Down Expand Up @@ -65,15 +65,64 @@ <h2 class="title topictitle2" id="ariaid-title2">Requirements: Java 17</h2>
</div>
</article>

<article class="topic reference nested1 mark" aria-labelledby="ariaid-title3" id="v4.2.1">
<h2 class="title topictitle2" id="ariaid-title3">DITA-OT <span class="keyword">4.2.1</span>
<article class="topic reference nested1 mark" aria-labelledby="ariaid-title3" id="v4.2.2">
<h2 class="title topictitle2" id="ariaid-title3">DITA-OT <span class="keyword">4.2.2</span>

</h2>
<div class="body refbody">
<section class="section" id="v4.2.1__bugs">
<p class="p">DITA Open Toolkit <span class="keyword">4.2.1</span> is a maintenance release that includes the
<section class="section" id="v4.2.2__bugs">
<p class="p">DITA Open Toolkit <span class="keyword">4.2.2</span> is a maintenance release that includes the
following bug fixes.</p>

<ul class="ul">
<li class="li" id="v4.2.2__4380">In earlier versions, the map-first pre-processing routine created extra HTML files in the output
folder when branch filtering topic references that include fragments. Duplicate branches are now handled
correctly and links are resolved as expected.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4380" target="_blank" rel="external noopener">#4380</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4427" target="_blank" rel="external noopener">#4427</a>
</li>
<li class="li" id="v4.2.2__4383">Earlier versions of map-first pre-processing would sometimes attempt to access topics that were
excluded in DITAVAL files, which resulted in spurious errors. XLST transformations and SAX filter pipes are
now skipped for any source files that don’t exist.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4383" target="_blank" rel="external noopener">#4383</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4435" target="_blank" rel="external noopener">#4435</a>
</li>
<li class="li" id="v4.2.2__4419">In earlier versions, passing a URL as an input file on the Windows command line resulted in an
<samp class="ph msgph">InvalidPathException</samp> error. URI input is now handled correctly on Windows.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4419" target="_blank" rel="external noopener">#4419</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4425" target="_blank" rel="external noopener">#4425</a>
</li>
<li class="li" id="v4.2.2__4430">In debug logging mode, DITA-OT 4.2 no longer passed exceptions to the CLI output. Logging has
been corrected to ensure that errors from Ant tasks once again include the stack trace as expected.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4430" target="_blank" rel="external noopener">#4430</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4436" target="_blank" rel="external noopener">#4436</a>
</li>
<li class="li" id="v4.2.2__4431">When missing translations for the PDF <cite class="cite">“on page”</cite> variable were added in DITA-OT 4.2,
the Montenegrin translation <cite class="cite">“na stranici”</cite> was accidentally copied to the Swedish language file.
The Swedish translation has been updated to use <cite class="cite">“på sidan”</cite> as expected.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4431" target="_blank" rel="external noopener">#4431</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4433" target="_blank" rel="external noopener">#4433</a>
</li>
<li class="li" id="v4.2.2__4412">When project files contained input map names with URI-escaped characters like spaces, earlier
versions of DITA-OT used the escape character sequences like <code class="ph codeph">%20</code> in the output file name.
The map-first pre-processing routine has been updated to construct the output base file name using the
unescaped equivalents.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4412" target="_blank" rel="external noopener">#4412</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/pull/4440" target="_blank" rel="external noopener">#4440</a>
</li>
</ul>
</section>
</div>
</article>

<article class="topic reference nested1" aria-labelledby="ariaid-title4" id="v4.2.1">
<h2 class="title topictitle2" id="ariaid-title4">DITA-OT 4.2.1
<span class="ph small text-muted"> released March 1, 2024</span>
</h2>
<div class="body refbody">
<section class="section" id="v4.2.1__bugs">
<p class="p">DITA Open Toolkit 4.2.1 is a maintenance release that includes the following bug fixes.</p>

<ul class="ul">
<li class="li" id="v4.2.1__4401">When using the in-memory store, earlier versions of the map-first pre-processing pipeline failed
to initialize the temporary directory. The directory is now created to ensure that files are processed
Expand Down Expand Up @@ -108,8 +157,8 @@ <h2 class="title topictitle2" id="ariaid-title3">DITA-OT <span class="keyword">4
</div>
</article>

<article class="topic reference nested1" aria-labelledby="ariaid-title4" id="v4.2">
<h2 class="title topictitle2" id="ariaid-title4">DITA-OT <span class="keyword">4.2</span>
<article class="topic reference nested1" aria-labelledby="ariaid-title5" id="v4.2">
<h2 class="title topictitle2" id="ariaid-title5">DITA-OT <span class="keyword">4.2</span>
<span class="ph small text-muted"> released February 11, 2024</span>
</h2>

Expand Down Expand Up @@ -323,7 +372,7 @@ <h2 class="title topictitle2" id="ariaid-title4">DITA-OT <span class="keyword">4
<p class="p">(For details on recent changes, see the
<a class="xref" href="https://xmlgraphics.apache.org/fop/2.9/releaseNotes_2.9.html" target="_blank" rel="external noopener">Apache FOP 2.9 Release Notes</a>.)</p>
</li>
<li class="li" id="v4.2__4346">The logback libraries have been updated to <span class="ph">1.4.14</span> to
<li class="li" id="v4.2__4346">The logback libraries have been updated to <span class="ph">1.4.14</span> to
resolve a serialization vulnerability in the logback receiver component reported as <a class="xref" href="https://nvd.nist.gov/vuln/detail/CVE-2023-6378" target="_blank" rel="external noopener">CVE-2023-6378</a>.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4346" target="_blank" rel="external noopener">#4346</a>
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4361" target="_blank" rel="external noopener">#4361</a>
Expand Down Expand Up @@ -386,7 +435,7 @@ <h2 class="title topictitle2" id="ariaid-title4">DITA-OT <span class="keyword">4
<code class="ph codeph">usr.input.file.list</code> with temporary file names. The list is now generated correctly.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4311" target="_blank" rel="external noopener">#4311</a>
</li>
<li class="li" id="v4.2__4315">Missing translations for the <cite class="cite">“on page”</cite> variable have been added to the Bosnian,
<li class="li" id="v4.2__4315">Missing translations for the PDF <cite class="cite">“on page”</cite> variable have been added to the Bosnian,
Finnish, Montenegrin, Romanian, Russian, Swedish, and Simplified Chinese PDF localizations.
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4315" target="_blank" rel="external noopener">#4315</a>,
<a class="xref" href="https://github.com/dita-ot/dita-ot/issues/4320" target="_blank" rel="external noopener">#4320</a>
Expand Down
2 changes: 1 addition & 1 deletion 4.2/toc.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
<meta charset="UTF-8">
<meta name="copyright" content="(C) Copyright 2024">
<meta name="generator" content="DITA-OT">
<meta name="keywords" content="4.2, 4.2.1, January 22, 2024, January 26, 2024, 1.10.14, 1.10, 2.8.0, 32.1.1-jre, 74.2, 2.16.1, 17, 1.4.14, 5.7, 2.0.12, 2.12.2, 2.9, 1.4.01, 1.2, 5.2.3, Saxon-HE, 12.4, 0.3.2">
<title>DITA Open Toolkit 4.2</title>
<link rel="stylesheet" type="text/css" href="commonltr.css">
</head>
Expand Down Expand Up @@ -329,6 +328,7 @@ <h1 class="title topictitle1">DITA Open Toolkit <span class="keyword">4.2</span>
</li>
<li class="topicref"><a href="topics/dita-and-dita-ot-resources.html">Resources</a><ul>
<li class="topicref"><a href="topics/dita-ot-day-videos.html">DITA-OT Day Videos</a><ul>
<li class="topicref"><a href="topics/dita-ot-day-videos-intro-2024.html">2024 Helsinki</a></li>
<li class="topicref"><a href="topics/dita-ot-day-videos-intro-2022.html">2022 Rotterdam</a></li>
<li class="topicref"><a href="topics/dita-ot-day-videos-intro-2019.html">2019 Brussels</a></li>
<li class="topicref"><a href="topics/dita-ot-day-videos-intro-2018.html">2018 Rotterdam</a></li>
Expand Down
10 changes: 5 additions & 5 deletions 4.2/topics/creating-docker-images.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ <h1 class="title topictitle1" id="ariaid-title1">Installing plug-ins in a Docker
<span class="ph filepath">FROM</span> directive.</span>
<div class="itemgroup stepxmp">
<pre class="pre codeblock language-dockerfile normalize-space show-whitespace"><code># Use the latest DITA-OT image ↓ as parent:
FROM ghcr.io/dita-ot/dita-ot:4.2.1</code></pre>
FROM ghcr.io/dita-ot/dita-ot:4.2.2</code></pre>
</div>
</li><li class="li step stepexpand"><strong>Optional: </strong>
<span class="ph cmd">You can extend your image with a <code class="ph codeph">RUN</code> declaration that runs the <span class="keyword cmdname">dita</span>
Expand All @@ -48,7 +48,7 @@ <h1 class="title topictitle1" id="ariaid-title1">Installing plug-ins in a Docker
<figure class="fig fignone"><figcaption><span class="fig--title-label">Figure 1. </span>Sample Dockerfile with custom plug-ins: <span class="ph filepath"><var class="keyword varname">dita-ot-dir</var>/docsrc/samples</span><span class="ph filepath">/docker/Dockerfile</span></figcaption>

<pre class="pre codeblock language-dockerfile normalize-space show-line-numbers show-whitespace"><code># Use the latest DITA-OT image ↓ as parent:
FROM ghcr.io/dita-ot/dita-ot:4.2.1
FROM ghcr.io/dita-ot/dita-ot:4.2.2

# Install a custom plug-in from a remote location:
RUN dita --install https://github.com/infotexture/dita-bootstrap/archive/master.zip
Expand All @@ -66,9 +66,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Installing plug-ins in a Docker
=&gt; =&gt; transferring dockerfile: 367B 0.0s
=&gt; [internal] load .dockerignore 0.0s
=&gt; =&gt; transferring context: 2B 0.0s
=&gt; [internal] load metadata for ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.1</span>
=&gt; [1/3] FROM ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.1</span>@sha256:<var class="keyword varname">&lt;hash&gt;</var>
=&gt; =&gt; resolve ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.1</span>@sha256:<var class="keyword varname">&lt;hash&gt;</var>
=&gt; [internal] load metadata for ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.2</span>
=&gt; [1/3] FROM ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.2</span>@sha256:<var class="keyword varname">&lt;hash&gt;</var>
=&gt; =&gt; resolve ghcr.io/dita-ot/dita-ot:<span class="keyword">4.2.2</span>@sha256:<var class="keyword varname">&lt;hash&gt;</var>
Step 2/3 : RUN dita --install https://github.com/infotexture/dita-bootstrap/archive/master.zip
---&gt; Running in d510f874cae0
Added net.infotexture.dita-bootstrap
Expand Down
2 changes: 1 addition & 1 deletion 4.2/topics/determining-version-of-ditaot.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ <h1 class="title topictitle1" id="ariaid-title1">Checking the DITA-OT version nu
</li></ol></section>
<section class="section result"><div class="tasklabel"><h2 class="sectiontitle tasklabel">Results</h2></div>
<p class="p">The DITA-OT version number appears on the console:</p>
<pre class="pre codeblock"><code><samp class="ph systemoutput sysout">DITA-OT version <span class="keyword">4.2.1</span></samp></code></pre>
<pre class="pre codeblock"><code><samp class="ph systemoutput sysout">DITA-OT version <span class="keyword">4.2.2</span></samp></code></pre>
</section>
</div>
</article></main>
Loading

0 comments on commit 34f6c6f

Please sign in to comment.