force use of pandoc version >= 3.1.12.2

The `bin/pandoc-wrapper.sh` tool will verify that the ssytem
has a recent enough version of `pandoc(1)`.

We explain why we insist on `pandoc(1)`. version >= 3.1.12.2
in comments where the $PANDOC_MIN_VERSION is set.

Added `--wrap=preserve` as a default argument to `pandoc(1)`.
While this change will impact every HTML file generated,
we believe this will improve the ability of someone to look
at the generated HTML and correlate with the original markdown.

Changed `bin/pandoc-wrapper.sh` VERSION from "1.4.2 2024-03-17"
to "1.4.3 2024-03-18".

Performed `make www` to achieve all of the above and to generate
HTML using the new  `--wrap=preserve` `pandoc(1)` mode.
This commit is contained in:
Landon Curt Noll committed 2024-03-18 01:26:39 -07:00
1 parent 9eb7a54e9f
commit b0b212acb1
402 files changed
+37061 -55132

No files matched your search

+75 -111
View File
@@ -129,9 +129,9 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Anonymous_2004">Anonymous
2004</a><br> Location: <a href="../../location.html#SG">SG</a> -
<em>Republic of Singapore</em> (<em>Singapore</em>) <br><br></li>
<li>Name: <a href="../../authors.html#Anonymous_2004">Anonymous 2004</a><br>
Location: <a href="../../location.html#SG">SG</a> - <em>Republic of Singapore</em> (<em>Singapore</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -143,157 +143,121 @@
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span></span></code></pre></div>
<h2 id="to-use">To use:</h2>
<div class="sourceCode" id="cb2"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./anonymous</span> <span class="st">&#39;foo&#39;</span> <span class="op">&gt;</span> bar.pgm</span></code></pre></div>
<p>Now open the output using your favourite <a
href="https://en.wikipedia.org/wiki/Netpbm#PGM_example">pgm</a> viewer.
If you don’t have a <code>pgm</code> viewer then we suggest the <a
href="https://netpbm.sourceforge.net">netpbm toolkit</a> to convert the
image to a graphics format that you can view. Most graphical web
browsers can display PNG or JPEG images.</p>
<p>Now open the output using your favourite
<a href="https://en.wikipedia.org/wiki/Netpbm#PGM_example">pgm</a> viewer. If you don’t
have a <code>pgm</code> viewer then we suggest the <a href="https://netpbm.sourceforge.net">netpbm
toolkit</a> to convert the image to a graphics
format that you can view. Most graphical web browsers can display PNG or JPEG
images.</p>
<h2 id="try">Try:</h2>
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./try.sh</span></span></code></pre></div>
<p>NOTE: technically the text is supposed to be in all lower case but
the script does use some upper case letters for demonstration
purposes.</p>
<p>NOTE: technically the text is supposed to be in all lower case but the script
does use some upper case letters for demonstration purposes.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>Did you know that in the first edition of The Hobbit Gollum was
willing to give up the ring? It was not the Ruling Ring, the One Ring,
the Ring of Power or anything like that: it was simply a literary device
that could make one invisible. When Bilbo won the famous riddle game
Gollum went to fetch the Ring - not to kill and eat Bilbo but to give it
to him! But Bilbo had already found it just like in the later editions.
Gollum profusely apologised and begged for forgiveness. Bilbo told him
never mind because he would have had it anyway. But he’d let him off on
one condition: that he show him the way out. It was at this point that
Bilbo slipped the ring on and Gollum saw him vanish and understood that
he already found it. But there was no call of thief and no hatred of
Bilbo.</p>
<p>If you want to read the first edition they reprinted it some years
back: <code>The Hobbit Facsimile First Edition</code>. The details are
also discussed in History of Middle-earth [HoMe] VI, <a
href="https://tolkiengateway.net/wiki/The_Return_of_the_Shadow">The
Return of the Shadow</a>, part one of the history of The Lord of the
Rings of a twelve volume set - as well as in <a
href="https://tolkiengateway.net/wiki/The_History_of_The_Hobbit">The
History of the Hobbit</a>.</p>
<p>Did you know that in the first edition of The Hobbit Gollum was willing to give
up the ring? It was not the Ruling Ring, the One Ring, the Ring of Power or
anything like that: it was simply a literary device that could make one
invisible. When Bilbo won the famous riddle game Gollum went to fetch the Ring -
not to kill and eat Bilbo but to give it to him! But Bilbo had already found it
just like in the later editions. Gollum profusely apologised and begged for
forgiveness. Bilbo told him never mind because he would have had it anyway. But
he’d let him off on one condition: that he show him the way out. It was at this
point that Bilbo slipped the ring on and Gollum saw him vanish and understood
that he already found it. But there was no call of thief and no hatred of Bilbo.</p>
<p>If you want to read the first edition they reprinted it some years back: <code>The Hobbit Facsimile First Edition</code>. The details are also discussed in History of
Middle-earth [HoMe] VI, <a href="https://tolkiengateway.net/wiki/The_Return_of_the_Shadow">The Return of the
Shadow</a>, part one of
the history of The Lord of the Rings of a twelve volume set - as well as in <a href="https://tolkiengateway.net/wiki/The_History_of_The_Hobbit">The
History of the
Hobbit</a>.</p>
<p>p.s. Frodo lives!</p>
<h3 id="an-important-aside--">An important aside :-)</h3>
<p>BTW: if you haven’t read <a
href="https://en.wikipedia.org/wiki/The_Lord_of_the_Rings">The Lord of
the Rings</a> what are you waiting for? :-) You’ll find out the source
of the text above though you’ll see that there are some circumflexes
missing! That’s okay though due to I/O of the entry and in earlier
drafts sometimes the û had no diacritic but H after the <code>u</code>
in it. The real text is:</p>
<p>BTW: if you haven’t read <a href="https://en.wikipedia.org/wiki/The_Lord_of_the_Rings">The Lord of the
Rings</a> what are you waiting for? :-)
You’ll find out the source of the text above though you’ll see that there are
some circumflexes missing! That’s okay though due to I/O of the entry and in
earlier drafts sometimes the û had no diacritic but H after the <code>u</code> in
it. The real text is:</p>
<blockquote>
<p>Ash nazg durbatulûk, ash nazg gimbatul, ash nazg thrakatulûk, agh
burzum-ishi krimpatul.</p>
</blockquote>
<p>which when translated from <a
href="https://www.glyphweb.com/arda/b/blackspeech.html">Black Speech</a>
means:</p>
<p>which when translated from <a href="https://www.glyphweb.com/arda/b/blackspeech.html">Black
Speech</a> means:</p>
<blockquote>
<p><a href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a>
to rule them all, <a
href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a> to find
them,<br />
<a href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a> to
bring them all and in the darkness bind them.</p>
<p><a href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a> to rule them all, <a href="https://www.glyphweb.com/arda/o/onering.html">One
Ring</a> to find them,<br />
<a href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a> to bring them all and in the darkness bind them.</p>
</blockquote>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>This program takes a single command line argument, transcribes the
argument text into Tolkien’s Elvish letters, and writes the
transcription to standard output as a <a
href="https://en.wikipedia.org/wiki/Netpbm#PGM_example">portable
transcription to standard output as a <a href="https://en.wikipedia.org/wiki/Netpbm#PGM_example">portable
graymap</a> (PGM) file.</p>
<p>The specific transcription mode is the <a
href="https://www.glyphweb.com/arda/b/blackspeech.html">Black Speech</a>
(<a href="https://www.glyphweb.com/arda/t/tengwar.html">Tengwar
mode</a>), as used in the inscription on the <a
href="https://www.glyphweb.com/arda/o/onering.html">One Ring</a>. The
program handles the following digraphs:</p>
<p>The specific transcription mode is the <a href="https://www.glyphweb.com/arda/b/blackspeech.html">Black
Speech</a> (<a href="https://www.glyphweb.com/arda/t/tengwar.html">Tengwar
mode</a>), as
used in the inscription on the <a href="https://www.glyphweb.com/arda/o/onering.html">One
Ring</a>. The program handles the
following digraphs:</p>
<ul>
<li><code>gh</code>, <code>sh</code>, <code>th</code>: the corresponding
<a href="https://www.glyphweb.com/arda/t/tengwar.html">tengwar</a> are
output for these specific sounds.</li>
<li><code>mh</code> denotes the full <a
href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a> for
<code>[m]</code>; <code>m</code> by itself means a horizontal bar above
the next letter.</li>
<li><code>rh</code> denotes the <code>[r]</code> <a
href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a>.</li>
<li><code>uh</code> denotes the <a
href="https://www.glyphweb.com/arda/t/tehtar.php">tehta</a> for long
<a href="https://www.glyphweb.com/arda/t/tengwar.html">tengwar</a> are output for these
specific sounds.</li>
<li><code>mh</code> denotes the full <a href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a>
for <code>[m]</code>; <code>m</code> by itself means a horizontal bar above the next letter.</li>
<li><code>rh</code> denotes the <code>[r]</code> <a href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a>.</li>
<li><code>uh</code> denotes the <a href="https://www.glyphweb.com/arda/t/tehtar.php">tehta</a> for long
vowel <code>[u:]</code>.</li>
<li><code>zh</code> selects the up-reaching <a
href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a> for
<code>[z]</code>, while <code>z</code> selects the down-reaching
one.</li>
<li><code>zh</code> selects the up-reaching
<a href="https://www.glyphweb.com/arda/t/tengwar.html">tengwa</a> for <code>[z]</code>, while <code>z</code>
selects the down-reaching one.</li>
</ul>
<p>Punctuation marks other than commas and periods are ignored, as are
whitespace characters. In addition, the argument text must be entirely
in lower case.</p>
<p>The following command thus writes a rendering of the <a
href="https://www.glyphweb.com/arda/r/ringinscription.html">Ring
inscription</a> to the file <code>ring.pgm</code>:</p>
<p>The following command thus writes a rendering of the <a href="https://www.glyphweb.com/arda/r/ringinscription.html">Ring
inscription</a> to
the file <code>ring.pgm</code>:</p>
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./anonymous</span> <span class="st">&quot;ash nazg durhbatuluhk, ash nazg gimbatul, </span><span class="dt">\</span></span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="st"> ash nazg thrakatuluhk, agh burzhumh-ishi krimpatul.&quot;</span> <span class="op">&gt;</span>ring.pgm</span></code></pre></div>
<p>The source code assumes the ASCII character set; also, due to space
constraints, the program uses rather inefficient algorithms, so it may
waste a lot of time and space even when rendering moderately long
strings.</p>
<p>The code contains a vector font which was derived by toying with <a
href="https://alboin.fi">Harri Perälä</a>’s <a
href="https://alboin.fi/tengwar.htm">Tengwar Cursive font</a>.
Currently, only the glyphs used in the <a
href="https://www.glyphweb.com/arda/r/ringinscription.html">Ring
inscription</a> are included in the font.</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0
License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights
Reserved. You are free to share and adapt this file under the terms of
this license:</p>
<p>The code contains a vector font which was derived by toying with <a href="https://alboin.fi">Harri
Perälä</a>’s <a href="https://alboin.fi/tengwar.htm">Tengwar Cursive
font</a>. Currently, only the glyphs used in the
<a href="https://www.glyphweb.com/arda/r/ringinscription.html">Ring inscription</a> are
included in the font.</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0 License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:</p>
<pre><code>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</code></pre>
<p>For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/</p>
<p>For more information, see: https://creativecommons.org/licenses/by-sa/4.0/</p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content for HTML phase 22 by: bin/output-index-inventory.sh via bin/md2html.sh -->
<!-- START: this line starts content generated by: bin/output-index-inventory.sh -->
<h1 id="inventory-for-2004anonymous"><a name="inventory"></a>Inventory
for 2004/anonymous</h1>
<h1 id="inventory-for-2004anonymous"><a name="inventory"></a>Inventory for 2004/anonymous</h1>
<p><a href="#top">Jump to top</a></p>
<h2 id="primary-files">Primary files</h2>
<ul>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/anonymous.c">anonymous.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/anonymous.orig.c">anonymous.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/try.sh">try.sh</a>
- how to run</li>
<li><a href="2004_anonymous.tar.bz2">2004_anonymous.tar.bz2</a> -
download entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/anonymous.c">anonymous.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/anonymous.orig.c">anonymous.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/try.sh">try.sh</a> - how to run</li>
<li><a href="2004_anonymous.tar.bz2">2004_anonymous.tar.bz2</a> - download entry source</li>
</ul>
<h2 id="secondary-files">Secondary files</h2>
<ul>
<li><a href="index.html">index.html</a> - entry home page</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/.gitignore">.gitignore</a>
- list of files that should not be committed under git</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/.gitignore">.gitignore</a> - list of files that should not be committed under git</li>
<li><a href=".path">.path</a> - directory path from top directory</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/anonymous/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->