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

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

Browse Source 
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:

````
```<!---c-->
    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="&lt;!---c--&gt;"><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.
This commit is contained in:
Landon Curt Noll committed 2024-04-04 14:50:38 -07:00
1 parent 3919df50fb
commit b66c79254a
700 files changed
+7052 -7056
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2005/sykes/README.md
+11 -11
View File
@@ -1,6 +1,6 @@
## To build:
```sh
```<!---sh-->
make
```
@@ -18,14 +18,14 @@ For more detailed information see [2005 sykes bugs](../../bugs.html#2005_sykes).
## To use:
```sh
```<!---sh-->
./sykes binary_file
```
## Try:
```sh
```<!---sh-->
./try.sh
```
@@ -44,7 +44,7 @@ We downloaded the [ROM](https://en.wikipedia.org/wiki/ROM_image) contents to use
the [emulator](https://en.wikipedia.org/wiki/Emulator) in
[PET](https://en.wikipedia.org/wiki/Commodore_PET) mode as follows:
```sh
```<!---sh-->
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-c000.901465-01.bin
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-d000.901465-02.bin
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/edit-2-n.901447-24.bin
@@ -53,7 +53,7 @@ the [emulator](https://en.wikipedia.org/wiki/Emulator) in
We then created:
```sh
```<!---sh-->
dd bs=2k count=1 if=/dev/zero of=nullfill.bin
```
@@ -79,7 +79,7 @@ Compile the program, then test the
[6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
[emulation](https://en.wikipedia.org/wiki/Emulator) like this:
```sh
```<!---sh-->
./sykes 6502test
```
@@ -105,7 +105,7 @@ Make sure you have a [terminal
window](https://en.wikipedia.org/wiki/Terminal_emulator) of 40x25 chars or
bigger, and then run the emulator like this:
```sh
```<!---sh-->
./sykes pet.rom
```
@@ -119,13 +119,13 @@ You should see the startup message. Try typing in some
There is an optional numeric parameter, which controls the speed. For a
slower cursor blink, try
```sh
```<!---sh-->
./sykes pet.rom 6
```
and for faster
```sh
```<!---sh-->
./sykes pet.rom 2
```
@@ -191,7 +191,7 @@ Supplied as a demonstration is a
compiled-for-[6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
version a chess program (heh, I found a use for a previous losing entry :) ). Try:
```sh
```<!---sh-->
./sykes chess
```
@@ -306,7 +306,7 @@ from the Internet. This is to avoid directly infringing any copyright.
What does this do?
```sh
```<!---sh-->
./sykes pet.rom -1
```
2005/sykes/index.html
+14 -14
View File
@@ -141,15 +141,15 @@ Location: <a href="../../location.html#FI">FI</a> - <em>Republic of Finland </em
<!-- 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>
<pre class="&lt;!---sh--&gt;"><code> make</code></pre>
<h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
<p>The current status of this entry is:</p>
<pre><code> STATUS: INABIAF - please **DO NOT** fix</code></pre>
<p>For more detailed information see <a href="../../bugs.html#2005_sykes">2005 sykes bugs</a>.</p>
<h2 id="to-use">To use:</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">./sykes</span> binary_file</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes binary_file</code></pre>
<h2 id="try">Try:</h2>
<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">./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>For those who fondly remember their first
<a href="https://en.wikipedia.org/wiki/Commodore_PET">PET</a>, this entry will start you
@@ -160,12 +160,12 @@ after the C pre-processor gets finished with it!</p>
<p>We downloaded the <a href="https://en.wikipedia.org/wiki/ROM_image">ROM</a> contents to use
the <a href="https://en.wikipedia.org/wiki/Emulator">emulator</a> in
<a href="https://en.wikipedia.org/wiki/Commodore_PET">PET</a> mode as follows:</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="fu">wget</span> http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-c000.901465-01.bin</span>
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a> <span class="fu">wget</span> http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-d000.901465-02.bin</span>
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">wget</span> http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/edit-2-n.901447-24.bin</span>
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">wget</span> http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/kernal-2.901465-03.bin</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-c000.901465-01.bin
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-d000.901465-02.bin
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/edit-2-n.901447-24.bin
wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/kernal-2.901465-03.bin</code></pre>
<p>We then created:</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">dd</span> bs=2k count=1 if=/dev/zero of=nullfill.bin</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> dd bs=2k count=1 if=/dev/zero of=nullfill.bin</code></pre>
<p>For your convenience, we have added the above mentioned files to this entry directory.
They were used to form the <code>pet.rom</code> file.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
@@ -180,7 +180,7 @@ to not infringe the rules.</p>
<p>Compile the program, then test the
<a href="https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description">6502</a>
<a href="https://en.wikipedia.org/wiki/Emulator">emulation</a> like this:</p>
<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">./sykes</span> 6502test</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes 6502test</code></pre>
<p>A basic test is done for each instruction and addressing mode, all tests
should pass. At the end of the tests, it loops forever - break out with
control-C.</p>
@@ -196,15 +196,15 @@ Transactor.</p>
<p>Make sure you have a <a href="https://en.wikipedia.org/wiki/Terminal_emulator">terminal
window</a> of 40x25 chars or
bigger, and then run the emulator like this:</p>
<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">./sykes</span> pet.rom</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes pet.rom</code></pre>
<p>You should see the startup message. Try typing in some
<a href="https://en.wikipedia.org/wiki/BASIC">BASIC</a> - for instance:</p>
<pre><code> PRINT &quot;HELLO, WORLD&quot;</code></pre>
<p>There is an optional numeric parameter, which controls the speed. For a
slower cursor blink, try</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">./sykes</span> pet.rom 6</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes pet.rom 6</code></pre>
<p>and for faster</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">./sykes</span> pet.rom 2</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes pet.rom 2</code></pre>
<p>The default is 4.</p>
<p>The control keys are as follows:</p>
<pre><code> ^A HOME
@@ -243,7 +243,7 @@ The filenames must be upper case in order to be loaded by the emulator.</p>
<p>Supplied as a demonstration is a
compiled-for-<a href="https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description">6502</a>
version a chess program (heh, I found a use for a previous losing entry :) ). Try:</p>
<div class="sourceCode" id="cb16"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a> <span class="ex">./sykes</span> chess</span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes chess</code></pre>
<p>It works as you would expect (it plays very badly). There’s no castling
or en-passant, and to win you must actually take the opponent’s king.</p>
<p>You can write your own programs too, any <a href="https://en.wikibooks.org/wiki/6502_Assembly">6502
@@ -327,7 +327,7 @@ course, the <code>pet.rom</code> is not my work. So I ask the user to download i
from the Internet. This is to avoid directly infringing any copyright.</p>
<h3 id="finally">Finally</h3>
<p>What does this do?</p>
<div class="sourceCode" id="cb17"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true" tabindex="-1"></a> <span class="ex">./sykes</span> pet.rom <span class="at">-1</span></span></code></pre></div>
<pre class="&lt;!---sh--&gt;"><code> ./sykes pet.rom -1</code></pre>
<p>Have fun!</p>
<!--