fix links in 1992/buzzard.2/buzzard.2.README.html

The `1992/buzzard.2/buzzard.2.README.md` has been improved
so that links to files that is referenced are
directed to the proper web pages (web site or GitHub).

Links in `1992/buzzard.2/buzzard.2.README.md` markdown
files have been changed to the generated HTML files.

Changed `bin/gen-other-html.sh` VERSION from to "1.0.4 2024-04-13"
to "1.1 2024-04-20".

By default, we substitute _%%REPO_URL%%_ and _%%SITE_URL%%_
in inc files.

Changed `bin/subst.default.sh` VERSION from to "1.2.3 2024-04-13"
to "1.3 2024-04-20".

All `-s TOKEN=value` substitutions are applied to all markdown files
that are processed by `bin/md2html.sh`.

Substitutions of and **%%TOKEN%%** are performed on included HTML
content, content generated by the ‘before tool’ (-b tool), content
generated by the ‘after tool’ (-a tool), as well as the markdown
content given to the pandoc wrapper tool (-p tool).

It is an error, unless -S is given, for any phase, except HTML phases
20-29, to not substitute all **%%TOKEN%%**'s. For HTML phases 20-29, any
**%%TOKEN%%** that is not substituted are passed thru without substitution.

Update `bin/index.html` to clarify

Changed `bin/md2html.sh` VERSION from to "1.4 2024-04-18"
to "1.5 2024-04-20".

Fix the _BEFORE: 1st line of markdown file_ and _AFTER: last line
of markdown file_ HTML comments so that the true markdown file
source (not some temporary file) is identified.  This prevents
`authors.html`, `location.html` and `years.html` from always changing
due to different temporary files being used on each run.

Run `make www` to perform the above.
This commit is contained in:
Landon Curt Noll committed 2024-04-21 00:04:24 -07:00
1 parent 9b55039fd4
commit c1b0d7de48
11 files changed
+274 -226

No files matched your search

+23 -14
View File
@@ -1,14 +1,16 @@
[buzzard.2.README.md](buzzard.2.README.md) this file\
[buzzard.2.design.md](buzzard.2.design.md) description of FIRST (design documentation of THIRD)\
[third](third) implementation of THIRD in FIRST\
[help.th](help.th) online listing of THIRD primitives\
# Useful files to view
- [buzzard.2.README.html](buzzard.2.README.html) - this file
- [buzzard.2.design.html](buzzard.2.design.html) - description of FIRST (design documentation of THIRD)
- [third](%%REPO_URL%%/1992/buzzard.2/third) - implementation of THIRD in FIRST
- [help.th](%%REPO_URL%%/1992/buzzard.2/help.th) - online listing of THIRD primitives
# FIRST demos:
Use `./first < <demo>`.
[demo1.1st](demo1.1st) prints Hello World! assuming ASCII
- [demo1.1st](demo1.1st) - prints Hello World! assuming ASCII
# THIRD demos:
@@ -18,20 +20,27 @@ Use `cat third <demo> | ./first`.
## Demo files:
[demo1.th](demo1.th) prints Hello World! regardless of character set
[demo2.th](demo2.th) demonstrates a simple loop
[demo3.th](demo3.th) demonstrates a simple if test
[demo4.th](demo4.th) recursive factorial calculating on the way up
[demo5.th](demo5.th) recursive factorial calculating on the way down
[demo6.th](demo6.th) demonstrates switching from compiler to execution mode
- [demo1.th](%%REPO_URL%%/1992/buzzard.2/demo1.th) - prints Hello World! regardless of character set
- [demo2.th](%%REPO_URL%%/1992/buzzard.2/demo2.th) - demonstrates a simple loop
- [demo3.th](%%REPO_URL%%/1992/buzzard.2/demo3.th) - demonstrates a simple if test
- [demo4.th](%%REPO_URL%%/1992/buzzard.2/demo4.th) - recursive factorial calculating on the way up
- [demo5.th](%%REPO_URL%%/1992/buzzard.2/demo5.th) - recursive factorial calculating on the way down
- [demo6.th](%%REPO_URL%%/1992/buzzard.2/demo6.th) - demonstrates switching from compiler to execution mode
# Interactive THIRD:
Use `cat third - | ./first`.
Use:
To include the primitive on-line help, use
`cat third help.th - | ./first`.
```
cat third - | ./first
```
To include the primitive on-line help, use:
```
cat third help.th - | ./first
```
<!--