improved indentation and whitespace for markdown code blocks

All code blocks in markdown have been intended by at least 4 spaces. We add `--tab-stop=8` to all `pandoc(1)` executions in order to set a better tab stop indentation, especially for tab intended code blocks. Changed `bin/pandoc-wrapper.sh` VERSION from "1.5.3 2024-03-26" to "1.6 2024-03-31". Fixed `1991/brnstnd/sorta.README.md` so that the sorta code is code blocks. Removed unneeded paragraph group in copyright in `inc/footer.default.html`. Fixed excess whitespace after list Author on entry `index.html` page. Changed `bin/output-index-author.sh` VERSION from "1.5.2 2024-03-26" to "1.6 2024-03-31". Performed `make www` to perform the above and test under macOS. TODO: Fix the problem of the initial line of code being extra intended. TODO: Fix excess whitespace around code that is inline.
2024-04-01 04:48:48 -07:00
1 parent b84c27ce02
commit a996f8d2b8
@@ -1,7 +1,7 @@
 ## To build:

 ```sh
-make
+    make
 ```

 There is an alternate version of this entry, discussed in the author's remarks.
@@ -11,14 +11,14 @@ See [Alternate code](#alternate-code) below.
 ## To use:

 ```sh
-echo Some text | ./prog
+    echo Some text | ./prog
 ```


 ## Try:

 ```sh
-./try.sh
+    ./try.sh
 ```

 As the script says if you want to move to the next command at any point
@@ -35,7 +35,7 @@ author in the '[prog.c](prog.c) vs [prog.alt.c](prog.alt.c)' section of their re
 ### Alternate build:

 ```sh
-make alt
+    make alt
 ```


@@ -85,13 +85,13 @@ been shortened in this file.
 If you have `clang`:

 ```sh
-CC=clang make -e
+    CC=clang make -e
 ```

 Otherwise (gcc):

 ```sh
-make
+    make
 ```

 (You will get a few warnings in this case.)
@@ -117,21 +117,21 @@ needed in this case).
 #### Basic mode:

 ```sh
-$ echo 'I am testing this thing.' | ./prog
-[... rendering ...]
+    $ echo 'I am testing this thing.' | ./prog
+    [... rendering ...]

-$ ./prog < lorem-ipsum.txt
-[... rendering ...]
+    $ ./prog < lorem-ipsum.txt
+    [... rendering ...]
 ```


 #### Interactive mode:

 ```sh
-$ ./prog
-> hello world!!!
-[... rendering ...]
->
+    $ ./prog
+    > hello world!!!
+    [... rendering ...]
+    >
 ```


@@ -174,7 +174,7 @@ In order to comply with the size rule, I encoded only a part of the visible ASCI
 chars:

 ```
-a-z, A-Z, '.' ':' ',' ';' '!' and '?'.
+    a-z, A-Z, '.' ':' ',' ';' '!' and '?'.
 ```

 Uppercase and lowercase chars are rendered the same. The program also
