mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cbbf6dbf7af1bf4e4988aa26997f0728c868f2bb
ioccc/tmp/entry_dir.txt
T
Landon Curt Noll aedb017223 improve markdown to HTML tools, build location.html, authors.html, years.html 
Renamed `.winner.json` to `.entry.json` as per recent decisions made for issue #2156.

JSON element _winner_JSON_format_version_ renamed to _entry_JSON_format_version_
in `.winner.json`.

Changed _entry_JSON_format_version_ from "1.0 2024-01-14" to "1.1 2024-02-11".

JSON element _winner_id_ renamed to _entry_id_ in `.entry.json`
JSON element _winner_text renamed to _entry_text_ in `.entry.json`
JSON element _winner_id_ renamed to _entry_id_ in `author/author_handle.json` files.

Changed _author_JSON_format_version_ from "1.0 2023-06-10" to "1.1 2024-02-11".

Renamed `tmp/gen_winner_json.sh` to `tmp/gen_entry_json.sh`.

Renamed `tmp/example.dot_winner.json` to `tmp/example.dot_entry.json`.

Renamed `tmp/winner_id.txt` to `tmp/entry_id.txt`.

Renamed `tmp/winner_dir.txt` to `tmp/entry_dir.txt`.

Moved outdated `tmp/awards_check.sh` into `tmp/OLD_manifest/awards_check.sh`.
Moved outdated `tmp/awards_check.sh` into `tmp/OLD_manifest/awards_check.sh`.
Moved outdated `tmp/src/winner_name` into `tmp/OLD_manifest/winner_name`.
Moved outdated `tmp/sql` into `tmp/OLD_manifest/sql`.
Moved outdated `tmp/template-footer.html` into `tmp/OLD_manifest/template-footer.html`.
Moved outdated `tmp/template-header.html` into `tmp/OLD_manifest/template-header.html`.
Moved outdated `tmp/template-top.html` into `tmp/OLD_manifest/template-top.html`.
Moved outdated `tmp/test.html` into `tmp/OLD_manifest/test.html`.
Moved outdated `tmp/fake.gen_index.sh` into `tmp/OLD_manifest/fake.gen_index.sh`.
Moved outdated `tmp/old-ioccc.css` into `tmp/OLD_manifest/old-ioccc.css`.

Removed winner_name from `tmp/src/Makefile`.

Updated `tmp/example.dot_entry.json` to reflect the above JSON changes.

Updated `tmp/manifest.numbers` to reflect the above JSON changes.

Updated `tmp/README.md` to reflect the above JSON changes.
Sorted `tmp/README.md` by existing `tmp` filenames.

Updated all `.entry.json` files to reflect the above JSON changes.

Updated all `author/author_handle.json` files to reflect the above JSON changes.

Added new tool `bin/gen-location.sh` to form the top level file `location.html`
from `author/author_handle.json` files!

Added new tool `bin/gen-years.sh` to form the top level file `years.html`
using `.top`, `.year` and `.entry.json' files!

Added new tool `bin/gen-authors.sh` to form a new top level file
`/authors.html` from `author/author_handle.json` and related
`.entry.json' files!

The old `winners.html` file now redirects to the new `authors.html` file.

Renamed `bin/gen-author.sh` to `bin/output-index-author.sh`.
Renamed `bin/subst.winner-index.sh` to `subst.entry-index.sh`.
Renamed `bin/subst.winner-index.awk` to `subst.entry-index.awk`.
Renamed `bin/manifest.entry.json.awk` to `bin/manifest.entry.json.awk`.
Renamed `bin/gen-inventory.sh` to `bin/output-index-inventory.sh`.
Renamed `bin/sort.gitignore` to `bin/sort.gitignore.sh`.
Renamed `bin/sgi` to `bin/sgi.sh`.

The core logic of converting markdown to HTML has been
generalized into a new `bin/md2html.sh` tool.

The `bin/readme2index.sh` tool now calls the
new `bin/md2html.sh` tool to form entry's `index.html` files.

The `bin/quick-readme2index.sh` tool now calls the new `bin/md2html.sh`
tool, unless the `index.html` is newer than both `.entry.json` and
`README.md`, to form entry `index.html` files.

