fix and improve links within the web site

Entry source is now prog.c for IOCCC years 2014 thru 2020,
or is now dirname.c IOCCC years 1984 thru 2013.

To achieve this state, we renamed the following:

renamed:    2004/hibachi/src/hibachi.c -> 2004/hibachi/hibachi.c
renamed:    2012/omoikane/nyaruko.alt.c -> 2012/omoikane/omoikane.alt.c
renamed:    2012/omoikane/nyaruko.alt2.c -> 2012/omoikane/omoikane.alt2.c
renamed:    2012/omoikane/nyaruko.c -> 2012/omoikane/omoikane.c
renamed:    2012/omoikane/nyaruko.orig.c -> 2012/omoikane/omoikane.orig.c

Modified `bin/subst.entry-index.sh` to add to entry `index.html` file,
links to the `Makefile` and the _C code_ to the top navigation bar.
Changed `bin/subst.entry-index.sh` VERSION from "1.2.2 2024-02-25"
to "1.3 2024-03-02".

Moved printing the Inventory link in the top navigation bar
from `bin/subst.entry-navbar.awk` to `bin/subst.entry-index.sh`.
Changed `bin/subst.entry-navbar.awk` VERSION from "1.0.1 2024-02-23"
to "1.1 2024-03-02".

Moved printing the Inventory link in the top navigation bar
from `bin/subst.year-navbar.awk` to `bin/subst.year-index.sh`.
Changed `bin/subst.year-index.sh` VERSION from "1.0 2024-02-11"
to "1.1 2024-03-02".
Changed `bin/subst.year-navbar.awk` VERSION from "1.0 2024-02-11"
to "1.1 2024-03-02".

Added location names (both default and common) to `author.html`.
Changed `tmp/gen_author_json.sh` VERSION from "1.0 2023-06-06"
to "1.1 2024-03-04".

Added location names (both default and common) to `author.html`.
Changed `bin/gen-authors.sh` VERSION from "1.2 2024-03-09"
to "1.3 2024-03-04".

The manifest and the resulting `.entry.json` files have been changed
for `2004/hibachi` and `2012/omoikane`.

The Makefiles for  `2004/hibachi` and `2012/omoikane` copy the
source file into the "previously used location".  The `make clobber`
rule removes the copied source.  The `.gitignore` files have been
updated accordingly.

Improved how the concept of IOCCC terms _entry_, _author_ and _submission_ are
used in markdown files.

Links to markdown files (files ending in .md) within the repo were
changed to link to HTML files (files ending in .html).  Special cases
where `README.md` became `index.html` were modified accordingly.

Fixed URL for `bugs.html` in Makefile comments.

Fixed name of `bin/sgi.sh` referenced in comments in `.gitignore` files.

Links to locations within the repo are now relative.  For example a
link to `/contact.html` may become `../contact.html' or '../../contact.html`
depending on the directory level of the markdown file.

