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

+57 -84
View File
@@ -129,9 +129,9 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Ilya_Kurdyukov">Ilya
Kurdyukov</a><br> Location: <a href="../../location.html#RU">RU</a> -
<em>Russian Federation</em> (<em>Russia</em>) <br><br></li>
<li>Name: <a href="../../authors.html#Ilya_Kurdyukov">Ilya Kurdyukov</a><br>
Location: <a href="../../location.html#RU">RU</a> - <em>Russian Federation</em> (<em>Russia</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -144,72 +144,70 @@ Kurdyukov</a><br> Location: <a href="../../location.html#RU">RU</a> -
<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">./prog</span> text_file output_length context_length random_seed</span></code></pre></div>
<h2 id="try">Try:</h2>
<p>When running this, ask yourself why it gets progressively slower when
the context length decreases:</p>
<p>When running this, ask yourself why it gets progressively slower when the
context length decreases:</p>
<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>
<blockquote>
<p>Performance depends on the number of same hashes found. Too many
identical strings if the context length is small. – Author</p>
<p>Performance depends on the number of same hashes found.
Too many identical strings if the context length is small.
– Author</p>
</blockquote>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>We were able to <a href="rand.c">write our own program</a> performing
the same trick using the (still non-standard, for some reason) library
function <code>memmem()</code>, but that way it works too fast
regardless of the context length, and it’s much less fun.</p>
<p>We were able to <a href="rand.c">write our own program</a> performing the same trick using
the (still non-standard, for some reason) library function <code>memmem()</code>, but that
way it works too fast regardless of the context length, and it’s much less fun.</p>
<p>The author wrote in reply:</p>
<hr />
<p>Wow, amazing! Very fast, but there is a drawback to randomness. If
some string only appears after half the input, the first instance of
this string will have a 50% chance of occurrence. Example:</p>
<p>Wow, amazing! Very fast, but there is a drawback to randomness.
If some string only appears after half the input, the first instance
of this string will have a 50% chance of occurrence.
Example:</p>
<pre><code>echo &quot;00000000000000000000 01 02 02 02 02 02 02&quot; &gt; test.txt
./prog test.txt 1000 2 123
# more twos in output
./rand test.txt 1000 2 123
# more ones in output</code></pre>
<blockquote>
<p>But this will happen very rarely on real data. – Author</p>
<p>But this will happen very rarely on real data.
– Author</p>
</blockquote>
<hr />
<p>Try using the same random seed and varying the context size.</p>
<p>BTW: what on Middle-earth is <code>lámatyávë</code>? It’s Quenya, one
of the languages of the Elves in Tolkien’s Legendarium. It means sound
taste (plural is lámatyáver) and it refers to phonaesthesia - in other
words, it refers to the pleasure of sound and form of words. It’s
discussed in <a
href="https://en.wikipedia.org/wiki/Morgoth%27s_Ring">Morgoth’s
Ring</a>, volume X of <a
href="https://en.wikipedia.org/wiki/The_History_of_Middle-earth">History
of Middle-earth (HoMe)</a>. Now can you appreciate the award title a bit
better?</p>
<p>BTW: what on Middle-earth is <code>lámatyávë</code>? It’s Quenya, one of the languages of
the Elves in Tolkien’s Legendarium. It means sound taste (plural is lámatyáver)
and it refers to phonaesthesia - in other words, it refers to the pleasure of
sound and form of words. It’s discussed in <a href="https://en.wikipedia.org/wiki/Morgoth%27s_Ring">Morgoth’s
Ring</a>, volume X of <a href="https://en.wikipedia.org/wiki/The_History_of_Middle-earth">History of
Middle-earth (HoMe)</a>.
Now can you appreciate the award title a bit better?</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<h3 id="building">Building:</h3>
<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="fu">cc</span> prog.c <span class="at">-o</span> prog</span></code></pre></div>
<h3 id="usage">Usage:</h3>
<p>This program generates random text from the provided dictionary using
a Markov chain, outputting to <code>stdout</code>.</p>
<p>This program generates random text from the provided dictionary using a Markov
chain, outputting to <code>stdout</code>.</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="ex">./prog</span> input.txt 2000 10 12345</span></code></pre></div>
<p>Parameters are:</p>
<ol type="1">
<li><p>dictionary filename Need at least the size of the book, the more
the better (1Mb); you can concatenate several books into one file. This
should be a text file (not <code>.doc</code>/<code>.pdf</code>). You can
feed it with books in <code>.fb2</code> format, metadata is filtered.
Whitespace characters are also filtered. For languages other than
English, it’s better to use ANSI encoding. You can use UTF, but you need
to increase the chain length (if one ANSI character is encoded as two
UTF bytes, then multiply chain length by two).</p></li>
<li><p>dictionary filename
Need at least the size of the book, the more the better (1Mb); you can
concatenate several books into one file. This should be a text file (not
<code>.doc</code>/<code>.pdf</code>). You can feed it with books in <code>.fb2</code> format, metadata is
filtered. Whitespace characters are also filtered. For languages other than
English, it’s better to use ANSI encoding. You can use UTF, but you need to
increase the chain length (if one ANSI character is encoded as two UTF bytes,
then multiply chain length by two).</p></li>
<li><p>bytes to generate (limited to 1Mb)</p></li>
<li><p>chain length Randomness and performance depend inversely on this
parameter and the size of the dictionary. If you feel that the bytes are
generated too slowly, then you need to increase the length of the chain.
This length means that any part of the output of this size in bytes
exists somewhere in the dictionary.</p></li>
<li><p>chain length
Randomness and performance depend inversely on this parameter and the size
of the dictionary. If you feel that the bytes are generated too slowly, then you
need to increase the length of the chain. This length means that any part of
the output of this size in bytes exists somewhere in the dictionary.</p></li>
<li><p>random seed</p></li>
</ol>
<h3 id="example">Example</h3>
<p>You can try this with the inputs provided with <a
href="../../2019/mills/index.html">2019/mills</a> from the IOCCC
entries.</p>
<p>You can try this with the inputs provided with
<a href="../../2019/mills/index.html">2019/mills</a> from the IOCCC entries.</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">$</span> ./prog Shakespeare.txt 2001 10 12345</span></code></pre></div>
<p>produces:</p>
<pre><code>r sons, wives for them, as the hope I had it. This is the way they be not too ra
@@ -237,62 +235,37 @@ ing brow to brow, ourselves, Still your own affections are devised, As blanks, b
enevolences, and I thank thee for it. KING HENRY VI: Master lieutenant comes. Ma
ster lieutenant comes. Master lieutenant, pray you,-- CORIOLANUS: What&#39;s that to
him? CHRISTOPHER: At Pembroke, Sir James Blunt, And Rice ap Thomas with a virtu</code></pre>
<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>
<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-2020kurdyukov4"><a name="inventory"></a>Inventory
for 2020/kurdyukov4</h1>
<h1 id="inventory-for-2020kurdyukov4"><a name="inventory"></a>Inventory for 2020/kurdyukov4</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/2020/kurdyukov4/prog.c">prog.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/prog.orig.c">prog.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Eugene_Onegin.txt">Eugene_Onegin.txt</a>
- Eugene Onegin poetry</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Shakespeare.txt">Shakespeare.txt</a>
- Shakespeare text</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/rand.c">rand.c</a>
- randomize a file</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/try.sh">try.sh</a>
- how to run</li>
<li><a href="2020_kurdyukov4.tar.bz2">2020_kurdyukov4.tar.bz2</a> -
download entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/prog.c">prog.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/prog.orig.c">prog.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Eugene_Onegin.txt">Eugene_Onegin.txt</a> - Eugene Onegin poetry</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/Shakespeare.txt">Shakespeare.txt</a> - Shakespeare text</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/rand.c">rand.c</a> - randomize a file</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/try.sh">try.sh</a> - how to run</li>
<li><a href="2020_kurdyukov4.tar.bz2">2020_kurdyukov4.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/2020/kurdyukov4/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/.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/2020/kurdyukov4/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/.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/2020/kurdyukov4/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/kurdyukov4/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->