Increased, slightly, the speed of the `bin/quick-readme2index.sh` tool
with the entry's `index.html` file does not need to be updated.

The `bin/quick-readme2index.sh` tool will touch the `index.html` file,
even if the `bin/md2html.sh` tool determines that the `index.html` file
did not change, so that the `index.html` file will not appear
out of date with respect to `.entry.json`.

Slightly improved the look and feel of `index.html` files for entries.

The logic of `bin/all-run.sh` has been improved.  The initial
processing, from first bash version check, thru the -N test, serves
as the model for the `bin/readme2index.sh` tool and the
`bin/quick-readme2index.sh` tool.  There tools now share
a common set of command line options.

Changed the format of `inc/md2html.cfg` so that for a given "_file_glob_"
match, options follow, one per line.  The "_file_glob_" is on a line
by itself.  The option lines that follow must be intended:

```
[12][0-9][0-9][0-9]/README.md
	-H
	topnav=year
	-o
	bin/subst.default.sh
	-o
	bin/subst.year.sh
```

Added "-D ./" to top level markdown files in `inc/md2html.cfg`.

The above intending is performed with 1 or more whitespace
characters, although we use a leading tab "convention"
out of deference to Makefile formats. :-)

Once a new "_file_glob_" is found, the set of any previous
option lines is said to have ended.

The general argument processing logic now makes used of shell arrays.

Added checks in the `bin/md2html.sh` tool to disallow a "_file_glob_"
of . (dot) as this is used internally to help the shell process the
new `inc/md2html.cfg` format.

Changed `bin/all-run.sh` VERSION from "1.1.2 2024-01-20"
to "1.3 2024-02-11".

Changed `bin/output-index-author.sh` VERSION from "1.3.1 2024-01-16"
to "1.4 2024-02-11".

Changed `bin/pandoc-wrapper.sh` VERSION from "1.3.2 2024-01-19"
to "1.4 2024-02-05".

Changed `bin/quick-readme2index.sh` VERSION from "1.0 2024-01-20"
to "1.1 2024-02-11".

Changed `bin/readme2index.sh` VERSION from "1.1.1 2024-01-20"
to "1.2 2024-02-11".

Changed `bin/subst.default.sh` VERSION from "1.1.1 2024-01-16"
to "1.2 2024-02-05".

Changed `bin/subst.entry-index.sh` VERSION from "1.1.1 2024-01-16
to "1.2 2024-02-11".

Changed `bin/output-index-inventory.sh` VERSION from "1.0.1 2024-01-16"
to "1.1 2024-02-11".

Changed `bin/manifest.entry.json.awk` from "1.0 2024-01-14"
to "1.1 2024-02-11".

Changed `bin/sort.gitignore.sh` from "1.0 2024-02-01"
to "1.1 2024-02-11".

Changed substitution symbol _%%DOCROOT_URL_SLASH%%_ to _%%DOCROOT_SLASH%%_
in various "inc/*.html" files.

Moved setting of symbol _%%DOCROOT_SLASH%%_ from `bin/subst.entry-index.sh`
to `bin/subst.default.sh`.

Changed the variable _$DOCROOT_URL_SLASH_ to _$DOCROOT_SLASH_, in
bin tools that use it, to be more descriptive.

Removed `-P pandoc_opts` from `bin/*.sh` command lines.
The PANDOC_WRAPPER_OPTSTR value is only used in `bin/pandoc-wrapper.sh`.

Removed `-B optstr` and `-A optstr` from the `bin/md2html.sh` command line.

Removed `[-O tool=optstr ..]` from the `bin/md2html.sh` command line.

Removed old use of `-U top_url` from command lines.
Add `-w site_url` as sort of a "replacement" for the old `-U top_url`.

Added a new `-U URL` to `bin/gen-author.sh`, `bin/output-index-inventory.sh`,
`bin/md2html.sh`, `bin/subst.default.sh`, and `bin/subst.entry-index.sh`
to allow for the Nu HTML check can use the encoded absolute URL of
the HTML page.

Added `-t tagline` to most command lines.

Added `-T md2html.sh` to most command lines.

