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:
1 parent
9eb7a54e9f
commit
b0b212acb1
402 files changed
+37061
-55132
No files matched your search
+62
-91
@@ -130,8 +130,8 @@
|
||||
<h2 id="author"><a name="author"></a>Author:</h2>
|
||||
<ul>
|
||||
<li>Name: <a href="../../authors.html#Andy_Sloane">Andy Sloane</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 -->
|
||||
@@ -141,136 +141,107 @@ America</em> (<em>United States</em>) <br><br></li>
|
||||
|
||||
<h2 id="to-build">To build:</h2>
|
||||
<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> alt</span></code></pre></div>
|
||||
<p>We recommend the alt version so that you can see what this looked
|
||||
like back in 2006. If you wish to see the original faster version see <a
|
||||
href="#original-code">original code</a> below.</p>
|
||||
<p>We recommend the alt version so that you can see what this looked like back in 2006.
|
||||
If you wish to see the original faster version see <a href="#original-code">original
|
||||
code</a> below.</p>
|
||||
<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">./slone.alt</span></span></code></pre></div>
|
||||
<h2 id="try">Try:</h2>
|
||||
<p>The alternate version, which we recommend that you use in order to
|
||||
see what is happening with modern systems, and to not flash too quickly,
|
||||
which can be problematic for some people, can be configured to different
|
||||
speeds by way of the value used in <code>usleep()</code>. The default is
|
||||
<code>75000</code> but you can easily change it. To do so try:</p>
|
||||
<p>The alternate version, which we recommend that you use in order to see what is
|
||||
happening with modern systems, and to not flash too quickly, which can be
|
||||
problematic for some people, can be configured to different speeds by way of the
|
||||
value used in <code>usleep()</code>. The default is <code>75000</code> but you can easily change
|
||||
it. To do so try:</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="fu">make</span> clobber SLEEP=70000 clobber alt</span>
|
||||
<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./sloane.alt</span></span></code></pre></div>
|
||||
<p>If you wish to make it like the original, as if the below <a
|
||||
href="#original-code">Original code</a> was being used, you can do:</p>
|
||||
<p>If you wish to make it like the original, as if the below <a href="#original-code">Original
|
||||
code</a> was being used, you can do:</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="fu">make</span> SLEEP=0 clobber alt</span>
|
||||
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./sloane.alt</span></span></code></pre></div>
|
||||
<h2 id="original-code">Original code:</h2>
|
||||
<p>Should you wish to see the original you may do so with the original
|
||||
code, <a href="sloane.c">sloane.c</a>.</p>
|
||||
<p>Should you wish to see the original you may do so with the original code,
|
||||
<a href="sloane.c">sloane.c</a>.</p>
|
||||
<h3 id="original-build">Original build:</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">make</span> clobber all</span></code></pre></div>
|
||||
<h3 id="original-use">Original use:</h3>
|
||||
<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">./sloane</span></span></code></pre></div>
|
||||
<p>WARNING: if you are easily overstimulated with fast movement or have
|
||||
photosensitivity please be careful running this version and instead see
|
||||
the above!</p>
|
||||
<p>NOTE: again as above, to see what is going on, we recommend that you
|
||||
instead use the alternate code which we described in the <a
|
||||
href="#to-build">To build</a> and <a href="#try">try</a> sections
|
||||
above.</p>
|
||||
photosensitivity please be careful running this version and instead see the
|
||||
above!</p>
|
||||
<p>NOTE: again as above, to see what is going on, we recommend that you instead use
|
||||
the alternate code which we described in the <a href="#to-build">To build</a> and
|
||||
<a href="#try">try</a> sections above.</p>
|
||||
<h2 id="judges-comments">Judges’ Comments:</h2>
|
||||
<p>Looks almost good enough to eat, dunnit? I suppose you could argue
|
||||
that, at first blush, this looks like a self-reproducing program.</p>
|
||||
<p>Looks almost good enough to eat, dunnit? I suppose you could argue that,
|
||||
at first blush, this looks like a self-reproducing program.</p>
|
||||
<h2 id="authors-remarks">Author’s remarks:</h2>
|
||||
<p>This program doesn’t require any special build options, other than
|
||||
that it uses <code>sin(3)</code> and <code>cos(3)</code> and hence
|
||||
requires the math library.</p>
|
||||
<p>You will almost certainly get a compiler warning because I declared a
|
||||
bunch of global <code>int</code>s without types. The code looks better
|
||||
this way, though, I think. There are also no <code>#include</code>s, so
|
||||
there may be warnings for undeclared references to
|
||||
<code>printf(3)</code>, etc. There’s a chance that my failure to include
|
||||
<code>math.h</code> or declare <code>sin(3)</code> or
|
||||
<code>cos(3)</code> will make the <a
|
||||
href="https://en.wikipedia.org/wiki/Doughnut">donut</a> not render
|
||||
<p>This program doesn’t require any special build options, other than that it
|
||||
uses <code>sin(3)</code> and <code>cos(3)</code> and hence requires the math library.</p>
|
||||
<p>You will almost certainly get a compiler warning because I declared a bunch
|
||||
of global <code>int</code>s without types. The code looks better this way, though, I
|
||||
think. There are also no <code>#include</code>s, so there may be warnings for
|
||||
undeclared references to <code>printf(3)</code>, etc. There’s a chance that my failure to
|
||||
include <code>math.h</code> or declare <code>sin(3)</code> or <code>cos(3)</code> will make the
|
||||
<a href="https://en.wikipedia.org/wiki/Doughnut">donut</a> not render
|
||||
properly – it’s worked on every system I’ve tried so far though.</p>
|
||||
<p>You will need some kind of VT100-ish emulation; so while this
|
||||
compiles and runs OK in Windows, you will need PuTTYcyg or something
|
||||
like that.</p>
|
||||
<p>You will need some kind of VT100-ish emulation; so while this compiles and
|
||||
runs OK in Windows, you will need PuTTYcyg or something like that.</p>
|
||||
<p>The shape of the source gives a hint about its output: it’s a little
|
||||
animation of a shaded donut rotating over an infinite checkerboard. Like
|
||||
many IOCCC entries, it is thus self-documenting.</p>
|
||||
<p>I wanted to create something as “pure” as I could - meaning that the
|
||||
entire source code is shaped into a work of art, without being prefixed
|
||||
by any <code>#define</code> hacks, or even <code>#includes</code>,
|
||||
<em>and</em> is portable enough to not require any special libraries to
|
||||
do the animating. I achieved this with two standard escape codes for
|
||||
clearing the screen and moving the cursor back to the top-left.</p>
|
||||
<p>I wanted to create something as “pure” as I could - meaning that the entire
|
||||
source code is shaped into a work of art, without being prefixed by any
|
||||
<code>#define</code> hacks, or even <code>#includes</code>, <em>and</em> is portable enough to not require
|
||||
any special libraries to do the animating. I achieved this with two standard
|
||||
escape codes for clearing the screen and moving the cursor back to the top-left.</p>
|
||||
<p>The donut isn’t raytraced. It’s much simpler than that.</p>
|
||||
<h3 id="how-is-it-obfuscated">How is it obfuscated?</h3>
|
||||
<p>There are three main pieces to this program: the donut, the
|
||||
checkerboard, and the ASCII logo. The first two are programmed in a
|
||||
straightforward way (with <a
|
||||
href="https://en.wikipedia.org/wiki/Z-buffering">z-buffering</a> even!),
|
||||
but the mathematics for drawing them is “optimized”. The ASCII logo has
|
||||
been shrunk into the smallest I could make it by any means
|
||||
necessary.</p>
|
||||
<p>There are three main pieces to this program: the donut, the checkerboard, and
|
||||
the ASCII logo. The first two are programmed in a straightforward way (with
|
||||
<a href="https://en.wikipedia.org/wiki/Z-buffering">z-buffering</a> even!), but the
|
||||
mathematics for drawing them is “optimized”. The ASCII logo has been shrunk
|
||||
into the smallest I could make it by any means necessary.</p>
|
||||
<p>The logo can actually be compressed much better (ironically, by doing
|
||||
something simpler), but I didn’t discover this until well after
|
||||
submitting.</p>
|
||||
something simpler), but I didn’t discover this until well after submitting.</p>
|
||||
<h3 id="puzzles">Puzzles</h3>
|
||||
<p>In increasing order of difficulty:</p>
|
||||
<ul>
|
||||
<li><p>Can you change the shading of the donut and
|
||||
checkerboard?</p></li>
|
||||
<li><p>Can you change the movement rates of the donut, the checkerboard,
|
||||
and the scrolling logo?</p></li>
|
||||
<li><p>Can you change the inner/outer radii of the donut? The
|
||||
height/scaling of the checkerboard?</p></li>
|
||||
<li><p>How is the “IOCCC 2006” logo encoded? Can you put something else
|
||||
in its place? Can you find a smaller encoding?</p></li>
|
||||
<li><p>Can you change the shading of the donut and checkerboard?</p></li>
|
||||
<li><p>Can you change the movement rates of the donut, the checkerboard, and
|
||||
the scrolling logo?</p></li>
|
||||
<li><p>Can you change the inner/outer radii of the donut? The height/scaling
|
||||
of the checkerboard?</p></li>
|
||||
<li><p>How is the “IOCCC 2006” logo encoded? Can you put something else in its
|
||||
place? Can you find a smaller encoding?</p></li>
|
||||
</ul>
|
||||
<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-2006sloane"><a name="inventory"></a>Inventory for
|
||||
2006/sloane</h1>
|
||||
<h1 id="inventory-for-2006sloane"><a name="inventory"></a>Inventory for 2006/sloane</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/2006/sloane/sloane.c">sloane.c</a>
|
||||
- entry source</li>
|
||||
<li><a
|
||||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/Makefile">Makefile</a>
|
||||
- entry Makefile</li>
|
||||
<li><a
|
||||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/sloane.alt.c">sloane.alt.c</a>
|
||||
- alternative source</li>
|
||||
<li><a
|
||||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/sloane.orig.c">sloane.orig.c</a>
|
||||
- original source</li>
|
||||
<li><a href="2006_sloane.tar.bz2">2006_sloane.tar.bz2</a> - download
|
||||
entry source</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/sloane.c">sloane.c</a> - entry source</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/Makefile">Makefile</a> - entry Makefile</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/sloane.alt.c">sloane.alt.c</a> - alternative source</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/sloane.orig.c">sloane.orig.c</a> - original source</li>
|
||||
<li><a href="2006_sloane.tar.bz2">2006_sloane.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/2006/sloane/.entry.json">.entry.json</a>
|
||||
- description of entry in JSON</li>
|
||||
<li><a
|
||||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/.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/2006/sloane/.entry.json">.entry.json</a> - description of entry in JSON</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/.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/2006/sloane/README.md">README.md</a>
|
||||
- markdown source for index.html</li>
|
||||
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2006/sloane/README.md">README.md</a> - markdown source for index.html</li>
|
||||
</ul>
|
||||
|
||||
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->
|
||||
|
||||
Reference in new issue
Block a user