fix more broken markdown links

We fix more markdown links in markdown files that refer to files internally to the web site. Added tmp tools to find and print various markdown links: * `tmp/md-links.sh` - print all markdown links * `tmp/md-token-links.sh` - print all markdown links that start with a **%%TOKEN%%** * `tmp/md-local-links.sh` - print all markdown links to a local file * `tmp/md-link-paths.sh` - print local file paths referenced in markdown links Fixed a number of markdown formatting problems with `thanks-for-help.md`. Fixed markdown links to files in `thanks-for-help.md`. Improved heading levels in `thanks-for-help.md`, and made entry sections consistent. Changed all markdown links that end in "))" to end in a better way. Explained in `markdown.md` why we are avoiding markdown links that end in "))". Ran `make www` to perform the above. TODO: Fix stuff we broke by mistake doing the above. TODO: Fix more broken markdown links.
2024-04-26 04:17:20 -07:00
1 parent 60960e1650
commit 4f95e3f3d6
@@ -32,7 +32,7 @@ For some reason, this year's set of winning entries contains three nostalgic gam
 [Asteroids (tsoj)](tsoj/index.html), [Minesweeper (endoh1)](endoh1/index.html),
 and [Snake (ferguson1)](ferguson1/index.html).

-An entry ([kurdyukov1](kurdyukov1/index.html)) pays homage to previous entry
+An entry, [kurdyukov1](kurdyukov1/index.html), pays homage to previous entry
 [2015/hou](2015/hou/index.html).

 ...We'll stop spouting spoilers now. Have fun exploring all the entries!
@@ -54,7 +54,7 @@ Use `prog.alt` as you would `prog` above.
 ## Judges' remarks:

 When playing
