mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

build index.html for all winners

Browse Source 
Updated manifest as per recent file changes.

Updated winner `.winner.json` to reflect the manifest changes.

Added [bin/all_run.sh](bin/all_run.sh) tool to run a command over
all winning entries.

These tools had slight improvements in the help usage message:

* bin/gen-author.sh VERSION="1.3.1 2024-01-16"
* bin/gen-inventory.sh VERSION="1.0.1 2024-01-16"
* bin/pandoc_wrapper.sh VERSION="1.3.1 2024-01-16"
* bin/subst.default.sh VERSION="1.1.1 2024-01-16"
* bin/subst.winner-index.sh VERSION="1.1.1 2024-01-16"

The `bin/readme2index.sh` tool was improved so that
if the `index.html` file exists and the tool forms
the exact same content, then the file `index.html`
file is NOT touched.

* bin/readme2index.sh VERSION="1.1 2024-01-16"

We used the following command to generate `index.html` files
for all winning entries:

```sh
bin/all_run.sh -v 3 bin/readme2index.sh
```

NOTE: We have not (yet) built HTML files above the winner directory
level (e.g., no year level nor top level HTML), nor have be built
non-index HTML files for winners.

NOTE: By default we are running `pandoc(1)` with:

```
--fail-if-warnings=true
```

This means that any problems with markdown to HTML
generates an error.  This is done to be sure that
the HTML conversion is clean.

We had to fix the following `README.md` files:

* `2000/rince/README.md`

The reference [^2] was never used.  We made a guess that [^2] applies
to the same spot as [^1].  Perhaps there is a better spot where
[^2] applies?

NOTE: For every reference, there MUST be some place where that
reference is used.

* 2012/vik/README.md

The string "$...$" is assumed to be a TeX encoded string.

NOTE: Every "$..$" needs to be backslashed as in "\$..\$".

* 2018/burton1/README.md

The reference [2] was duplicated.  We changed the
second [2] to [3].

NOTE: Every reference needs to have a unique number.

* 2020/carlini/README.md

The string "$...$" is assumed to be a TeX encoded string.

NOTE: Every "$..$" needs to be backslashed as in "\$..\$".

We also found 2 errors in the `author/author_handle.json` file set:

* author/Anonymous_2001.json

The `author/Anonymous_2001.json` file was missing.

* author/Jari_Arkko.json

