add hack-a-round for language specified markdown code blocks

When language is specified in a markdown code block such as: ```` ```c printf("Hello, world!\n"); ``` ```` is used, the resulting HTML as produced by `pandoc(1)` combined with our revised `ioccc.css` is not intent the code block well. A temporary "_hack-a-round_" is to turn the "markdown code language specifier" into an HTML comment. For example: ```` ``` printf("Hello, world!\n"); ``` ```` This commits turns off existing markdown code language specifiers for now, while preserving our ability to restore them in the future when a better "_hack-a-round_" to the "markdown code language specifier" problem is found. The HTML impact if this "_hack-a-round_" is to produce HTML that looks like this: ``` <pre class=""><code> .. </code></pre> ``` We might be able to create a complex set of classes for each markdown code language (there won't be very many) in `ioccc.css`, or we might find a more general CSS (or maybe `pandoc(1)`?) solution. For now, this hack-a-round will have to do.
2024-04-04 14:50:38 -07:00
1 parent 3919df50fb
commit b66c79254a
@@ -1,13 +1,13 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```


 ## To use:

-```sh
+```<!---sh-->
    some_command | ./biggar | od -c

    ./biggar < file | od -c
@@ -16,7 +16,7 @@

 ## Try:

-```sh
+```<!---sh-->
    ./try.sh
 ```

@@ -141,13 +141,13 @@ Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em></l
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">some_command</span> <span class="kw">|</span> <span class="ex">./biggar</span> <span class="kw">|</span> <span class="fu">od</span> <span class="at">-c</span></span>
-<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a>    <span class="ex">./biggar</span> <span class="op">&lt;</span> file <span class="kw">|</span> <span class="fu">od</span> <span class="at">-c</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    some_command | ./biggar | od -c
+
+    ./biggar &lt; file | od -c</code></pre>
 <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>
+<pre class="&lt;!---sh--&gt;"><code>    ./try.sh</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p>By changing the compile line you can make this program do anything you
 want. This is a very efficient way to transfer source, though it
@@ -1,6 +1,6 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```

@@ -10,7 +10,7 @@ To compile on a 16 bit machine, change 300000 to 30000.

 ## To use:

-```sh
+```<!---sh-->
    ./heckbert col < file
 ```

@@ -19,7 +19,7 @@ where col is the number of columns to fold at and file is the file to fold.

 ## Try:

-```sh
+```<!---sh-->
    ./try.sh
 ```

@@ -28,7 +28,7 @@ where col is the number of columns to fold at and file is the file to fold.

 Folding at the wrong length may be equivalent to a "Spindle or Mutilate" operation. For example:

-```sh
+```<!---sh-->
    ./heckbert 40 < heckbert.c > ph.c ; make ph ; ./ph 20 < heckbert.c > bar.c ; make bar
 ```

@@ -141,17 +141,17 @@ Location: <a href="../../location.html#US">US</a> - <em>United States of America
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <p>On System V systems, we had to compile with <code>-Dindex=strchr</code>.
 To compile on a 16 bit machine, change 300000 to 30000.</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">./heckbert</span> col <span class="op">&lt;</span> file</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./heckbert col &lt; file</code></pre>
 <p>where col is the number of columns to fold at and file is the file to fold.</p>
 <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>
+<pre class="&lt;!---sh--&gt;"><code>    ./try.sh</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p>Folding at the wrong length may be equivalent to a “Spindle or Mutilate” operation. For example:</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">./heckbert</span> 40 <span class="op">&lt;</span> heckbert.c <span class="op">&gt;</span> ph.c <span class="kw">;</span> <span class="fu">make</span> ph <span class="kw">;</span> <span class="ex">./ph</span> 20 <span class="op">&lt;</span> heckbert.c <span class="op">&gt;</span> bar.c <span class="kw">;</span> <span class="fu">make</span> bar</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./heckbert 40 &lt; heckbert.c &gt; ph.c ; make ph ; ./ph 20 &lt; heckbert.c &gt; bar.c ; make bar</code></pre>
 <p>Try not to
 <a href="https://repository.library.brown.edu/studio/item/bdr:788264/PDF/">Fold, Spindle or Mutilate</a>
 files. :-)</p>
@@ -1,20 +1,20 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```


 ## To use:

-```sh
+```<!---sh-->
    ./hines file.c
 ```


 ## Try:

-```sh
+```<!---sh-->
    ./try.sh
 ```

@@ -141,11 +141,11 @@ Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em></l
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">./hines</span> file.c</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./hines file.c</code></pre>
 <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>
+<pre class="&lt;!---sh--&gt;"><code>    ./try.sh</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p>This program was designed to maximize the bother function for
 structured programmers. This program takes <code>goto</code> statements to their
@@ -1,13 +1,13 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```


 ## To use:

-```sh
+```<!---sh-->
    ./korn
 ```

@@ -29,14 +29,14 @@ Several points are important to understand this program:
 2. What is the value of the symbol `"have"`?  (hint: the value is NOT 4
 characters, or `'h'`, or a string)  Consider the fact that:

-```c
+```<!---c-->
    char *x;
 ```

 defines a pointer to a `char` (i.e. an address), and that the `=` assigns
 things of compatible types.  Since:

-```c
+```<!---c-->
    x = "have";
 ```

@@ -44,13 +44,13 @@ is legal C, what type of value is `"have"`?

 3. Note that the following expressions yield the same value:

-```c
+```<!---c-->
    x[3]	*(x+3)	  *(3+x)
 ```

 since addition is commutative.  What can be said about this value?