-[Minesweeper](https://en.wikipedia.org/wiki/Minesweeper_(video_game)), a
+[Minesweeper](https://en.wikipedia.org/wiki/Minesweeper_&#x28;video_game&#x29;), a
 misclick might ruin a game, so why not leave the routine to the computer?  This
 program automatically uncovers mines according to several rules, and leaves
 guessing (and applying the most straightforward of the rules -- just for fun,
@@ -216,14 +216,14 @@ There are mines in a cell whose "priorities-of-each-cell" is less than

 ### Bug fixes and Credits

-The judges pointed out a bug of the original version that I submitted
-([prog.alt.c](%%REPO_URL%%/2020/endoh1/prog.alt.c)).  Because this program does not provide a feature to
+The judges pointed out a bug of the original version that I submitted,
+[prog.alt.c](%%REPO_URL%%/2020/endoh1/prog.alt.c).  Because this program does not provide a feature to
 flag unprobed cells manually, we can do nothing if the number of unprobed cells
 are equal to the number of mines remaining; [unwinnable.txt](unwinnable.txt) is
 an example for such a case.

 Thus, I implemented an additional rule to flag all unprobed cells in such a case
-into the final version ([prog.c](%%REPO_URL%%/2020/endoh1/prog.c)).
+into the final version: [prog.c](%%REPO_URL%%/2020/endoh1/prog.c).

 [Ilya Kurdyukov](../../authors.html#Ilya_Kurdyukov) also pointed out a warning
 "ignoring return value of 'fscanf'" only when `-O3` is used.  So I changed the
@@ -518,13 +518,13 @@ Analyze the code.</p>
 <p>There are mines in a cell whose “priorities-of-each-cell” is less than
 “number-of-mines”. (But the mine in the first-clicked cell is removed.)</p>
 <h3 id="bug-fixes-and-credits">Bug fixes and Credits</h3>
-<p>The judges pointed out a bug of the original version that I submitted
-(<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/endoh1/prog.alt.c">prog.alt.c</a>). Because this program does not provide a feature to
+<p>The judges pointed out a bug of the original version that I submitted,
+<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/endoh1/prog.alt.c">prog.alt.c</a>. Because this program does not provide a feature to
 flag unprobed cells manually, we can do nothing if the number of unprobed cells
 are equal to the number of mines remaining; <a href="unwinnable.txt">unwinnable.txt</a> is
 an example for such a case.</p>
 <p>Thus, I implemented an additional rule to flag all unprobed cells in such a case
-into the final version (<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/endoh1/prog.c">prog.c</a>).</p>
+into the final version: <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/endoh1/prog.c">prog.c</a>.</p>
 <p><a href="../../authors.html#Ilya_Kurdyukov">Ilya Kurdyukov</a> also pointed out a warning
 “ignoring return value of ‘fscanf’” only when <code>-O3</code> is used. So I changed the
 code a little to pretend to use the return value of <code>fscanf(3)</code>.</p>
@@ -129,7 +129,7 @@ Information about terminal capabilities, dimensions (setting and how to restore

 Workarounds for various game *features*

-* [bugs.html]([bugs.html)
+* [bugs.html](bugs.html)

 Bugs and things that might seem like bugs but are not.

@@ -522,7 +522,7 @@ The [prog.3.c](%%REPO_URL%%/2020/ferguson1/prog.3.c) is in a more artistic layou
 additional obfuscation technique (see spoilers) but it also has more digraphs
 and as the judges said they feel that digraphs are dated so that's probably why
 they chose the first layout. The [prog.3-j.c](%%REPO_URL%%/2020/ferguson1/prog.3-j.c) version is
-[prog.3.c](%%REPO_URL%%%%REPO_URL%%/2020/ferguson1/prog.3.c) with a shorter `J` macro.
+[prog.3.c](%%REPO_URL%%/2020/ferguson1/prog.3.c) with a shorter `J` macro.

 The prog.alt.c version is the one that allows for customising the bug colour and
 it's used in both [snake-colours.sh][] and [play.sh][]. It also calls `erase()`
@@ -495,7 +495,7 @@ This game has a number of configurable pitfalls including walls and snakes.</p>
 </ul>
 <p>Workarounds for various game <em>features</em></p>
 <ul>
-<li><a href="%5Bbugs.html">bugs.html</a></li>
+<li><a href="bugs.html">bugs.html</a></li>
 </ul>
 <p>Bugs and things that might seem like bugs but are not.</p>
 <ul>
@@ -818,7 +818,7 @@ been warned.</li>
 additional obfuscation technique (see spoilers) but it also has more digraphs
 and as the judges said they feel that digraphs are dated so that’s probably why
 they chose the first layout. The <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/prog.3-j.c">prog.3-j.c</a> version is
-<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/masterhttps://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/prog.3.c">prog.3.c</a> with a shorter <code>J</code> macro.</p>
+<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/prog.3.c">prog.3.c</a> with a shorter <code>J</code> macro.</p>
 <p>The prog.alt.c version is the one that allows for customising the bug colour and
 it’s used in both <a href="snake-colours.sh">snake-colours.sh</a> and <a href="play.sh">play.sh</a>. It also calls <code>erase()</code>
 first, clearing the screen, which the play.sh and snake-colours.sh scripts also
@@ -288,7 +288,7 @@ After that you can input the string and it'll go from there.
 BTW: There's a much more entertaining (and delicious) challenge or exercise in
 [recode.html][] (if you're reading this on GitHub check the
 [recode.html](recode.html) file instead); this involves [chocolate-cake.html][] (if
-on GitHub see [here](chocolate-cake.html)) though one might need a different kind
+on GitHub, see [here](chocolate-cake.html), though one might need a different kind
 of exercise after taking up the challenge! :-) These however show the general
 program as well as how to use the two winning entries of the [Morse
 code](https://en.wikipedia.org/wiki/Morse_code) that I referred to earlier:
@@ -423,7 +423,7 @@ it prompts you for the settings
 settings](https://en.wikipedia.org/wiki/Enigma_rotor_details#Ring_setting) and
 positions,
 [reflector](https://www.ciphermachinesandcryptology.com/en/enigmatech.htm#Reflector) and
-[plugboard pairs](https://www.cryptomuseum.com/crypto/enigma/i/sb.htm)),
+[plugboard pairs](https://www.cryptomuseum.com/crypto/enigma/i/sb.htm),
 validating input as you go.

 After that it prompts for text that you can pass to the Enigma simulator;
@@ -775,7 +775,7 @@ of the Wehrmacht rather than the Wehrmacht and the Kriegsmarine.

 [Enigma Message Procedures][]: The [Heer][],
 [Luftwaffe](https://en.wikipedia.org/wiki/Luftwaffe) and
-[Kriegsmarine](https://en.wikipedia.org/wiki/Kriegsmarine))
+[Kriegsmarine](https://en.wikipedia.org/wiki/Kriegsmarine)
 [Enigma](https://en.wikipedia.org/wiki/Enigma_machine)
 procedures.

@@ -600,7 +600,7 @@ pairs</a>.</p>
 <p>BTW: There’s a much more entertaining (and delicious) challenge or exercise in
 <a href="recode.html">recode.html</a> (if you’re reading this on GitHub check the
 <a href="recode.html">recode.html</a> file instead); this involves <a href="chocolate-cake.html">chocolate-cake.html</a> (if
-on GitHub see <a href="chocolate-cake.html">here</a>) though one might need a different kind
+on GitHub, see <a href="chocolate-cake.html">here</a>, though one might need a different kind
 of exercise after taking up the challenge! :-) These however show the general
 program as well as how to use the two winning entries of the <a href="https://en.wikipedia.org/wiki/Morse_code">Morse
 code</a> that I referred to earlier:</p>
@@ -686,7 +686,7 @@ it prompts you for the settings
 settings</a> and
 positions,
 <a href="https://www.ciphermachinesandcryptology.com/en/enigmatech.htm#Reflector">reflector</a> and
-<a href="https://www.cryptomuseum.com/crypto/enigma/i/sb.htm">plugboard pairs</a>),
+<a href="https://www.cryptomuseum.com/crypto/enigma/i/sb.htm">plugboard pairs</a>,
 validating input as you go.</p>
 <p>After that it prompts for text that you can pass to the Enigma simulator;
 alternatively you can specify a file to read in.</p>
@@ -952,7 +952,7 @@ Wehrmacht; when you see this you can read it as the Kriegsmarine versus the rest
 of the Wehrmacht rather than the Wehrmacht and the Kriegsmarine.</p>
 <p><a href="https://web.archive.org/web/20200710094321/http://users.telenet.be/d.rijmenants/en/enigmaproc.htm">Enigma Message Procedures</a>: The <a href="https://en.wikipedia.org/wiki/German_Army_(1935%E2%80%931945)">Heer</a>,
 <a href="https://en.wikipedia.org/wiki/Luftwaffe">Luftwaffe</a> and
-<a href="https://en.wikipedia.org/wiki/Kriegsmarine">Kriegsmarine</a>)
+<a href="https://en.wikipedia.org/wiki/Kriegsmarine">Kriegsmarine</a>
 <a href="https://en.wikipedia.org/wiki/Enigma_machine">Enigma</a>
 procedures.</p>
 <p><a href="http://enigmaco.de/enigma/enigma.html">Interactive Enigma Machine</a>: Shows wiring of the <a href="https://en.wikipedia.org/wiki/Enigma_machine">Enigma
@@ -798,7 +798,7 @@ delicious challenge).</p>
 <h1 id="example-additions"><a href="#toc">Example additions</a></h1>
 </div>
 <ul>
-<li>Add code (to <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/prog.c">prog.c</a>) that tries to determine possible decipherments based on
+<li>Add code, to <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/prog.c">prog.c</a>, that tries to determine possible decipherments based on
 a given crib (or set of cribs).</li>
 </ul>
 <div id="exampleuses">
@@ -550,7 +550,7 @@ delicious challenge).
 # <a href="#toc">Example additions</a>
 </div>

-*   Add code (to [prog.c](%%REPO_URL%%/2020/ferguson1/prog.c)) that tries to determine possible decipherments based on
+*   Add code, to [prog.c](%%REPO_URL%%/2020/ferguson1/prog.c), that tries to determine possible decipherments based on
 a given crib (or set of cribs).


@@ -43,7 +43,7 @@ will be converted to the DTMF sound!

 If the script [try.sh](%%REPO_URL%%/2020/giles/try.sh) did not play a WAV file, it means you do not have
 SoX installed; see [FAQ 3.10: How do I compile and use an IOCCC entry that
-requires sound?](../../faq.html#sox)). In this case install it and try it again or
+requires sound?](../../faq.html#sox). In this case install it and try it again or
 play the files `jenny.wav` and `ioccc28.wav` in a program that can play WAV
 files.

@@ -420,7 +420,7 @@ will be converted to the DTMF sound!</p>
    ./prog 867-5309 &gt; jenny.wav</code></pre>
 <p>If the script <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/giles/try.sh">try.sh</a> did not play a WAV file, it means you do not have
 SoX installed; see <a href="../../faq.html#sox">FAQ 3.10: How do I compile and use an IOCCC entry that
-requires sound?</a>). In this case install it and try it again or
+requires sound?</a>. In this case install it and try it again or
 play the files <code>jenny.wav</code> and <code>ioccc28.wav</code> in a program that can play WAV
 files.</p>
 <p>NOTE: the phone number of <code>jenny.wav</code> comes from
@@ -404,7 +404,7 @@ IOCCC list!</p>
 <p>For some reason, this year’s set of winning entries contains three nostalgic games,
 <a href="tsoj/index.html">Asteroids (tsoj)</a>, <a href="endoh1/index.html">Minesweeper (endoh1)</a>,
 and <a href="ferguson1/index.html">Snake (ferguson1)</a>.</p>
-<p>An entry (<a href="kurdyukov1/index.html">kurdyukov1</a>) pays homage to previous entry
+<p>An entry, <a href="kurdyukov1/index.html">kurdyukov1</a>, pays homage to previous entry
 <a href="2015/hou/index.html">2015/hou</a>.</p>
 <p>…We’ll stop spouting spoilers now. Have fun exploring all the entries!</p>
 <h2 id="remarks-on-some-of-submissions-that-did-not-win">Remarks on some of submissions that did not win</h2>
@@ -66,7 +66,7 @@ I found [here](http://www.kunstderfuge.com/beethoven/variae.htm#Symphonies).
 However, as discussed under the [Limitations](#limitations) section below, not
 all of them work correctly.  I will admit to having used
 `http://www.kunstderfuge.com/-/midi.asp?file=beethoven/symphony_6_1_(c)cvikl.mid`
-for most of my testing (see [cvikl.mid](%%REPO_URL%%/2020/otterness/cvikl.mid)).
+for most of my testing, see [cvikl.mid](%%REPO_URL%%/2020/otterness/cvikl.mid).


 ### Usage
@@ -432,7 +432,7 @@ I found <a href="http://www.kunstderfuge.com/beethoven/variae.htm#Symphonies">he
 However, as discussed under the <a href="#limitations">Limitations</a> section below, not
 all of them work correctly. I will admit to having used
 <code>http://www.kunstderfuge.com/-/midi.asp?file=beethoven/symphony_6_1_(c)cvikl.mid</code>
-for most of my testing (see <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/otterness/cvikl.mid">cvikl.mid</a>).</p>
+for most of my testing, see <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/otterness/cvikl.mid">cvikl.mid</a>.</p>
 <h3 id="usage">Usage</h3>
 <p>Compile the program using the following command (I tested this using both
 <code>clang</code> and <code>gcc</code>):</p>