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:
1 parent
91c55a20fd
commit
2b92c89be8
1811 files changed
+11313
-9962
No files matched your search
+18
-20
@@ -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 -->
|
||||
|
||||
Reference in new issue
Block a user