The winner ID for `1989_jar.1` had a typo.
This commit is contained in:
Landon Curt Noll committed 2024-01-17 00:32:39 -08:00
1 parent 893cd915b6
commit c1466f5165
350 files changed
+95242 -4217
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2005/boutines/index.html
+313 -13
View File
@@ -1,4 +1,6 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- START: two lines up starts content from: inc/top.default.html -->
<!-- -->
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
@@ -6,27 +8,325 @@
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- -->
<!-- file: 2005/boutines/index.html created by: fake.gen_index.sh version: 1.0.5 2023-10-31 -->
<html lang="en">
<!-- END: this line ends content from: inc/top.default.html -->
<!-- -->
<!-- This file was formed by the tool: bin/readme2index.sh version: 1.1 2024-01-16 -->
<!-- -->
<!-- START: this line starts content from: inc/head.default.html -->
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>2005 boutines</title>
<meta name="description" content="IOCCC year: 2005 IOCCC winner: boutines winner index page">
<meta name="keywords" content="IOCCC,2005,boutines,winner index page">
<link rel="stylesheet" href="/temp-test-ioccc/ioccc.css">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>2005/boutines</title>
<meta name="description" content="2005 IOCCC winner boutines">
<meta name="keywords" content="IOCCC, 2005, IOCCC 2005, IOCCC winner, boutines">
</head>
<!-- END: this line ends content from: inc/head.default.html -->
<!-- START: this line starts content from: inc/body.default.html -->
<body>
<h1>2005 boutines</h1>
<!-- END: this line ends content from: inc/body.default.html -->
<!-- START: this line starts content from: inc/header.default.html -->
<p>XXX - fake content until readme2index is working - XXX</p>
<div class="header">
<img src="/temp-test-ioccc/png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
<h1>The International Obfuscated C Code Contest</h1>
<h2>2005/boutines</h2>
</div>
<hr style="width:50%;text-align:left;margin-left:0">
<!-- END: this line ends content from: inc/header.default.html -->
<!-- START: this line starts content from: inc/topnav.mid.html -->
<!-- Start Nu Html Checker -->
<p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2005%2Fboutines%2Findex.html">Nu Html check https://ioccc-src.github.io/temp-test-ioccc/2005/boutines/index.html</a></p>
<!-- End Nu Html Checker -->
<div class="topnav">
<a class="Left" href="../anon/index.html">&larr; anon</a>
<a class="Left" href="../index.html">&uarr; 2005 &uarr;</a>
<a class="Left" href="../chia/index.html">chia &rarr;</a>
<a class="Right" href="#inventory">Inventory</a>
</div>
<!-- END: this line ends content from: inc/topnav.mid.html -->
<!-- START: this line starts content from: inc/begin-row.default.html -->
<div class="row">
<!-- END: this line ends content from: inc/begin-row.default.html -->
<!-- START: this line starts content from: inc/begin-leftcolumn.default.html -->
<div class="leftcolumn">
<!-- END: this line ends content from: inc/begin-leftcolumn.default.html -->
<!-- START: this line starts content from: inc/sidenav.default.html -->
<div class="sidenav">
<a href="#content">Jump to contents</a>
</div>
<hr>
<div class="sidenav">
<a href="/temp-test-ioccc/index.html">IOCCC Home</a>
<a href="/temp-test-ioccc/years.html">Winning Entries</a>
<a href="/temp-test-ioccc/winners.html">People who have won</a>
</div>
<hr>
<div class="sidenav">
<a href="/temp-test-ioccc/news.html">IOCCC News</a>
<a href="/temp-test-ioccc/faq.html#submit">How to enter the IOCCC</a>
<a href="/temp-test-ioccc/faq.html">FAQ</a>
</div>
<hr>
<div class="sidenav">
<a href="/temp-test-ioccc/bugs.html">Bugs &amp; (mis)features</a>
<a href="/temp-test-ioccc/faq.html#fix_a_winner">Fixing IOCCC winners</a>
<a href="/temp-test-ioccc/faq.html#fix_web_site">Fixing the web site</a>
<a href="/temp-test-ioccc/faq.html#fix_author">Fixing winner info</a>
<a href="/temp-test-ioccc/thanks-for-help.html">Thanks for the help</a>
</div>
<hr>
<div class="sidenav">
<a href="/temp-test-ioccc/judges.html">The IOCCC Judges</a>
<a href="/temp-test-ioccc/contact.html">Contacting the IOCCC</a>
</div>
<hr>
<div class="sidenav">
<a href="#top">Jump to top</a>
</div>
<!-- END: this line ends content from: inc/sidenav.default.html -->
<!-- START: this line starts content from: inc/end-leftcolumn.default.html -->
</div>
<!-- END: this line ends content from: inc/end-leftcolumn.default.html -->
<!-- START: this line starts content from: inc/begin-rightcolumn.default.html -->
<div class="rightcolumn">
<!-- END: this line ends content from: inc/begin-rightcolumn.default.html -->
<!-- START: this line starts content from: inc/before-content.default.html -->
<a name="content"></a>
<!-- END: this line ends content from: inc/before-content.default.html -->
<!-- START: this line starts content generated by: bin/gen-author.sh -->
<p><a name="author"><strong>Author:</strong></a> <br><br>Name: <a
href="/temp-test-ioccc/winners.html#Francois_Boutines">Francois
Boutines</a><br> Location: <a
href="/temp-test-ioccc/location.html#FR">FR</a></p>
<!-- END: next line ends content generated by: bin/gen-author.sh -->
<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></span></code></pre></div>
<h2 id="to-use">To use:</h2>
<p>You will need an <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a> viewer.
Look here to find some <a
href="https://www.w3.org/Graphics/SVG/WG/wiki/Implementations">SVG
Viewer Implementations</a>.</p>
<p>The following will create an <code>SVG</code> file:</p>
<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">ruby</span> <span class="at">-e</span> <span class="st">&#39;20.times{puts &quot;#{rand} #{rand}&quot;}&#39;</span> <span class="kw">|</span> <span class="ex">./boutines</span> <span class="op">&gt;</span> test.svg</span></code></pre></div>
<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">./boutines</span> <span class="op">&lt;</span> input.txt <span class="op">&gt;</span> result.svg</span></code></pre></div>
<p>After running the above commands, use <a
href="https://imagemagick.org/index.php">ImageMagick</a>’s
<code>convert</code> tool to convert the images to a png file:</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">convert</span> test.svg test.png</span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a></span>
<span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a><span class="ex">convert</span> result.svg result.png</span></code></pre></div>
<p>and then open it with your preferred graphics viewer or editor.</p>
<p>If you have a program that opens <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a> files then
you could open the <code>test.svg</code> file directly. An example
program is <a href="https://inkscape.org">Inkscape</a>. See the <a
href="https://www.w3.org/Graphics/SVG/WG/wiki/Implementations">list</a>
cited above for others.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>Can you explain the author’s remark “[generated files] are not as
scalable as their name suggests”?</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p><em>In memory of my father Pierre Boutines-Vignard.</em></p>
<h3 id="walk-through">Walk-through</h3>
<p>My program works as follows:</p>
<h4 id="input">Input</h4>
<p>A list of 2D points in the <a
href="https://en.wikipedia.org/wiki/Unit_square">unit square</a>.</p>
<h4 id="output">Output</h4>
<p>A <a href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi
diagram</a> of the set as an <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a> stream.</p>
<p>This will possibly save a compressed SVG file and may be useful:</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">./boutines</span> <span class="kw">|</span> <span class="fu">gzip</span> <span class="op">&gt;</span> result.svg.gz</span></code></pre></div>
<p>Input consists of a list of floating points values separated by
whitespaces (ranging preferably in <code>[0,1]</code>). Alternating a
horizontal coordinate, a whitespace then the other coordinate (pointing
downwards in the resulting graph) and a newline will just go fine:</p>
<pre><code>0 0
0 1
1 0
1 1
.5 .5</code></pre>
<p>Strictly speaking, you have to provide a <strong>set</strong> of
points. If there are duplicates in the list, there is no guarantee on
the one to be shown (in addition their labels will overlap) in the
resulting colored <a
href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi
diagram</a>.</p>
<h3 id="caution">Caution</h3>
<p>This program might have been a lot shorter, but nearly impractical
even for medium sized datasets. On the other hand it could have been a
lot faster, but hard to qualify under the IOCCC size limit. So guess
what I did? A compromise favoring innermost obfuscation, sacrificing
sometimes speed and other tedious factors.</p>
<p>Therefore this entry is limited to</p>
<blockquote>
<figure>
<img src="eqn.png" alt="floor(-1)" />
<figcaption aria-hidden="true">floor(-1)</figcaption>
</figure>
</blockquote>
<p>points and won’t even be suitable for more than a few thousand;
although generated files did pass the <a
href="https://validator.w3.org/#validate_by_upload+with_options">W3C SVG
Validator</a>, and are highly compressible, they are not as scalable as
their name suggests… For serious applications about <a
href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi
diagrams</a>, see <a href="http://www.qhull.org/">Qhull</a>, <a
href="https://www.cgal.org">CGAL</a> and the like but you may still
encounter large output volumes (and have to handle some sort of clipping
in order to represent properly infinite regions of the diagram in <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a>).</p>
<p>Beware, compilation may report warnings about precision loss, linting
may be a disaster, but the code should remain portable, and the output
accurate enough for most devices (including many inkjet printers). If
you ever miss precision on a particular dataset or peripheral, you may
want to dive in and let <code>U</code> be the next power of
<code>__LINE__</code>.</p>
<p>NOTE: bad inputs will be sanctioned by the production of the 42nd <a
href="https://en.wikipedia.org/wiki/Mersenne_prime">Mersenne prime</a>
(i.e. 2^25964951 -1); memory will be kept.</p>
<h3 id="why-i-think-this-code-is-obfuscated">Why I think this code is
Obfuscated ?</h3>
<p>I’m quite divided on the subject because I wrote:</p>
<ul>
<li>Clear <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a> keywords
but complicated output statements.</li>
<li>No nested loops but loads of function calls.</li>
<li>Easy recursion but no clear data structure.</li>
<li>Easy maths but no use of <code>math.h</code>.</li>
<li>A single <code>if</code>.</li>
</ul>
<p>Be sure to check the antepenultimate line of code.</p>
<h3 id="missing-features">Missing Features</h3>
<h4 id="color-control">Color control</h4>
<p>Cell colors are chosen randomly (with a questionable rejection
scheme). It might have been useful to input them along with sites
coordinates, turning the application into a puzzling graphics
engine.</p>
<h4 id="site-labelling">Site labelling</h4>
<p>The points are implicitly numbered in the order they were entered
(starting at one). This can be overridden however, via a simple XSL
transformation.</p>
<h4 id="site-radius">Site radius</h4>
<p>The site radius is hardcoded in the code, I still wonder why I did
not design it as a function of the underlying cell’s area (which can be
averaged for free) or at least a command line parameter. Same with the
char set, the viewport and potentially every <a
href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a>
property.</p>
<h3 id="see-also">See Also</h3>
<ul>
<li><a href="http://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi at
Wikipedia</a>,</li>
<li><a
href="http://www2.toki.or.id/book/AlgDesignManual/BOOK/BOOK4/NODE187.HTM">An
Excerpt from The Algorithm Design Manual</a>,</li>
<li><a href="http://www.snibbe.com/scott/bf">Voronoi and Art</a></li>
</ul>
<h3 id="example-output">Example Output</h3>
<blockquote>
<figure>
<img src="Voronoi.png"
alt="Voronoi diagram of two regular pentagon vertices" />
<figcaption aria-hidden="true">Voronoi diagram of two regular pentagon
vertices</figcaption>
</figure>
</blockquote>
<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>
<!-- START: this line starts content generated by: bin/gen-inventory.sh -->
<h1 id="inventory-for-2005boutines"><a name="inventory"></a>Inventory
for 2005/boutines</h1>
<h2 id="primary-files">Primary files</h2>
<ul>
<li><a href="index.html">index.html</a> - winner home page</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/boutines.c">boutines.c</a>
- winning source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/Makefile">Makefile</a>
- winner Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/boutines.orig.c">boutines.orig.c</a>
- original source</li>
<li><a href="Voronoi.png">Voronoi.png</a> - output example</li>
<li><a href="eqn.png">eqn.png</a> - equation limit for entry</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/input.txt">input.txt</a>
- sample input</li>
<li><a href="2005_boutines.tar.bz2">2005_boutines.tar.bz2</a> - download
winning source</li>
</ul>
<h2 id="secondary-files">Secondary files</h2>
<ul>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/.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/2005/boutines/.winner.json">.winner.json</a>
- description of winner in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/boutines/README.md">README.md</a>
- markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/gen-inventory.sh -->
<!-- START: this line starts content from: inc/after-content.default.html -->
<!-- END: this line ends content from: inc/after-content.default.html -->
<!-- START: this line starts content from: inc/end-rightcolumn.default.html -->
</div>
<!-- END: this line ends content from: inc/end-rightcolumn.default.html -->
<!-- START: this line starts content from: inc/end-row.default.html -->
</div>
<!-- END: this line ends content from: inc/end-row.default.html -->
<!-- START: this line starts content from: inc/footer.default.html -->
<div class="footer">
<hr>
<h2>Coda</h2>
<p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2005%2Fboutines%2Findex.html">Nu HTML check this web page</a></p>
<p><a href="#top">Jump to top</a> <a href="#content">Jump to Content</a> <a href="#inventory">Jump to Inventory</a></p>
</div>
<!-- END: this line ends content from: inc/footer.default.html -->
<!-- START: this line starts content from: inc/bottom.default.html -->
</body>
</html>
<!-- END: this line ends content from: inc/bottom.default.html -->