improved indentation and whitespace for markdown code blocks

All code blocks in markdown have been intended by at least 4 spaces.

We add `--tab-stop=8` to all `pandoc(1)` executions in order to set
a better tab stop indentation, especially for tab intended code blocks.

Changed `bin/pandoc-wrapper.sh` VERSION from "1.5.3 2024-03-26"
to "1.6 2024-03-31".

Fixed `1991/brnstnd/sorta.README.md` so that the sorta code
is code blocks.

Removed unneeded paragraph group in copyright in `inc/footer.default.html`.

Fixed excess whitespace after list Author on entry `index.html` page.

Changed `bin/output-index-author.sh` VERSION from "1.5.2 2024-03-26"
to "1.6 2024-03-31".

Performed `make www` to perform the above and test under macOS.

TODO: Fix the problem of the initial line of code being extra intended.
TODO: Fix excess whitespace around code that is inline.
This commit is contained in:
Landon Curt Noll committed 2024-04-01 04:48:48 -07:00
1 parent b84c27ce02
commit a996f8d2b8
734 files changed
+16723 -16963

No files matched your search

+19 -19
View File
@@ -1,7 +1,7 @@
## To build:
```sh
make
make
```
There is an alternate version that will read from the compiled file itself, in
@@ -13,14 +13,14 @@ theoretically work with Windows which distinguishes binary and text. See
## To use:
```sh
./nyaruko [seed.txt] < original.bin > output.c
bash output.c > key.c
perl output.c > data.c
./nyaruko [seed.txt] < original.bin > output.c
bash output.c > key.c
perl output.c > data.c
cat key.c data.c > output.c
cat key.c data.c > output.c
cc output.c -o output
./output > regenerated.bin
cc output.c -o output
./output > regenerated.bin
```
NOTE: if your OS does not have `/dev/urandom` then you should specify a seed
@@ -31,7 +31,7 @@ binary itself.
## Try:
```sh
./try.sh
./try.sh
```
The script [try.sh](try.sh) will check if you have perl before trying to use the
@@ -54,13 +54,13 @@ For the first version:
```sh
make alt
make alt
```
For the second version:
```sh
make alt2
make alt2
```
@@ -74,7 +74,7 @@ Use `nyaruko.alt` or `nyaruko.alt2` as you would `nyaruko` above.
For the first alternate version:
```sh
./try.alt.sh
./try.alt.sh
```
We have no way to test the second version, sorry (tm Canada :-) )!
@@ -94,17 +94,17 @@ The judges have nothing to add that has not already been written about in the
`Nyaruko` will produce C code that reproduces this input on `stdout`:
```sh
./nyaruko < original.bin > output.c
gcc output.c -o output
./output > regenerated.bin
./nyaruko < original.bin > output.c
gcc output.c -o output
./output > regenerated.bin
```
Output is encrypted, but both key and data are included in the output.
To separate the key from the data, run these commands:
```sh
bash output.c > key.c
perl output.c > data.c
bash output.c > key.c
perl output.c > data.c
```
The key-less `data.c` still compiles, but produces a different message
@@ -115,8 +115,8 @@ To combine the key and data, concatenate them together in either
order:
```sh
cat key.c data.c > output.c
cat data.c key.c > output.c
cat key.c data.c > output.c
cat data.c key.c > output.c
```
By default, `Nyaruko` generates a unique random key for every message,
@@ -124,7 +124,7 @@ using `/dev/urandom` as the seed. If given an extra command line
argument, `Nyaruko` will seed using that file instead of `/dev/urandom`:
```sh
./nyaruko seed.txt < input.bin > output.c
./nyaruko seed.txt < input.bin > output.c
```
This makes the output key deterministic, allowing the same key to be shared