fix 1992/westley/README.md, warn about TAB intending in markdown.md
One must **NOT** use ASCII TAB characters to intent text. Down the TAB-ed road is nothing but trouble! There are _quasi-solutions_, however those have side effects that lead to a different set of problems. The `markdown.md` was updated to ask that text not be intended with ASCII tabs. See [Please do NOT use ASCII tabs to indent text](https://ioccc-src.github.io/temp-test-ioccc/markdown.html#markdown.html#please-do-not-specify-a-language-for-a-code-block). We discovered this awhile ago and fixed it in markdown files. Sorry (tm Canada 🇨🇦), we forgot to mention this this in `markdown.md`. BTW: It took some **deep magic** to be able to show an HTML comment after a starting fenced markdown code block! See the **NO_COMMENT=** line in `bin/md2html.cfg`. :-) TODO: Stamp out indenting TABs in markdown files, especially in code blocks. TODO: Consider a rule to detect problematic ASCII TAB intendation within makrkdown files.
This commit is contained in:
1 parent
27d6eddf3b
commit
affbd30553
5 files changed
+90
-12
No files matched your search
@@ -80,19 +80,19 @@ To find the approximate place where this entry was judged, type:
|
||||
``` <!---sh-->
|
||||
./whereami.sh 37 -122 # NOTE: - means west of meridian
|
||||
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
./whereami 37 -122 # NOTE: - means west of meridian
|
||||
```
|
||||
|
||||
If you wish to see this on the US map:
|
||||
|
||||
``` <!---sh-->
|
||||
make alt
|
||||
make alt
|
||||
./whereami.alt.sh 37 -122 # NOTE: - means west of meridian
|
||||
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
./whereami.alt.sh 37 -122 # NOTE: - means west of meridian
|
||||
```
|
||||
|
||||
|
||||
@@ -434,15 +434,15 @@ entry and the alternate code so one can try the same script for both:</p>
|
||||
<p>To find the approximate place where this entry was judged, type:</p>
|
||||
<pre><code> ./whereami.sh 37 -122 # NOTE: - means west of meridian
|
||||
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
./whereami 37 -122 # NOTE: - means west of meridian</code></pre>
|
||||
<p>If you wish to see this on the US map:</p>
|
||||
<pre><code> make alt
|
||||
<pre><code> make alt
|
||||
./whereami.alt.sh 37 -122 # NOTE: - means west of meridian
|
||||
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
# or if you don't have at least 80 columns and want to see what it
|
||||
# looks like anyway:
|
||||
./whereami.alt.sh 37 -122 # NOTE: - means west of meridian</code></pre>
|
||||
<h2 id="authors-remarks">Author’s remarks:</h2>
|
||||
<p>Run the program with your latitude & longitude as integer
|
||||
|
||||
@@ -288,6 +288,8 @@ markdown.md
|
||||
KEYWORDS=IOCCC, markdown
|
||||
-s
|
||||
HEADER_2=IOCCC markdown guidelines
|
||||
-s
|
||||
NO_COMMENT=
|
||||
-D
|
||||
./
|
||||
|
||||
|
||||
+29
-1
@@ -438,7 +438,7 @@ for the given page URL.</p>
|
||||
<pre><code>```
|
||||
This code block is NOT indented <=== no thank you
|
||||
```</code></pre>
|
||||
<p>We request that you indent the code block by 4 spaces:</p>
|
||||
<p>We request that you indent the code block by 4 ASCII spaces</p>
|
||||
<pre><code>```
|
||||
This code block
|
||||
is indented 4 spaces
|
||||
@@ -454,6 +454,34 @@ those used in <code>next/rules.md</code> and in <code>next/guidelines.md</code>.
|
||||
| please_do_not_submit_this();
|
||||
}
|
||||
```</code></pre>
|
||||
<h2 id="please-do-not-use-ascii-tabs-to-indent-text">Please do NOT use ASCII tabs to indent text</h2>
|
||||
<p>When indenting a code block in markdown, indent 4 ASCII spaces per level.
|
||||
If you need to indent 2 or more levels, use multiples of 4 ASCII spaces.
|
||||
Please do <strong>NOT</strong> intend with ASCII tabs!</p>
|
||||
<p>For example:</p>
|
||||
<pre><code>```
|
||||
Please do **NOT** indent with ASCII tabs. <=== no thank you
|
||||
|
||||
The top level starts with a 4 ASCII space indent.
|
||||
|
||||
Only indend with multiples of 4 ASCII spaces.
|
||||
2nd level indent needs 8 ASCII spaces (no tabs).
|
||||
3rd level indent needs 12 ASCII spaces (no tabs).
|
||||
etc.
|
||||
```</code></pre>
|
||||
<h2 id="please-do-not-specify-a-language-for-a-code-block">Please do NOT specify a language for a code block</h2>
|
||||
<p>We request that (fenced) markdown code blocks <strong>NOT</strong> specify a language.</p>
|
||||
<p>For example:</p>
|
||||
<pre><code>```c <=== no thank you
|
||||
int main(void) {return 0;}
|
||||
```</code></pre>
|
||||
<p>Instead, put the language inside an HTML comment, separated from the
|
||||
markdown code block starting fence by a space:</p>
|
||||
<pre><code>``` <!---c-->
|
||||
int main(void) {return 0;}
|
||||
```</code></pre>
|
||||
<p><strong>IMPORTANT</strong>: The <strong>initial</strong> <strong>` ` `</strong> must be followed by an <strong><code>ASCII space</code></strong>,
|
||||
then by an <strong>opening</strong> <strong><code><!---</code></strong>, then by the <strong>language</strong>, then by a <strong>closing</strong> <strong><code>--></code></strong>.</p>
|
||||
<h2 id="please-do-not-add-trailing-slash-to-html-elements">Please do NOT add trailing slash to HTML elements</h2>
|
||||
<p>Please do <strong>NOT</strong> use a trailing slash on <a href="https://github.com/validator/validator/wiki/Markup-»-Void-elements">void HTML
|
||||
elements</a>.</p>
|
||||
|
||||
+49
-1
@@ -124,7 +124,7 @@ This code block is NOT indented <=== no thank you
|
||||
````
|
||||
|
||||
|
||||
We request that you indent the code block by 4 spaces:
|
||||
We request that you indent the code block by 4 ASCII spaces
|
||||
|
||||
````
|
||||
```
|
||||
@@ -151,6 +151,54 @@ For example, `next/guidelines.md` uses this markdown code block:
|
||||
````
|
||||
|
||||
|
||||
## Please do NOT use ASCII tabs to indent text
|
||||
|
||||
When indenting a code block in markdown, indent 4 ASCII spaces per level.
|
||||
If you need to indent 2 or more levels, use multiples of 4 ASCII spaces.
|
||||
Please do **NOT** intend with ASCII tabs!
|
||||
|
||||
For example:
|
||||
|
||||
````
|
||||
```
|
||||
Please do **NOT** indent with ASCII tabs. <=== no thank you
|
||||
|
||||
The top level starts with a 4 ASCII space indent.
|
||||
|
||||
Only indend with multiples of 4 ASCII spaces.
|
||||
2nd level indent needs 8 ASCII spaces (no tabs).
|
||||
3rd level indent needs 12 ASCII spaces (no tabs).
|
||||
etc.
|
||||
```
|
||||
````
|
||||
|
||||
|
||||
## Please do NOT specify a language for a code block
|
||||
|
||||
We request that (fenced) markdown code blocks **NOT** specify a language.
|
||||
|
||||
For example:
|
||||
|
||||
````
|
||||
```c <=== no thank you
|
||||
int main(void) {return 0;}
|
||||
```
|
||||
````
|
||||
|
||||
Instead, put the language inside an HTML comment, separated from the
|
||||
markdown code block starting fence by a space:
|
||||
|
||||
````
|
||||
``` <%%NO_COMMENT%%!---c-->
|
||||
int main(void) {return 0;}
|
||||
```
|
||||
````
|
||||
|
||||
**IMPORTANT**: The **initial** **\` \` \`** must be followed by an **`ASCII space`**,
|
||||
then by an **opening** **`<!---`**, then by the **language**, then by a **closing** **`-->`**.
|
||||
|
||||
|
||||
|
||||
## Please do NOT add trailing slash to HTML elements
|
||||
|
||||
Please do **NOT** use a trailing slash on [void HTML
|
||||
|
||||
Reference in new issue
Block a user