Added `-D docroot/` to most command lines to set DOCROOT_SLASH.
The DOCROOT_SLASH value defaults to "../../" for most in tools,
suitable for HTML files under a `YYYY/dir` directory, except for
`bin/gen-location.sh` and `gen-entries-html.sh` (as this produces a
top level HTML file) and `bin/md2html.sh` (forms files at any level)
who use "./" instead.

In the case of `bin/output-index-inventory.sh`, `bin/quick-readme2index.sh`,
`bin/readme2index.sh`, and `bin/all-run.sh`

Helped make the use of exit code in bin tools a bit more consistent.

Fixed a number of typos in the bin tools.

Added comments for lower level tools such as
`manifest.entry.json.awk`, `bin/subst.default.sh`,
`bin/subst.entry-index.sh`, and bin/`manifest.entry.json.awk` to
indicate how they are usually invoked by other tools.

Changed the comments that a new `bin/md2html.sh` tool (that was the
`bin/readme2index.sh` tool) would add to a entry's `index.html` file.
No longer will it add the tool version number to the comment.  Thus,
a change in tool version will not force all entry `index.html`
files to be modified.  Now both the tool adds two comments, one
is the _tagline_ to indicate how the markdown content was generated,
and one for the new `bin/md2html.sh` tool.  For example:

```
<!-- The original markdown content was formed by the tool: bin/quick-readme2index.sh -->
<!-- The HTML was converted from markdown by the tool: bin/md2html.sh -->
```

Improve the debugging, especially in regards to changing important
exported shell variables, in `bin/md2html.sh`.  Other bin tools
have their exported shell variables improved somewhat as well.

The `bin/README.md` now describes the general _converting markdown
to HTML_ procedure including _getopt phases_ and _HTML phases_.
Content from `inc/md2html.cfg` and `bin/readme2index.sh` that related
to this topic has been centralized into the `bin/README.md` file.

Improved formatting of the `bin/README.md` file.  Updated it as needed
according to the above.

Sorted `2011/.year`, `2018/.year`, and `2019/.year` to be in dictionary order.
Adjusted ${WINNERS} in year Makefile to use dictionary order so
that `make genpath` will produce `.year` files in dictionary order.

FYI: We tested this massive set of changes as best as we could.
     Nevertheless we might have missing something in the JSON changes,
     `.entry.json` renames, manifest updates, code comments, etc.
2024-02-11 16:00:31 -08:00

322 lines
3.8 KiB
Plaintext
Raw Blame History

