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

+13 -14
View File
@@ -43,7 +43,7 @@ mealy-mouthed denials and obfuscations.
late Middle English: from late Latin **obfuscatio(n-)**, from **obfuscare**
'to darken or obscure' (see *obfuscate*).
The official IOCCC web site is <https://www.ioccc.org>.
The official IOCCC web site is [www.ioccc.org](https://www.ioccc.org).
## How it was started:
@@ -99,7 +99,7 @@ sed -e '/^#.*include/d' prog.c | cc -E
This strips away comments and expands the program's macros without 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 `-Dindex=strchr`) they should
be added after the `-E` flag. See the entry README.md and/or Makefile. For the
be added after the `-E` flag. See the entry index.html and/or Makefile. For the
Makefiles look at the variable `CDEFINE`.
The next stage towards understanding is to use a C beautifier or C indenting
@@ -124,13 +124,13 @@ compiler) or edit may be 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 `To build` and `Try` sections at
the top of the README.md for each entry as well. Keep in mind that C compilers
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.
Last, read the judges' remarks/spoilers on the program. Hints for `foo.c` are
given in `README.md`. Often they will contain suggested arguments or
given in `index.html`. Often they will contain suggested arguments or
recommended data to use. Authors also sometimes give spoilers.
If you do gain some understanding of how a program works, go back to the source
@@ -142,16 +142,15 @@ convince yourself of why the program does what it does.
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 `README.md`.
files of the form `index.html`.
You may need to tweak the Makefile to get everything to compile correctly. Read
the README.md files for suggestions.
the index.html files for suggestions.
The rules for a given year are given in the file named `rules.txt`. Each
archive contains a copy of the rules for the upcoming contest.
The following URL is the official archive of the winning entries:
<https://www.ioccc.org/years.html>.
The [years.html](years.html) web page the official archive of the winning entries.
## Regarding the distribution of sources:
@@ -163,7 +162,7 @@ You may share these files with others, but please do not prevent them 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 <https://www.ioccc.org/contact.html> for instructions on
judges' email box. See [contact.html](contact.html) for instructions on
how to send us a message.
@@ -189,7 +188,7 @@ details.
You are strongly encouraged to read the new contest rules before 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 <https://www.ioccc.org/index.html#enter> for up to
changes in the rules. See [news.html](news.html) for up to
date information on how to enter.
Last, PLEASE don't code in the style of these programs It is hoped that you will
@@ -206,9 +205,9 @@ The [official IOCCC entries GitHub repository](https://github.com/ioccc-src/winn
official entries that won the **International Obfuscated C Code Contest (IOCCC)**, the
Internet's oldest ongoing contest.
**IMPORTANT NOTE**: See [contact.html](/contact.html) for up to date contact details
**IMPORTANT NOTE**: See [contact.html](contact.html) for up to date contact details
as well as details on how to provide fixes to any of the entries.
See also [the IOCCC FAQ](/faq.html) for addition information on the IOCCC.
See also [the IOCCC FAQ](faq.html) for addition information on the IOCCC.
# Copyright and License
@@ -216,5 +215,5 @@ See also [the IOCCC FAQ](/faq.html) for addition information on the IOCCC.
Copyright (C) 2020,2023,2024 Landon Curt Noll. All Rights Reserved.
This work is licensed under a [Creative Commons CC BY-SA 4.0 DEED Attribution-ShareAlike
4.0 International](https://creativecommons.org/licenses/by-sa/4.0/) license.
If you do use this work in some form, the [IOCCC judges](/judges.html) would appreciate
(but do not require) if you were to [send us a note about your use](/contact.html).
If you do use this work in some form, the [IOCCC judges](judges.html) would appreciate
(but do not require) if you were to [send us a note about your use](contact.html).