-```c
+```<!---c-->
    3[x]
 ```

@@ -141,9 +141,9 @@ Location: <a href="../../location.html#US">US</a> - <em>United States of America
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">./korn</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./korn</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p>The Judges believe that this is the best one line entry ever received.
 Compile on a UNIX system, or at least one using a C implementation that
@@ -158,17 +158,17 @@ section right now and see if you are one of the few people who can.</p>
 <li><p>What is the value of the symbol <code>"have"</code>? (hint: the value is NOT 4
 characters, or <code>'h'</code>, or a string) Consider the fact that:</p></li>
 </ol>
-<div class="sourceCode" id="cb3"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a>    <span class="dt">char</span> <span class="op">*</span>x<span class="op">;</span></span></code></pre></div>
+<pre class="&lt;!---c--&gt;"><code>    char *x;</code></pre>
 <p>defines a pointer to a <code>char</code> (i.e. an address), and that the <code>=</code> assigns
 things of compatible types. Since:</p>
-<div class="sourceCode" id="cb4"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a>    x <span class="op">=</span> <span class="st">&quot;have&quot;</span><span class="op">;</span></span></code></pre></div>
+<pre class="&lt;!---c--&gt;"><code>    x = &quot;have&quot;;</code></pre>
 <p>is legal C, what type of value is <code>"have"</code>?</p>
 <ol start="3" type="1">
 <li>Note that the following expressions yield the same value:</li>
 </ol>
-<div class="sourceCode" id="cb5"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a>    x<span class="op">[</span><span class="dv">3</span><span class="op">]</span>        <span class="op">*(</span>x<span class="op">+</span><span class="dv">3</span><span class="op">)</span>    <span class="op">*(</span><span class="dv">3</span><span class="op">+</span>x<span class="op">)</span></span></code></pre></div>
+<pre class="&lt;!---c--&gt;"><code>    x[3]        *(x+3)    *(3+x)</code></pre>
 <p>since addition is commutative. What can be said about this value?</p>
-<div class="sourceCode" id="cb6"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a>    <span class="dv">3</span><span class="op">[</span>x<span class="op">]</span></span></code></pre></div>
+<pre class="&lt;!---c--&gt;"><code>    3[x]</code></pre>
 <p><a href="https://news.slashdot.org/story/01/02/06/2030205/david-korn-tells-all">David
 Korn</a>’s
 <a href="https://en.wikipedia.org/wiki/KornShell">/bin/ksh</a> provides us with a greatly
@@ -1,13 +1,13 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```


 ## To use:

-```sh
+```<!---sh-->
    ./lievaart
    # enter a level and start playing as described below
 ```
@@ -17,7 +17,7 @@

 To see what it would have looked like without the size restrictions:

-```sh
+```<!---sh-->
    ./lievaart2
    # enter a level and start playing as described below
 ```
@@ -141,14 +141,14 @@ Location: <a href="../../location.html#NL">NL</a> - <em>Kingdom of the Netherlan
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">./lievaart</span></span>
-<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a>    <span class="co"># enter a level and start playing as described below</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./lievaart
+    # enter a level and start playing as described below</code></pre>
 <h2 id="try">Try:</h2>
 <p>To see what it would have looked like without the size restrictions:</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">./lievaart2</span></span>
-<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a>    <span class="co"># enter a level and start playing as described below</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./lievaart2
+    # enter a level and start playing as described below</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p>We believe that you too will be amazed at just how much power Mr. Lievaart
 packed into 1024 bytes!</p>
@@ -1,13 +1,13 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
    ```


 ## To use:

-```sh
+```<!---sh-->
    ./wall
    # enter some numbers

@@ -18,14 +18,14 @@

 ## Try:

-```sh
+```<!---sh-->
    ./try.sh
 ```

 You may of course run the commands manually and enter text as you wish. For
 instance you might try one or both of:

-```sh
+```<!---sh-->
    ./wall | bc

    ./wall | cat
@@ -141,20 +141,20 @@ Location: <a href="../../location.html#US">US</a> - <em>United States of America
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">./wall</span></span>
-<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a>    <span class="co"># enter some numbers</span></span>
-<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb2-4"><a href="#cb2-4" aria-hidden="true" tabindex="-1"></a>    <span class="ex">./wall</span> <span class="kw">|</span> <span class="ex">some_command</span></span>
-<span id="cb2-5"><a href="#cb2-5" aria-hidden="true" tabindex="-1"></a>    <span class="co"># enter some strings or numbers, depending on command</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./wall
+    # enter some numbers
+
+    ./wall | some_command
+    # enter some strings or numbers, depending on command</code></pre>
 <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>
+<pre class="&lt;!---sh--&gt;"><code>    ./try.sh</code></pre>
 <p>You may of course run the commands manually and enter text as you wish. For
 instance you might try one or both of:</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">./wall</span> <span class="kw">|</span> <span class="fu">bc</span></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">./wall</span> <span class="kw">|</span> <span class="fu">cat</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./wall | bc
+
+    ./wall | cat</code></pre>
 <p>and enter some input like:</p>
 <pre><code>    x*x
    2^x
@@ -1,13 +1,13 @@
 ## To build:

-```sh
+```<!---sh-->
    make all
 ```


 ## To use:

-```sh
+```<!---sh-->
    ./westley
 ```

@@ -141,9 +141,9 @@ Location: <a href="../../location.html#US">US</a> - <em>United States of America
 <!-- 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> all</span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    make all</code></pre>
 <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">./westley</span></span></code></pre></div>
+<pre class="&lt;!---sh--&gt;"><code>    ./westley</code></pre>
 <h2 id="judges-remarks">Judges’ remarks:</h2>
 <p><code>putchar()</code> must exist in the C library and not just as a macro.
 If it fails to compile, bug your OS/compiler vendor.</p>