Skip to content

Commit a3fb61a

Browse files
committed
improve PR #246 - part 2
Simplify link tags in rules and guidelines. Ran `make quick_www` to perform the above.
1 parent 8a95f0c commit a3fb61a

File tree

5 files changed

+45
-57
lines changed

5 files changed

+45
-57
lines changed

next/guidelines.html

Lines changed: 13 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -484,14 +484,14 @@ <h1 id="guidelines-for-rule-1---c-program">Guidelines for <a href="rules.html#ru
484484
We would prefer if you do not use <code>#include</code> statements,
485485
especially <code>#include</code> statements just to include lots of data,
486486
to get around the
487-
<a href="rules.html#rule2-size-restrictions">Rule 2 - Size restrictions</a>
487+
<a href="rules.html#rule2-size">Rule 2 - Size restrictions</a>
488488
in an excessive way.
489489
</p>
490490
<p class="leftbar">
491491
We would prefer if you do not require lots and lots of implicit defines on the C compiler command line
492492
(i.e., lots of <code>-Dfoo</code>, and <code>-Dcurds=whey</code> style command line args to the C compiler)
493493
to get around the
494-
<a href="rules.html#rule2-size-restrictions">Rule 2 - Size restrictions</a>
494+
<a href="rules.html#rule2-size">Rule 2 - Size restrictions</a>
495495
in an excessive way.
496496
</p>
497497
<p class="leftbar">
@@ -508,10 +508,8 @@ <h1 id="guidelines-for-rule-1---c-program">Guidelines for <a href="rules.html#ru
508508
</p>
509509
<p>Jump to: <a href="#">top</a></p>
510510
<div id="guideline2">
511-
<div id="guideline-2---size">
512511
<div id="guideline2-size">
513-
<h1 id="guidelines-for-rule-2---size-restrictions">Guidelines for <a href="rules.html#rule2-size-restrictions">Rule 2 - Size restrictions</a></h1>
514-
</div>
512+
<h1 id="guidelines-for-rule-2---size-restrictions">Guidelines for <a href="rules.html#rule2-size">Rule 2 - Size restrictions</a></h1>
515513
</div>
516514
</div>
517515
<p class="leftbar">
@@ -621,7 +619,7 @@ <h1 id="guidelines-for-rule-8---submitting-requirements">Guidelines for <a href=
621619
<div id="guideline9">
622620
<div id="guideline9-no-interactive-compiling-allowed">
623621
<div id="guideline9-no-interactive">
624-
<h1 id="guidelines-for-rule-9---no-interactive-compiling-allowed">Guidelines for <a href="rules.html#rule-9---no-interactive-compiling-allowed">Rule 9 - No interactive compiling allowed</a></h1>
622+
<h1 id="guidelines-for-rule-9---no-interactive-compiling-allowed">Guidelines for <a href="rules.html#rule9-no-interactive">Rule 9 - No interactive compiling allowed</a></h1>
625623
</div>
626624
</div>
627625
</div>
@@ -643,11 +641,9 @@ <h1 id="guidelines-for-rule-9---no-interactive-compiling-allowed">Guidelines for
643641
<p>Jump to: <a href="#">top</a></p>
644642
<div id="guideline11">
645643
<div id="guideline11-abuse">
646-
<div id="guideline-11---abuse">
647644
<h1 id="guidelines-for-rule-11---legal-rule-abuse">Guidelines for <a href="rules.html#rule11-legal-rule-abuse">Rule 11 - Legal rule abuse</a></h1>
648645
</div>
649646
</div>
650-
</div>
651647
<p>We do realize that there are holes in the <a href="rules.html">Rules</a>, and invite
652648
submitters to attempt to apply creative rule interpretation. A rule abuse though, even
653649
if not rewarded, may result in a subsequent rule change for future contests.</p>
@@ -706,14 +702,13 @@ <h1 id="guidelines-for-rule-11---legal-rule-abuse">Guidelines for <a href="rules
706702
<p>Jump to: <a href="#">top</a></p>
707703
<div id="guideline12">
708704
<div id="guideline12-utf8">
709-
<h1 id="guidelines-for-rule-12---utf-8">Guidelines for <a href="rules.html#rule-12---utf-8">Rule 12 - UTF-8</a></h1>
710-
<p><a href="rules.html#rule12-utf8">Rule 12 - UTF-8</a></p>
705+
<h1 id="guidelines-for-rule-12---utf-8">Guidelines for <a href="rules.html#rule12-utf8">Rule 12 - UTF-8</a></h1>
711706
</div>
712707
</div>
713708
<p>The IOCCC no longer discourages the use of multibyte UTF-8 characters in <code>C</code> code.</p>
714709
<div id="guideline13">
715710
<div id="guideline13-nocr">
716-
<h1 id="guidelines-for-rule-13---no-carriage-returns-in-prog.c">Guidelines for <a href="rules.html#rule-13---no-carriage-returns-in-prog.c">Rule 13 - No carriage returns in prog.c</a></h1>
711+
<h1 id="guidelines-for-rule-13---no-carriage-returns-in-prog.c">Guidelines for <a href="rules.html#rule13-nocr">Rule 13 - No carriage returns in prog.c</a></h1>
717712
</div>
718713
</div>
719714
<p>We <strong>DISLIKE</strong> C code with trailing control-M’s (<code>\r</code> or <code>\015</code>) that results
@@ -723,21 +718,22 @@ <h1 id="guidelines-for-rule-13---no-carriage-returns-in-prog.c">Guidelines for <
723718
off such control-M’s before submitting their submissions. In some cases
724719
tools have a “Save As” option that will prevent such trailing control-M’s
725720
being added.</p>
726-
<p>If your <code>prog.c</code> is near the
721+
<p class="leftbar">
722+
If your <code>prog.c</code> is near the
727723
<a href="rules.html#rule2a-gross-size">Rule 2a Gross Size</a> and/or
728724
<a href="rules.html#rule2b-net-size">Rule 2b Net Size</a>
729725
limit, you are permitted to <strong>NOT</strong> end source with a newline.
730-
If you need to do this, please document that in your <code>remarks.md</code> file.</p>
731-
<p>If your complains about about not ending in a newline,
732-
please this in your <code>remarks.md</code> file.</p>
726+
If you need to do this, please document that in your <code>remarks.md</code> file.
727+
</p>
728+
<p class="leftbar">
729+
If your complains about about not ending in a newline, please this in your <code>remarks.md</code> file.
730+
</p>
733731
<p>Jump to: <a href="#">top</a></p>
734732
<div id="guideline15">
735-
<div id="guideline-15---building">
736733
<div id="guideline15-gnu-makefile">
737734
<h1 id="guidelines-for-rule-15---gnu-makefile">Guidelines for <a href="rules.html#rule15-gnu-makefile">Rule 15 - GNU Makefile</a></h1>
738735
</div>
739736
</div>
740-
</div>
741737
<p>Submissions will be judged in an environment that has no <strong>IDE</strong>.
742738
Any submission that fails to compile/build because it requires
743739
an <strong>IDE</strong> will be rejected.</p>
@@ -757,12 +753,10 @@ <h1 id="guidelines-for-rule-15---gnu-makefile">Guidelines for <a href="rules.htm
757753
FAQ on “<a href="../faq.html#makefile_details">What are the detailed recommendations for a submission Makefile?</a>”.</p>
758754
<p>Jump to: <a href="#">top</a></p>
759755
<div id="guideline17">
760-
<div id="guideline-17---packaging">
761756
<div id="guideline17-mkiocccentry">
762757
<h1 id="guidelines-for-rule-17---use-mkiocccentry">Guidelines for <a href="rules.html#rule17-mkiocccentry">Rule 17 - Use mkiocccentry</a></h1>
763758
</div>
764759
</div>
765-
</div>
766760
<p class="leftbar">
767761
We <strong>STRONGLY</strong> recommend you <strong>do</strong> install the most recent release of
768762
<a href="https://github.com/ioccc-src/mkiocccentry">mkiocccentry toolkit</a>

