From fb43b1dfefeb1c5ffb9fb1aae5bad2c01e3018b1 Mon Sep 17 00:00:00 2001
From: Landon Curt Noll
Date: Thu, 29 Feb 2024 00:16:05 -0800
Subject: [PATCH] rename bin/gen-top-html.sh, added archive/historic/index.html
We rename `bin/gen-top-md2html.sh` to `bin/gen-top-html.sh`.
Modified the `bin/gen-top-html.sh` tool to build `archive/historic/index.html`
from `archive/historic/README.md`.
In `bin/gen-top-html.sh` changed VERSION from "1.1 2024-02-28"
to "1.2 2024-02-29".
Renamed `make gen_top_md2html` to `gen_top_html` in the top level `Makefile`.
Improved `archive/historic/README.md`.
Updated `robots.txt` to include the Sitemap directive.
Moved unused `valid-html401.png` to `png/valid-html401.png`.
This png image may be used later.
Performed `make gen_top_html` which rebuilt all top level HTML files
as well as `bin/index.html` and `inc/index.html`.
---
CODE_OF_CONDUCT.html | 2 +-
Makefile | 14 +-
README.html | 2 +-
archive/historic/README.md | 49 ++++-
archive/historic/index.html | 221 ++++++++++++++++++++
bin/README.md | 4 +-
bin/{gen-top-md2html.sh => gen-top-html.sh} | 11 +-
bin/index.html | 8 +-
bugs.html | 2 +-
contact.html | 2 +-
faq.html | 2 +-
inc/index.html | 2 +-
inc/md2html.cfg | 16 ++
index.html | 2 +-
judges.html | 2 +-
news.html | 2 +-
valid-html401.png => png/valid-html401.png | Bin
robots.txt | 2 +
thanks-for-help.html | 2 +-
19 files changed, 319 insertions(+), 26 deletions(-)
create mode 100644 archive/historic/index.html
rename bin/{gen-top-md2html.sh => gen-top-html.sh} (96%)
rename valid-html401.png => png/valid-html401.png (100%)
diff --git a/CODE_OF_CONDUCT.html b/CODE_OF_CONDUCT.html
index 5378df855..e4d4f139b 100644
--- a/CODE_OF_CONDUCT.html
+++ b/CODE_OF_CONDUCT.html
@@ -10,7 +10,7 @@
-
+
diff --git a/Makefile b/Makefile
index 0725fb786..b2968b6f0 100644
--- a/Makefile
+++ b/Makefile
@@ -54,7 +54,7 @@ GEN_LOCATION= bin/gen-location.sh
GEN_YEARS= bin/gen-years.sh
GEN_YEAR_INDEX= bin/gen-year-index.sh
CHK_ENTRY= bin/chk-entry.sh
-GEN_TOP_MD2HTML= bin/gen-top-md2html.sh
+GEN_TOP_HTML= bin/gen-top-html.sh
GEN_OTHER_HTML= bin/gen-other-html.sh
README2INDEX= bin/readme2index.sh
QUICK_README2INDEX= bin/quick-readme2index.sh
@@ -240,7 +240,7 @@ indent.c:
# They might not even work (right now). :-)
.PHONY: help genpath genfilelist verify_entry_files gen_authors gen_location gen_years \
- entry_index gen_top_md2html gen_other_html quick_entry_index \
+ entry_index gen_top_html gen_other_html quick_entry_index \
form_entry_tarball form_year_tarball form_all_tarball \
gen_year_index quick_www www tar
@@ -258,7 +258,7 @@ help:
@echo make gen_location
@echo make gen_years
@echo make entry_index
- @echo make gen_top_md2html
+ @echo make gen_top_html
@echo make gen_other_html
@echo make gen_year_index
@echo make quick_entry_index
@@ -352,9 +352,9 @@ entry_index readme2index: ${ALL_RUN} ${README2INDEX}
# generate a number of the top level HTML files from top level markdown files
#
-gen_top_md2html: ${GEN_TOP_MD2HTML}
+gen_top_html: ${GEN_TOP_HTML}
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
- ${GEN_TOP_MD2HTML} -v 1
+ ${GEN_TOP_HTML} -v 1
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
# generate build entry HTML files from markdown other than README.md to index.html HTML files
@@ -435,7 +435,7 @@ quick_www:
${MAKE} gen_location
${MAKE} gen_years
${MAKE} gen_year_index
- ${MAKE} gen_top_md2html
+ ${MAKE} gen_top_html
${MAKE} gen_other_html
${MAKE} quick_entry_index
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
@@ -454,7 +454,7 @@ www:
${MAKE} gen_location
${MAKE} gen_years
${MAKE} gen_year_index
- ${MAKE} gen_top_md2html
+ ${MAKE} gen_top_html
${MAKE} gen_other_html
${MAKE} entry_index
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
diff --git a/README.html b/README.html
index d2543ad99..9b3b6b4da 100644
--- a/README.html
+++ b/README.html
@@ -10,7 +10,7 @@
-
+
diff --git a/archive/historic/README.md b/archive/historic/README.md
index 6a1e471d9..f705f2e25 100644
--- a/archive/historic/README.md
+++ b/archive/historic/README.md
@@ -1,4 +1,48 @@
-# archive IOCCC winning source
+# Historic archive of IOCCC winning entries
+
+
+## Historic archives as bz2 compressed tarballs
+
+**WARNING:** These historic archives contain lots of code that will no longer compile,
+contains lots of typos, has broken links, has missing files, and contains many programs that will not
+run in modern systems.
+
+These archives provided for historic purposes and are
+**NOT RECOMMENDED** for casual viewing.
+
+**Instead of using these archives, you should use the code from the** [Winning Entries](../../years.html) and related links.
+
+* [archive-all.tar.bz2](archive-all.tar.bz2)
+* [archive-1984.tar.bz2](archive-1984.tar.bz2)
+* [archive-1985.tar.bz2](archive-1985.tar.bz2)
+* [archive-1986.tar.bz2](archive-1986.tar.bz2)
+* [archive-1987.tar.bz2](archive-1987.tar.bz2)
+* [archive-1988.tar.bz2](archive-1988.tar.bz2)
+* [archive-1989.tar.bz2](archive-1989.tar.bz2)
+* [archive-1990.tar.bz2](archive-1990.tar.bz2)
+* [archive-1991.tar.bz2](archive-1991.tar.bz2)
+* [archive-1992.tar.bz2](archive-1992.tar.bz2)
+* [archive-1993.tar.bz2](archive-1993.tar.bz2)
+* [archive-1994.tar.bz2](archive-1994.tar.bz2)
+* [archive-1995.tar.bz2](archive-1995.tar.bz2)
+* [archive-1996.tar.bz2](archive-1996.tar.bz2)
+* [archive-1998.tar.bz2](archive-1998.tar.bz2)
+* [archive-2000.tar.bz2](archive-2000.tar.bz2)
+* [archive-2001.tar.bz2](archive-2001.tar.bz2)
+* [archive-2004.tar.bz2](archive-2004.tar.bz2)
+* [archive-2005.tar.bz2](archive-2005.tar.bz2)
+* [archive-2006.tar.bz2](archive-2006.tar.bz2)
+* [archive-2011.tar.bz2](archive-2011.tar.bz2)
+* [archive-2012.tar.bz2](archive-2012.tar.bz2)
+* [archive-2013.tar.bz2](archive-2013.tar.bz2)
+* [archive-2014.tar.bz2](archive-2014.tar.bz2)
+* [archive-2015.tar.bz2](archive-2015.tar.bz2)
+* [archive-2018.tar.bz2](archive-2018.tar.bz2)
+* [archive-2019.tar.bz2](archive-2019.tar.bz2)
+* [archive-2020.tar.bz2](archive-2020.tar.bz2)
+
+
+## Notes on these archives
These zip2 compressed tarballs were preserved as an archive of the
winning source code that was available on the [official IOCCC web
@@ -30,6 +74,9 @@ tarballs as found in the [Internet Archive Wayback
Machine](https://web.archive.org) as of [2022 Dec
28)(https://web.archive.org/web/20201228005211/https://www.ioccc.org/).
+
+## How to unpack
+
*HINT*: To uncompress a given bzip2 compressed tarball file, use:
```sh
diff --git a/archive/historic/index.html b/archive/historic/index.html
new file mode 100644
index 000000000..96bd17d78
--- /dev/null
+++ b/archive/historic/index.html
@@ -0,0 +1,221 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+The International Obfuscated C Code Contest
+
+
+
+
+
+
+
+
+
+
+
+
+
WARNING: These historic archives contain lots of
+code that will no longer compile, contains lots of typos, has broken
+links, has missing files, and contains many programs that will not run
+in modern systems.
These archives provided for historic
+purposes and are NOT RECOMMENDED for casual viewing.
+
Instead of using these archives, you should use the
+code from theWinning Entries
+and related links.
These zip2 compressed tarballs were preserved as an archive of the
+winning source code that was available on the official IOCCC web site as of 2020 Dec
+28. These zip2 compressed tarballs represent the “released”
+IOCCC winning source, as modified by the IOCCC judges and winning
+authors as of 2020
+Dec 28.
In addition the archive/archive-all.tar.bz2 file has a
+slightly newer version of the 2011 rules and guidelines. as well as a
+newer version of 2012/tromp hint files.
+
For your convenience we keep an archive of the zip2 compressed
+tarballs as found in the Internet
+Archive Wayback Machine as of [2022 Dec
+28)(https://web.archive.org/web/20201228005211/https://www.ioccc.org/).
+
How to unpack
+
HINT: To uncompress a given bzip2 compressed tarball file,
+use:
+
tar-jxvf file.tar.bz2
+
where “file.tar.bz2” is the name of a file found in this
+directory.
+
To uncompress all of the 2022 Dec 28 archive using the year based
+bzip2 compressed tarball files:
+
for year in 198{4,5,6,7,8,9} 199{0,1,2,3,4,5,6,8} 200{0,1,4,5,6} 201{1,2,3,4,5,8,9} 2020;do
+rm-rf"$year"
+tar-jxvf"archive-$year.tar.bz2"
+done
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/bin/README.md b/bin/README.md
index 793f8319d..b111f0d82 100644
--- a/bin/README.md
+++ b/bin/README.md
@@ -102,14 +102,14 @@ bin/gen-other-html.sh -v 1
```
-### [gen-top-md2html.sh](gen-top-md2html.sh)
+### [gen-top-html.sh](gen-top-html.sh)
Generate a number of top level HTML pages for the IOCCC web sites.
Usage:
```sh
-bin/gen-top-md2html.sh -v 1
+bin/gen-top-html.sh -v 1
```
Examples of top level HTML pages built by this tool include:
diff --git a/bin/gen-top-md2html.sh b/bin/gen-top-html.sh
similarity index 96%
rename from bin/gen-top-md2html.sh
rename to bin/gen-top-html.sh
index f36f3fdfd..de3d35763 100755
--- a/bin/gen-top-md2html.sh
+++ b/bin/gen-top-html.sh
@@ -1,8 +1,10 @@
#!/usr/bin/env bash
#
-# gen-top-md2html.sh - generate select top level HTML files from markdown files
+# gen-top-html.sh - generate select top level HTML files from markdown files
#
# We also generate the bin/index.html file from the bin/README.md file.
+# We also generate the inc/index.html file from the inc/README.md file.
+# We also generate the archive/historic/index.html file from the archive/historic/README.md file.
#
# Copyright (c) 2024 by Landon Curt Noll. All Rights Reserved.
#
@@ -52,7 +54,7 @@ TOP_MD_SET+=("faq")
# set variables referenced in the usage message
#
-export VERSION="1.1 2024-02-28"
+export VERSION="1.2 2024-02-29"
NAME=$(basename "$0")
export NAME
export V_FLAG=0
@@ -78,6 +80,7 @@ export SITE_URL="https://ioccc-src.github.io/temp-test-ioccc"
unset TOP_MD_SET
TOP_MD_SET+=("CODE_OF_CONDUCT")
TOP_MD_SET+=("README")
+TOP_MD_SET+=("archive/historic/README")
TOP_MD_SET+=("bin/README")
TOP_MD_SET+=("bugs")
TOP_MD_SET+=("contact")
@@ -445,6 +448,10 @@ for name in "${TOP_MD_SET[@]}"; do
if [[ $name == inc/README ]]; then
HTML_FILE="inc/index.html"
fi
+ # archive/historic/README is a special case
+ if [[ $name == archive/historic/README ]]; then
+ HTML_FILE="archive/historic/index.html"
+ fi
# use the md2html.sh tool to form the HTML file, unless -n
#
diff --git a/bin/index.html b/bin/index.html
index cfd0a2294..a2718eb91 100644
--- a/bin/index.html
+++ b/bin/index.html
@@ -10,7 +10,7 @@
-
+
@@ -150,13 +150,13 @@ href="gen-other-html.sh">gen-other-html.sh
index.html HTML files.