Nearly all links with absolute URLs under _https://www.ioccc.org_
or `https://ioccc-src.github.io/temp-test-ioccc_ have been changed to
relative paths within the repo.  Some exceptions to this (such as
referring to a GitHub repo) were preserved.

Fixed a number of inside `faq.md` and `bugs.md`.

Added HTML name tags (in the form of an _entry_id_) for each entry
referenced in `bugs.md`.  Fixed links from outside of `bugs.html`
into `bugs.html` accordingly.

Where FAQ entries are referenced, a named tag is used so that if a
FAQ is ever renumbered, links outside of `faq.html` will still work.

Changed the _inventory_order_ of a compressed tarball from _300_
to _100000_.  While this may have been done for the manifest,
this changed had not yet been propagated into the `.entry.json` files.

Links to web sites that were in the for <URL> are now [URL](URL).

Performed `name www` to process all of the above.

Improved format of `authors.html`.  Full names are now bold.
Location codes are now links back into `location.html` and
location names (both default and common) are now italics.
Added _author_handle_ each author.

Changed `bin/gen-authors.sh` VERSION from "1.1 2024-02-25"
to "1.2 2024-03-09".

Improved format of `location.html` as location codes are now bold,
author counts in a given location are now bold, and location names
(both default and common) are now italics.

Changed `bin/gen-location.sh` VERSION from "1.0.1 2024-02-23"
to "1.1 2024-03-04".

Added italic location name after location code in entry
`index.html` files.

Changed `bin/output-index-author.sh` VERSION from "1.4.1 2024-02-23"
to "1.5 2024-03-04".

Added _Location of authors_ to the sidebar as a link to `location.html`.

TODO: While nearly all of the above mentioned changes are likely correct,
      they likely introduced a few errors that need correcting.
This commit is contained in:
Landon Curt Noll committed 2024-03-04 23:45:28 -08:00
1 parent 91c55a20fd
commit 2b92c89be8
1811 files changed
+11313 -9962

No files matched your search

+18 -20
View File
@@ -59,6 +59,7 @@
<a href="./index.html">IOCCC Home</a>
<a href="./years.html">Winning Entries</a>
<a href="./authors.html">People who have won</a>
<a href="./location.html">Location of authors</a>
</div>
<hr>
<div class="sidenav">
@@ -153,8 +154,8 @@ obfuscations.</p>
from <strong>obfuscare</strong> ‘to darken or obscure’ (see
<em>obfuscate</em>).</p></li>
</ul>
<p>The official IOCCC web site is <a href="https://www.ioccc.org"
class="uri">https://www.ioccc.org</a>.</p>
<p>The official IOCCC web site is <a
href="https://www.ioccc.org">www.ioccc.org</a>.</p>
<h2 id="how-it-was-started">How it was started:</h2>
<p>The original inspiration of the International Obfuscated C Code
Contest came from the Bourne Shell source and the <code>finger(1)</code>
@@ -207,7 +208,7 @@ some preprocessing such as:</p>
having things such as includes and macros cluttering up the output. If
the entry requires or suggests the use of compile line options (such as
<code>-Dindex=strchr</code>) they should be added after the
<code>-E</code> flag. See the entry README.md and/or Makefile. For the
<code>-E</code> flag. See the entry index.html and/or Makefile. For the
Makefiles look at the variable <code>CDEFINE</code>.</p>
<p>The next stage towards understanding is to use a C beautifier or C
indenting program on the source. Be warned that a number of these
@@ -231,13 +232,13 @@ required due to differing semantics between operating systems. If you
are able to successfully compile the program, experiment with it by
giving it different arguments or input. You may also use the Makefile
provided to compile the program. Look at the <code>To build</code> and
<code>Try</code> sections at the top of the README.md for each entry as
<code>Try</code> sections at the top of the index.html for each entry as
well. Keep in mind that C compilers often have bugs, or features which
result the program failing to compile. You may have to do some syntax
changing as we did to get old programs to compile on strict ANSI C
compilers.</p>
<p>Last, read the judges’ remarks/spoilers on the program. Hints for
<code>foo.c</code> are given in <code>README.md</code>. Often they will
<code>foo.c</code> are given in <code>index.html</code>. Often they will
contain suggested arguments or recommended data to use. Authors also
sometimes give spoilers.</p>
<p>If you do gain some understanding of how a program works, go back to
@@ -247,15 +248,14 @@ does.</p>
<h2 id="regarding-the-source-archive">Regarding the source archive:</h2>
<p>Each sub-directory contains all the entries for a single year. Often
the file names match one of the last names of the author. Judges’ hints
are given in files of the form <code>README.md</code>.</p>
are given in files of the form <code>index.html</code>.</p>
<p>You may need to tweak the Makefile to get everything to compile
correctly. Read the README.md files for suggestions.</p>
correctly. Read the index.html files for suggestions.</p>
<p>The rules for a given year are given in the file named
<code>rules.txt</code>. Each archive contains a copy of the rules for
the upcoming contest.</p>
<p>The following URL is the official archive of the winning entries: <a
href="https://www.ioccc.org/years.html"
class="uri">https://www.ioccc.org/years.html</a>.</p>
<p>The <a href="years.html">years.html</a> web page the official archive
of the winning entries.</p>
<h2 id="regarding-the-distribution-of-sources">Regarding the
distribution of sources:</h2>
<p>All contest results are in the public domain. We do ask that you
@@ -264,9 +264,8 @@ observe the following request:</p>
of doing the same. If some of these files and/or contest entries are
published in printed form, or if you use them in a business or classroom
setting, please let us know. We ask that you drop a line to the judges’
email box. See <a href="https://www.ioccc.org/contact.html"
class="uri">https://www.ioccc.org/contact.html</a> for instructions on
how to send us a message.</p>
email box. See <a href="contact.html">contact.html</a> for instructions
on how to send us a message.</p>
<h2 id="some-final-things-to-remember">Some final things to
remember:</h2>
<p>While the idea for the contests has remained the same through the
@@ -290,9 +289,8 @@ of C compilers are used. See the contest rules for details.</p>
sending any entries. The rules, and sometimes the contest email address
itself, change from time to time. A valid entry one year may be rejected
in a later year due to changes in the rules. See <a
href="https://www.ioccc.org/index.html#enter"
class="uri">https://www.ioccc.org/index.html#enter</a> for up to date
information on how to enter.</p>
href="news.html">news.html</a> for up to date information on how to
enter.</p>
<p>Last, PLEASE don’t code in the style of these programs It is hoped
that you will gain an understanding that poor style destroys an
otherwise correct program. Real programmers don’t write obfuscated
@@ -305,18 +303,18 @@ entries GitHub repository</a> are the official entries that won the
<strong>International Obfuscated C Code Contest (IOCCC)</strong>, the
Internet’s oldest ongoing contest.</p>
<p><strong>IMPORTANT NOTE</strong>: See <a
href="/contact.html">contact.html</a> for up to date contact details as
href="contact.html">contact.html</a> for up to date contact details as
well as details on how to provide fixes to any of the entries. See also
<a href="/faq.html">the IOCCC FAQ</a> for addition information on the
<a href="faq.html">the IOCCC FAQ</a> for addition information on the
IOCCC.</p>
<h1 id="copyright-and-license">Copyright and License</h1>
<p>Copyright (C) 2020,2023,2024 Landon Curt Noll. All Rights Reserved.
This work is licensed under a <a
href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons
CC BY-SA 4.0 DEED Attribution-ShareAlike 4.0 International</a> license.
If you do use this work in some form, the <a href="/judges.html">IOCCC
If you do use this work in some form, the <a href="judges.html">IOCCC
judges</a> would appreciate (but do not require) if you were to <a
href="/contact.html">send us a note about your use</a>.</p>
href="contact.html">send us a note about your use</a>.</p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content from: inc/after-content.default.html -->