next/guidelines.md

Lines changed: 11 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -42,15 +42,15 @@ file happens to also be a code for another language.
4242
We would prefer if you do not use `#include` statements,
4343
especially `#include` statements just to include lots of data,
4444
to get around the
45-
[Rule 2 - Size restrictions](rules.html#rule2-size-restrictions)
45+
[Rule 2 - Size restrictions](rules.html#rule2-size)
4646
in an excessive way.
4747
</p>
4848

4949
<p class="leftbar">
5050
We would prefer if you do not require lots and lots of implicit defines on the C compiler command line
5151
(i.e., lots of `-Dfoo`, and `-Dcurds=whey` style command line args to the C compiler)
5252
to get around the
53-
[Rule 2 - Size restrictions](rules.html#rule2-size-restrictions)
53+
[Rule 2 - Size restrictions](rules.html#rule2-size)
5454
in an excessive way.
5555
</p>
5656

@@ -74,10 +74,8 @@ Jump to: [top](#)
7474

7575

7676
<div id="guideline2">
77-
<div id="guideline-2---size">
7877
<div id="guideline2-size">
79-
# Guidelines for [Rule 2 - Size restrictions](rules.html#rule2-size-restrictions)
80-
</div>
78+
# Guidelines for [Rule 2 - Size restrictions](rules.html#rule2-size)
8179
</div>
8280
</div>
8381

@@ -229,7 +227,7 @@ Jump to: [top](#)
229227
<div id="guideline9">
230228
<div id="guideline9-no-interactive-compiling-allowed">
231229
<div id="guideline9-no-interactive">
232-
# Guidelines for [Rule 9 - No interactive compiling allowed](rules.html#rule-9---no-interactive-compiling-allowed)
230+
# Guidelines for [Rule 9 - No interactive compiling allowed](rules.html#rule9-no-interactive)
233231
</div>
234232
</div>
235233
</div>
@@ -264,11 +262,9 @@ Jump to: [top](#)
264262

265263
<div id="guideline11">
266264
<div id="guideline11-abuse">
267-
<div id="guideline-11---abuse">
268265
# Guidelines for [Rule 11 - Legal rule abuse](rules.html#rule11-legal-rule-abuse)
269266
</div>
270267
</div>
271-
</div>
272268

273269
We do realize that there are holes in the [Rules](rules.html), and invite
274270
submitters to attempt to apply creative rule interpretation. A rule abuse though, even
@@ -343,8 +339,7 @@ Jump to: [top](#)
343339

344340
<div id="guideline12">
345341
<div id="guideline12-utf8">
346-
# Guidelines for [Rule 12 - UTF-8](rules.html#rule-12---utf-8)
347-
[Rule 12 - UTF-8](rules.html#rule12-utf8)
342+
# Guidelines for [Rule 12 - UTF-8](rules.html#rule12-utf8)
348343
</div>
349344
</div>
350345

@@ -353,7 +348,7 @@ The IOCCC no longer discourages the use of multibyte UTF-8 characters in `C` cod
353348

354349
<div id="guideline13">
355350
<div id="guideline13-nocr">
356-
# Guidelines for [Rule 13 - No carriage returns in prog.c](rules.html#rule-13---no-carriage-returns-in-prog.c)
351+
# Guidelines for [Rule 13 - No carriage returns in prog.c](rules.html#rule13-nocr)
357352
</div>
358353
</div>
359354

@@ -366,26 +361,27 @@ off such control-M's before submitting their submissions. In some cases
366361
tools have a "Save As" option that will prevent such trailing control-M's
367362
being added.
368363

364+
<p class="leftbar">
369365
If your `prog.c` is near the
370366
[Rule 2a Gross Size](rules.html#rule2a-gross-size) and/or
371367
[Rule 2b Net Size](rules.html#rule2b-net-size)
372368
limit, you are permitted to **NOT** end source with a newline.
373369
If you need to do this, please document that in your `remarks.md` file.
370+
</p>
374371

375-
If your complains about about not ending in a newline,
376-
please this in your `remarks.md` file.
372+
<p class="leftbar">
373+
If your complains about about not ending in a newline, please this in your `remarks.md` file.
374+
</p>
377375

378376

379377
Jump to: [top](#)
380378

381379

382380
<div id="guideline15">
383-
<div id="guideline-15---building">
384381
<div id="guideline15-gnu-makefile">
385382
# Guidelines for [Rule 15 - GNU Makefile](rules.html#rule15-gnu-makefile)
386383
</div>
387384
</div>
388-
</div>
389385

390386
Submissions will be judged in an environment that has no **IDE**.
391387
Any submission that fails to compile/build because it requires
@@ -413,12 +409,10 @@ Jump to: [top](#)
413409

414410

415411
<div id="guideline17">
416-
<div id="guideline-17---packaging">
417412
<div id="guideline17-mkiocccentry">
418413
# Guidelines for [Rule 17 - Use mkiocccentry](rules.html#rule17-mkiocccentry)
419414
</div>
420415
</div>
421-
</div>
422416

423417
<p class="leftbar">
424418
We **STRONGLY** recommend you **do** install the most recent release of

next/rules.html

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -525,12 +525,10 @@ <h2 id="rule-1---c-program">Rule 1 - C program</h2>
525525
<div id="rule2">
526526
<div id="rule2-size-restrictions">
527527
<div id="rule2-size">
528-
<div id="rule-2---size">
529528
<h2 id="rule-2---size-restrictions">Rule 2 - Size restrictions</h2>
530529
</div>
531530
</div>
532531
</div>
533-
</div>
534532
<p><code>Rule 2</code> requires that your submission satisfy <strong>BOTH</strong>
535533
<a href="rules.html#rule2a">Rule 2a (Gross Size)</a>
536534
and
@@ -540,21 +538,17 @@ <h2 id="rule-2---size-restrictions">Rule 2 - Size restrictions</h2>
540538
<p>See the <a href="guidelines.html#guideline2-size">Guidelines for Rule 2 - Size restrictions</a>.</p>
541539
<div id="rule2a">
542540
<div id="rule2a-gross-size">
543-
<div id="rule-2a-gross-size">
544541
<h3 id="rule-2a---gross-size">Rule 2a - Gross Size</h3>
545542
</div>
546543
</div>
547-
</div>
548544
<p>The overall maximum size of your <code>prog.c</code> program source <strong>MUST NOT</strong>
549545
exceed <strong>4993</strong> bytes.</p>
550546
<p>See <a href="../quick-start.html#enter">Entering the IOCCC: the bare minimum you need to know</a>.</p>
551547
<div id="rule2b">
552548
<div id="rule2b-net-size">
553-
<div id="rule-2b-net-size">
554549
<h3 id="rule-2b---net-size">Rule 2b - Net Size</h3>
555550
</div>
556551
</div>
557-
</div>
558552
<p>When the filename of your program source (i.e., <code>prog.c</code>) is given as a
559553
command line argument to the latest version of the official IOCCC size
560554
tool (hereby referred to as <code>iocccsize(1)</code>), the value printed <strong>MUST
@@ -678,7 +672,7 @@ <h2 id="rule-6---free-rule">Rule 6 - Free Rule</h2>
678672
<pre><code> while (!(ioccc(rule(you(are(number(6)))))) {
679673
ha(); ha(); ha();
680674
}</code></pre>
681-
<p>See <a href="rules.html#rule-19---prime">Rule 19 - Prime</a>.</p>
675+
<p>See <a href="rules.html#rule19-prime">Rule 19 - Prime</a>.</p>
682676
<div id="rule7">
683677
<div id="rule7-original-work">
684678
<h2 id="rule-7---original-work">Rule 7 - Original Work</h2>
@@ -722,8 +716,10 @@ <h2 id="rule-8---submitting-requirements">Rule 8 - Submitting requirements</h2>
722716
<a href="rules.html#rule17-mkiocccentry">Rule 17 - Use mkiocccentry</a>.</p>
723717
<p>See <a href="guidelines.html#guideline8-submitting">Guidelines for Rule 8 - Submitting requirements</a>.</p>
724718
<div id="rule9">
719+
<div id="rule9-no-interactive">
725720
<h2 id="rule-9---no-interactive-compiling-allowed">Rule 9 - No interactive compiling allowed</h2>
726721
</div>
722+
</div>
727723
<p>Entries requiring human interaction to be initially compiled are <strong>NOT</strong>
728724
permitted. However, see the guidelines. Each entry <strong>MUST</strong> automate the
729725
build process using <code>bash</code>, <code>gmake</code>, <code>gcc</code> and/or <code>clang</code> and other commonly
@@ -784,8 +780,10 @@ <h2 id="rule-12---utf-8">Rule 12 - UTF-8</h2>
784780
IOCCC.</p>
785781
<p>See <a href="guidelines.html#guideline12-utf8">Guidelines for Rule 12 - UTF-8</a>.</p>
786782
<div id="rule13">
783+
<div id="rule13-nocr">
787784
<h2 id="rule-13---no-carriage-returns-in-prog.c">Rule 13 - No carriage returns in prog.c</h2>
788785
</div>
786+
</div>
789787
<p>Any C source that fails to compile because lines contain carriage-returns
790788
(CTRL+M, <code>\r</code>) in particular as part of DOS/Windows style newlines might
791789
be rejected. Please do <strong>NOT</strong> put trailing CTRL+M in <code>prog.c</code>, <code>Makefile</code>,
@@ -925,10 +923,12 @@ <h2 id="rule-18---submission-license">Rule 18 - Submission license</h2>
925923
</div>
926924
<p>The entirety of your submission <strong>MUST</strong> be submitted under the following license:</p>
927925
<p><a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0 DEED Attribution-ShareAlike 4.0 International</a></p>
928-
<p>See <a href="rules.html#rule-7---original-work">Rule 7 - Original Work</a>.</p>
926+
<p>See <a href="rules.html#rule7-original-work">Rule 7 - Original Work</a>.</p>
929927
<div id="rule19">
928+
<div id="rule19-prime">
930929
<h2 id="rule-19---prime">Rule 19 - Prime</h2>
931930
</div>
931+
</div>
932932
<p class="leftbar">
933933
This 19th rule, while prime, is reserved for future abuse 😁.
934934
Additional rules, both humorous and otherwise, may be added

next/rules.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -103,12 +103,10 @@ See the [Guidelines for Rule 1 - C program](guidelines.html#guideline1-c).
103103
<div id="rule2">
104104
<div id="rule2-size-restrictions">
105105
<div id="rule2-size">
106-
<div id="rule-2---size">
107106
## Rule 2 - Size restrictions
108107
</div>
109108
</div>
110109
</div>
111-
</div>
112110

113111
`Rule 2` requires that your submission satisfy **BOTH**
114112
[Rule 2a &lpar;Gross Size&rpar;](rules.html#rule2a)
@@ -125,11 +123,9 @@ See the [Guidelines for Rule 2 - Size restrictions](guidelines.html#guideline2-s
125123

126124
<div id="rule2a">
127125
<div id="rule2a-gross-size">
128-
<div id="rule-2a-gross-size">
129126
### Rule 2a - Gross Size
130127
</div>
131128
</div>
132-
</div>
133129

134130
The overall maximum size of your `prog.c` program source **MUST NOT**
135131
exceed **4993** bytes.
@@ -139,11 +135,9 @@ See [Entering the IOCCC: the bare minimum you need to know](../quick-start.html#
139135

140136
<div id="rule2b">
141137
<div id="rule2b-net-size">
142-
<div id="rule-2b-net-size">
143138
### Rule 2b - Net Size
144139
</div>
145140
</div>
146-
</div>
147141

148142
When the filename of your program source (i.e., `prog.c`) is given as a
149143
command line argument to the latest version of the official IOCCC size
@@ -312,7 +306,7 @@ I am **NOT** a Rule, I am a `free(void *human);` ‼️
312306
ha(); ha(); ha();
313307
}
314308
```
315-
See [Rule 19 - Prime](rules.html#rule-19---prime).
309+
See [Rule 19 - Prime](rules.html#rule19-prime).
316310

317311

318312
<div id="rule7">
@@ -370,8 +364,10 @@ See [Guidelines for Rule 8 - Submitting requirements](guidelines.html#guideline8
370364

371365

372366
<div id="rule9">
367+
<div id="rule9-no-interactive">
373368
## Rule 9 - No interactive compiling allowed
374369
</div>
370+
</div>
375371

376372
Entries requiring human interaction to be initially compiled are **NOT**
377373
permitted. However, see the guidelines. Each entry **MUST** automate the
@@ -456,8 +452,10 @@ See [Guidelines for Rule 12 - UTF-8](guidelines.html#guideline12-utf8).
456452

457453

458454
<div id="rule13">
455+
<div id="rule13-nocr">
459456
## Rule 13 - No carriage returns in prog.c
460457
</div>
458+
</div>
461459

462460
Any C source that fails to compile because lines contain carriage-returns
463461
(CTRL+M, `\r`) in particular as part of DOS/Windows style newlines might
@@ -648,12 +646,14 @@ The entirety of your submission **MUST** be submitted under the following licens
648646

649647
[CC BY-SA 4.0 DEED Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/)
650648

651-
See [Rule 7 - Original Work](rules.html#rule-7---original-work).
649+
See [Rule 7 - Original Work](rules.html#rule7-original-work).
652650

653651

654652
<div id="rule19">
653+
<div id="rule19-prime">
655654
## Rule 19 - Prime
656655
</div>
656+
</div>
657657

658658
<p class="leftbar">
659659
This 19th rule, while prime, is reserved for future abuse 😁.

0 commit comments

Comments
 (0)