@@ -207,7 +207,7 @@ simple text documents.
 Thus, if you try for example:

 ```sh
-$ ./prog < prog.c
+    $ ./prog < prog.c
 ```

 You will not get something that looks like C code. (but you can still try, if
@@ -220,7 +220,7 @@ Defining an environment variable called `DRAFT` will enable the 'draft-mode'.
 Try for example:

 ```sh
-$ echo 'testing the draft mode' | DRAFT=1 ./prog
+    $ echo 'testing the draft mode' | DRAFT=1 ./prog
 ```

 The program will run much faster but the rendering will be less precise.
@@ -132,8 +132,7 @@
 <h2 id="author"><a name="author"></a>Author:</h2>
 <ul>
 <li>Name: <a href="../../authors.html#Etienne_Duble">Etienne Duble</a><br>
-Location: <a href="../../location.html#FR">FR</a> - <em>French Republic</em> (<em>France</em>)
-<br><br></li>
+Location: <a href="../../location.html#FR">FR</a> - <em>French Republic</em> (<em>France</em>)</li>
 </ul>

 <!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -142,13 +141,13 @@ Location: <a href="../../location.html#FR">FR</a> - <em>French Republic</em> (<e
 <!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.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>
+<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>
 <p>There is an alternate version of this entry, discussed in the author’s remarks.
 See <a href="#alternate-code">Alternate 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="bu">echo</span> Some text <span class="kw">|</span> <span class="ex">./prog</span></span></code></pre></div>
+<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="bu">echo</span> Some text <span class="kw">|</span> <span class="ex">./prog</span></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">./try.sh</span></span></code></pre></div>
+<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>
 <p>As the script says if you want to move to the next command at any point
 (lorem-ipsum.txt takes a while to print in particular) you may do so by hitting
 ctrl-c/sending intr.</p>
@@ -156,7 +155,7 @@ ctrl-c/sending intr.</p>
 <p>This alternate code, provided by the author, is discussed in more detail by the
 author in the ‘<a href="prog.c">prog.c</a> vs <a href="prog.alt.c">prog.alt.c</a>’ section of their remarks.</p>
 <h3 id="alternate-build">Alternate build:</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">make</span> alt</span></code></pre></div>
+<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> alt</span></code></pre></div>
 <h3 id="alternate-use">Alternate use:</h3>
 <p>Use <code>prog.alt</code> as you would <code>prog</code> above.</p>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
@@ -182,9 +181,9 @@ with other compilers or optimization levels). These have been fixed in
 been shortened in this file.</p>
 <h3 id="how-to-build">How to build</h3>
 <p>If you have <code>clang</code>:</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="va">CC</span><span class="op">=</span>clang <span class="fu">make</span> <span class="at">-e</span></span></code></pre></div>
+<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="va">CC</span><span class="op">=</span>clang <span class="fu">make</span> <span class="at">-e</span></span></code></pre></div>
 <p>Otherwise (gcc):</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">make</span></span></code></pre></div>
+<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">make</span></span></code></pre></div>
 <p>(You will get a few warnings in this case.)</p>
 <h3 id="how-to-use-it">How to use it</h3>
 <p>You need a terminal configured to handle a <em>UTF-8</em> encoding and a font including
@@ -197,16 +196,16 @@ configuration was needed.</p>
 <p>I also tested it on FreeBSD 9.3 32bits (font and encoding configuration was
 needed in this case).</p>
 <h4 id="basic-mode">Basic mode:</h4>
-<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> echo <span class="st">&#39;I am testing this thing.&#39;</span> <span class="kw">|</span> <span class="ex">./prog</span></span>
-<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="ex">[...</span> rendering ...]</span>
+<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> echo <span class="st">&#39;I am testing this thing.&#39;</span> <span class="kw">|</span> <span class="ex">./prog</span></span>
+<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a>    <span class="ex">[...</span> rendering ...]</span>
 <span id="cb7-3"><a href="#cb7-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a><span class="ex">$</span> ./prog <span class="op">&lt;</span> lorem-ipsum.txt</span>
-<span id="cb7-5"><a href="#cb7-5" aria-hidden="true" tabindex="-1"></a><span class="ex">[...</span> rendering ...]</span></code></pre></div>
+<span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a>    <span class="ex">$</span> ./prog <span class="op">&lt;</span> lorem-ipsum.txt</span>
+<span id="cb7-5"><a href="#cb7-5" aria-hidden="true" tabindex="-1"></a>    <span class="ex">[...</span> rendering ...]</span></code></pre></div>
 <h4 id="interactive-mode">Interactive mode:</h4>
-<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">$</span> ./prog</span>
-<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;</span> hello <span class="ex">world!!!</span></span>
-<span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a><span class="ex">[...</span> rendering ...]</span>
-<span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;</span></span></code></pre></div>
+<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">$</span> ./prog</span>
+<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a>    <span class="op">&gt;</span> hello <span class="ex">world!!!</span></span>
+<span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a>    <span class="ex">[...</span> rendering ...]</span>
+<span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a>    <span class="op">&gt;</span></span></code></pre></div>
 <h3 id="obfuscation">Obfuscation:</h3>
 <p>This entry is obfuscated in various ways:</p>
 <ul>
@@ -239,7 +238,7 @@ encoded in macro <code>O_o</code> at the top of the source file.</li>
 <h4 id="charset">Charset</h4>
 <p>In order to comply with the size rule, I encoded only a part of the visible ASCII
 chars:</p>
-<pre><code>a-z, A-Z, &#39;.&#39; &#39;:&#39; &#39;,&#39; &#39;;&#39; &#39;!&#39; and &#39;?&#39;.</code></pre>
+<pre><code>    a-z, A-Z, &#39;.&#39; &#39;:&#39; &#39;,&#39; &#39;;&#39; &#39;!&#39; and &#39;?&#39;.</code></pre>
 <p>Uppercase and lowercase chars are rendered the same. The program also
 understands space and linefeed (<code>\n</code>). Other chars are simply ignored (most of
 the time ;)</p>
@@ -256,13 +255,13 @@ could still happen in case of long words.</p>
 <p>Given the limited set of characters handled, the program is mostly limited to
 simple text documents.</p>
 <p>Thus, if you try for example:</p>
-<div class="sourceCode" id="cb10"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="ex">$</span> ./prog <span class="op">&lt;</span> prog.c</span></code></pre></div>
+<div class="sourceCode" id="cb10"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a>    <span class="ex">$</span> ./prog <span class="op">&lt;</span> prog.c</span></code></pre></div>
 <p>You will not get something that looks like C code. (but you can still try, if
 you are curious. :)</p>
 <h4 id="a-draft-mode">A ‘draft’ mode</h4>
 <p>Defining an environment variable called <code>DRAFT</code> will enable the ‘draft-mode’.
 Try for example:</p>
-<div class="sourceCode" id="cb11"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="ex">$</span> echo <span class="st">&#39;testing the draft mode&#39;</span> <span class="kw">|</span> <span class="va">DRAFT</span><span class="op">=</span>1 <span class="ex">./prog</span></span></code></pre></div>
+<div class="sourceCode" id="cb11"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a>    <span class="ex">$</span> echo <span class="st">&#39;testing the draft mode&#39;</span> <span class="kw">|</span> <span class="va">DRAFT</span><span class="op">=</span>1 <span class="ex">./prog</span></span></code></pre></div>
 <p>The program will run much faster but the rendering will be less precise.</p>
 <h4 id="the-subtle-interactive-mode">The subtle interactive mode</h4>
 <p>I saved the best for last: usually, programs that handle an “interactive mode”