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

+58 -91
View File
@@ -130,8 +130,8 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Don_Yang">Don Yang</a><br>
Location: <a href="../../location.html#US">US</a> - <em>United States of
America</em> (<em>United States</em>) <br><br></li>
Location: <a href="../../location.html#US">US</a> - <em>United States of America</em> (<em>United States</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -146,38 +146,29 @@ America</em> (<em>United States</em>) <br><br></li>
<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>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p><code>Akari</code> is an image downsampling utility that accepts 3
input formats:</p>
<p><code>Akari</code> is an image downsampling utility that accepts 3 input formats:</p>
<ul>
<li><p><a href="https://netpbm.sourceforge.net/doc/pgm.html">PGM</a> (<a
href="https://netpbm.sourceforge.net/doc/">netpbm</a> <a
href="https://en.wikipedia.org/wiki/Grayscale">greyscale image</a>.
<code>Akari</code> only accepts <code>PGM</code> files with the header:
<code>P5 &lt;width&gt; &lt;height&gt; 255</code>. Images with extra
comments <em>such as the ones produced by <a
href="https://www.gimp.org">GIMP</a> will <strong>not be parsed
<li><p><a href="https://netpbm.sourceforge.net/doc/pgm.html">PGM</a>
(<a href="https://netpbm.sourceforge.net/doc/">netpbm</a> <a href="https://en.wikipedia.org/wiki/Grayscale">greyscale
image</a>. <code>Akari</code> only accepts <code>PGM</code>
files with the header: <code>P5 &lt;width&gt; &lt;height&gt; 255</code>. Images with extra comments
<em>such as the ones produced by <a href="https://www.gimp.org">GIMP</a> will <strong>not be parsed
properly</strong></em>.</p></li>
<li><p><a href="https://netpbm.sourceforge.net/doc/ppm.html">PPM</a>
(netpbm RGB image). Only <code>PPM</code> files with the header
<code>P6 &lt;width&gt; &lt;height&gt; 255</code> are accepted.</p></li>
<li><p><a href="https://en.wikipedia.org/wiki/ASCII_art">ASCII art</a>
(with <a href="https://en.wikipedia.org/wiki/Newline">end of lines</a>
in LF bytes only, <em><strong>not</strong> CR-LF</em>!)</p></li>
<li><p><a href="https://netpbm.sourceforge.net/doc/ppm.html">PPM</a> (netpbm RGB image). Only
<code>PPM</code> files with the header <code>P6 &lt;width&gt; &lt;height&gt; 255</code> are accepted.</p></li>
<li><p><a href="https://en.wikipedia.org/wiki/ASCII_art">ASCII art</a> (with <a href="https://en.wikipedia.org/wiki/Newline">end of
lines</a> in LF bytes only, <em><strong>not</strong> CR-LF</em>!)</p></li>
</ul>
<p>Anything that is not parsable as <code>PGM</code> or <code>PPM</code>
will be downsampled as ASCII art.</p>
<p>Anything that is not parsable as <code>PGM</code> or <code>PPM</code> will be downsampled as ASCII art.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p><code>Akari</code> is an image downsampling utility. She accepts up
to 3 arguments:</p>
<p>The first argument is the input image. If it’s <code>-</code> or
unspecified, <code>Akari</code> will read from <code>stdin</code>.</p>
<p>The second argument is the output image. If it’s <code>-</code> or
unspecified, <code>Akari</code> will write to <code>stdout</code>.</p>
<p>The third argument, if specified, causes <code>Akari</code> to keep
even pixels on even <a
href="https://en.wikipedia.org/wiki/Scan_line">scanlines</a>. By default
<code>Akari</code> will keep odd pixels on odd <a
href="https://en.wikipedia.org/wiki/Scan_line">scanlines</a>.</p>
<p><code>Akari</code> is an image downsampling utility. She accepts up to 3 arguments:</p>
<p>The first argument is the input image. If it’s <code>-</code> or unspecified, <code>Akari</code>
will read from <code>stdin</code>.</p>
<p>The second argument is the output image. If it’s <code>-</code> or unspecified,
<code>Akari</code> will write to <code>stdout</code>.</p>
<p>The third argument, if specified, causes <code>Akari</code> to keep even pixels on even
<a href="https://en.wikipedia.org/wiki/Scan_line">scanlines</a>. By default <code>Akari</code> will
keep odd pixels on odd <a href="https://en.wikipedia.org/wiki/Scan_line">scanlines</a>.</p>
<h3 id="examples">Examples:</h3>
<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="fu">gcc</span> akari.c <span class="at">-o</span> akari</span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari</span> <span class="op">&lt;</span> example.ppm <span class="op">&gt;</span> odd_output.ppm</span>
@@ -185,97 +176,73 @@ href="https://en.wikipedia.org/wiki/Scan_line">scanlines</a>.</p>
<span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari</span> example.ppm odd_output.ppm</span></code></pre></div>
<p><code>Akari</code> accepts 3 input formats:</p>
<ul>
<li><a href="https://netpbm.sourceforge.net/doc/pgm.html">PGM</a> (<a
href="https://netpbm.sourceforge.net/doc/">netpbm</a> <a
href="https://en.wikipedia.org/wiki/Grayscale">greyscale image</a>.
<code>Akari</code> only accepts <code>PGM</code> files with the header:
<code>P5 &lt;width&gt; &lt;height&gt; 255</code>. Images with extra
comments such as the ones produced by <a
href="https://www.gimp.org">GIMP</a> will not be parsed properly. <a
href="https://netpbm.sourceforge.net/doc/ppm.html">PPM</a> (netpbm RGB
image). Only <code>PPM</code> files with the header
<code>P6 &lt;width&gt; &lt;height&gt; 255</code> are accepted.</li>
<li><a href="https://netpbm.sourceforge.net/doc/pgm.html">PGM</a>
(<a href="https://netpbm.sourceforge.net/doc/">netpbm</a> <a href="https://en.wikipedia.org/wiki/Grayscale">greyscale
image</a>. <code>Akari</code> only accepts <code>PGM</code>
files with the header: <code>P5 &lt;width&gt; &lt;height&gt; 255</code>. Images with extra comments
such as the ones produced by <a href="https://www.gimp.org">GIMP</a> will not be parsed
properly.
<a href="https://netpbm.sourceforge.net/doc/ppm.html">PPM</a> (netpbm RGB image). Only
<code>PPM</code> files with the header <code>P6 &lt;width&gt; &lt;height&gt; 255</code> are accepted.</li>
<li>ASCII art (with end of lines in LF bytes only, not CR-LF)</li>
</ul>
<p>This is useful for decoding some curiously interlaced images, such as
the included <a href="example.ppm">example.ppm</a>.</p>
<p>Anything that is not parsable as <code>PGM</code> or <code>PPM</code>
will be downsampled as ASCII art. Since the source code is formatted as
ASCII art, it’s only natural to try:</p>
<p>Anything that is not parsable as <code>PGM</code> or <code>PPM</code> will be downsampled as
ASCII art. Since the source code is formatted as ASCII art, it’s only
natural to try:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari</span> akari.c akari2.c</span></code></pre></div>
<p><code>akari2.c</code> is also a valid C program, and accepts up to 1
argument. By default, this second program reads text from
<code>stdin</code> and writes expanded output to <code>stdout</code>. If
the extra argument is specified, the output text will also pass through
a rot13 filter.</p>
<p><code>akari2.c</code> is also a valid C program, and accepts up to 1 argument.
By default, this second program reads text from <code>stdin</code> and writes
expanded output to <code>stdout</code>. If the extra argument is specified, the
output text will also pass through a rot13 filter.</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="fu">gcc</span> akari2.c <span class="at">-o</span> akari2</span>
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari2</span> <span class="op">&lt;</span> input.txt <span class="op">&gt;</span> expanded_output.txt</span>
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari2</span> rot13 <span class="op">&lt;</span> input.txt <span class="op">&gt;</span> expanded_and_rot13_output.txt</span></code></pre></div>
<p>You can combine the two programs together to have just a regular
rot13 filter:</p>
<p>You can combine the two programs together to have just a regular rot13
filter:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari2</span> rot13 <span class="op">&lt;</span> input.txt <span class="kw">|</span> <span class="ex">./akari</span> <span class="op">&gt;</span> rot13.txt</span></code></pre></div>
<p>Of course, we wouldn’t stop with just 2 programs, you can downsample
the source <em>again</em> and get yet another C program:</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari</span> <span class="op">&lt;</span> akari.c <span class="kw">|</span> <span class="ex">./akari</span> <span class="op">&gt;</span> akari3.c</span></code></pre></div>
<p>We must go deeper:</p>
<div class="sourceCode" id="cb9"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./akari</span> <span class="op">&lt;</span> akari.c <span class="kw">|</span> <span class="ex">./akari</span> <span class="kw">|</span> <span class="ex">./akari</span> <span class="op">&gt;</span> akari4.c</span></code></pre></div>
<p><code>akari3.c</code> and <code>akari4.c</code> are still (mostly
valid) C programs. <code>gcc -Wall</code> will output a few warnings,
but still produce output executables. The output executables each print
a message to <code>stdout</code>.</p>
<p>It takes quite a bit of skill and obfuscation to interleave a C
program 4 levels deep, it’s much easier to interleave something like a
<code>brainf#$%</code> program in a C program, for example. For
comparison, a <code>brainf#$%</code> program is embedded inside <a
href="akari.c">akari.c</a>.</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><code>akari3.c</code> and <code>akari4.c</code> are still (mostly valid) C programs.
<code>gcc -Wall</code> will output a few warnings, but still produce output
executables. The output executables each print a message to <code>stdout</code>.</p>
<p>It takes quite a bit of skill and obfuscation to interleave a
C program 4 levels deep, it’s much easier to interleave something like
a <code>brainf#$%</code> program in a C program, for example. For comparison, a
<code>brainf#$%</code> program is embedded inside <a href="akari.c">akari.c</a>.</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-2011akari"><a name="inventory"></a>Inventory for
2011/akari</h1>
<h1 id="inventory-for-2011akari"><a name="inventory"></a>Inventory for 2011/akari</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/2011/akari/akari.c">akari.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/akari.orig.c">akari.orig.c</a>
- original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/akari.c">akari.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/akari.orig.c">akari.orig.c</a> - original source</li>
<li><a href="example.ppm">example.ppm</a> - input image</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/try.sh">try.sh</a>
- how to run</li>
<li><a href="2011_akari.tar.bz2">2011_akari.tar.bz2</a> - download entry
source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/try.sh">try.sh</a> - how to run</li>
<li><a href="2011_akari.tar.bz2">2011_akari.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/2011/akari/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/.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/2011/akari/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/.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/2011/akari/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/akari/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->