1984/anonymous
1984/decot
1984/laman
1984/mullender
1985/applin
1985/august
1985/lycklama
1985/shapiro
1985/sicherman
1986/applin
1986/august
1986/bright
1986/hague
1986/holloway
1986/marshall
1986/pawka
1986/stein
1986/wall
1987/biggar
1987/heckbert
1987/hines
1987/korn
1987/lievaart
1987/wall
1987/westley
1988/applin
1988/dale
1988/isaak
1988/litmaath
1988/phillipps
1988/reddy
1988/robison
1988/spinellis
1988/westley
1989/fubar
1989/jar.1
1989/jar.2
1989/ovdluhe
1989/paul
1989/robison
1989/roemer
1989/tromp
1989/vanb
1989/westley
1990/baruch
1990/cmills
1990/dds
1990/dg
1990/jaw
1990/pjr
1990/scjones
1990/stig
1990/tbr
1990/theorem
1990/westley
1991/ant
1991/brnstnd
1991/buzzard
1991/cdupont
1991/davidguy
1991/dds
1991/fine
1991/rince
1991/westley
1992/adrian
1992/albert
1992/ant
1992/buzzard.1
1992/buzzard.2
1992/gson
1992/imc
1992/kivinen
1992/lush
1992/marangon
1992/nathan
1992/vern
1992/westley
1993/ant
1993/cmills
1993/dgibson
1993/ejb
1993/jonth
1993/leo
1993/lmfjyh
1993/plummer
1993/rince
1993/schnitzi
1993/vanb
1994/dodsond1
1994/dodsond2
1994/horton
1994/imc
1994/ldb
1994/schnitzi
1994/shapiro
1994/smr
1994/tvr
1994/weisberg
1994/westley
1995/cdua
1995/dodsond1
1995/dodsond2
1995/esde
1995/garry
1995/heathbar
1995/leo
1995/makarios
1995/savastio
1995/schnitzi
1995/spinellis
1995/vanschnitz
1996/august
1996/dalbec
1996/eldby
1996/gandalf
1996/huffman
1996/jonth
1996/rcm
1996/schweikh1
1996/schweikh2
1996/schweikh3
1996/westley
1998/banks
1998/bas1
1998/bas2
1998/chaos
1998/df
1998/dlowe
1998/dloweneil
1998/dorssel
1998/fanf
1998/schnitzi
1998/schweikh1
1998/schweikh2
1998/schweikh3
1998/tomtorfs
2000/anderson
2000/bellard
2000/bmeyer
2000/briddlebane
2000/dhyang
2000/dlowe
2000/jarijyrki
2000/natori
2000/primenum
2000/rince
2000/robison
2000/schneiderwent
2000/thadgavin
2000/tomx
2001/anonymous
2001/bellard
2001/cheong
2001/coupard
2001/ctk
2001/dgbeards
2001/herrmann1
2001/herrmann2
2001/jason
2001/kev
2001/ollinger
2001/rosten
2001/schweikh
2001/westley
2001/williams
2004/anonymous
2004/arachnid
2004/burley
2004/gavare
2004/gavin
2004/hibachi
2004/hoyle
2004/jdalbec
2004/kopczynski
2004/newbern
2004/omoikane
2004/schnitzi
2004/sds
2004/vik1
2004/vik2
2005/aidan
2005/anon
2005/boutines
2005/chia
2005/giljade
2005/jetro
2005/klausler
2005/mikeash
2005/mynx
2005/persano
2005/sykes
2005/timwi
2005/toledo
2005/vik
2005/vince
2006/birken
2006/borsanyi
2006/grothe
2006/hamre
2006/meyer
2006/monge
2006/night
2006/sloane
2006/stewart
2006/sykes1
2006/sykes2
2006/toledo1
2006/toledo2
2006/toledo3
2011/akari
2011/blakely
2011/borsanyi
2011/dlowe
2011/eastman
2011/fredriksson
2011/goren
2011/hamaji
2011/hou
2011/konno
2011/richards
2011/toledo
2011/vik
2011/zucker
2012/blakely
2012/deckmyn
2012/dlowe
2012/endoh1
2012/endoh2
2012/grothe
2012/hamano
2012/hou
2012/kang
2012/konno
2012/omoikane
2012/tromp
2012/vik
2012/zeitak
2013/birken
2013/cable1
2013/cable2
2013/cable3
2013/dlowe
2013/endoh1
2013/endoh2
2013/endoh3
2013/endoh4
2013/hou
2013/mills
2013/misaka
2013/morgan1
2013/morgan2
2013/robison
2014/birken
2014/deak
2014/endoh1
2014/endoh2
2014/maffiodo1
2014/maffiodo2
2014/morgan
2014/sinon
2014/skeggs
2014/vik
2014/wiedijk
2015/burton
2015/dogon
2015/duble
2015/endoh1
2015/endoh2
2015/endoh3
2015/endoh4
2015/hou
2015/howe
2015/mills1
2015/mills2
2015/muth
2015/schweikhardt
2015/yang
2018/algmyr
2018/anderson
2018/bellard
2018/burton1
2018/burton2
2018/ciura
2018/endoh1
2018/endoh2
2018/ferguson
2018/giles
2018/hou
2018/mills
2018/poikola
2018/vokes
2018/yang
2019/adamovsky
2019/burton
2019/ciura
2019/diels-grabsch1
2019/diels-grabsch2
2019/dogon
2019/duble
2019/endoh
2019/giles
2019/karns
2019/lynn
2019/mills
2019/poikola
2019/yang
2020/burton
2020/carlini
2020/endoh1
2020/endoh2
2020/endoh3
2020/ferguson1
2020/ferguson2
2020/giles
2020/kurdyukov1
2020/kurdyukov2
2020/kurdyukov3
2020/kurdyukov4
2020/otterness
2020/tsoj
2020/yang
Reference in new issue View Git Blame Copy Permalink