add next/submit.html and improve FAQ and other refs to entering the IOCCC

Added a new `next/submit.html` to move the "how to submit" form "in-line"
of the top FAQ entry into a new page managed by `next/submit.md`.
Thus, `next/submit.html` is a parallel to `next/register.html`
and `next/submit.md` is a parallel to `next/register.md`.

Changed the FAQ "faq.html#submit" and into "faq.html#enter".

Added individual tags for the steps in FAQ0.0.

Moved "faq.html#register" down to FAQ 0.0 step 2.

Added "faq.html#submit" for FAQ 0.0 step 5,
however elsewhere often "next/submit.html" is used.

Changed references for "faq.html#upload" to "next/submit.html".

We made a number of changes to the following markdown files to reflect the above:

- `about.md`
- `faq.md`
- `index.md`
- `markdown.md`
- `next/README.md`
- `next/README.md`
- `next/guidelines.md`
- `next/register.md`
- `next/rules.md`
- `nojs-menu.md`
- `status.md`

as well as these files:

- `bin/gen-top-html.sh`
- `bin/md2html.cfg`

and added:

- `next/submit.html`
- `next/submit.md`

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

TODO: Add images about the mailing list to `next/register.md`.  See the line:

```
XXX - **put images and other details about joining the mailing list here** - XXX
```
This commit is contained in:
Landon Curt Noll committed 2024-12-24 16:26:29 -08:00
1 parent edf8c1bdcc
commit 608c77e9f3
24 files changed
+890 -292

No files matched your search

+132
View File
@@ -0,0 +1,132 @@
# How to upload your submission to the IOCCC
**IMPORTANT NOTE**: The [IOCCC submit server](https://submit.ioccc.org)
is only ready for submissions
**ONLY WHEN THE CONTEST IS [open](../status.html#open)**.
See [current status of the IOCCC](../status.html) for details on the contest status.
**IMPORTANT NOTE**: When the contest is [closed](../status.html#closed), the
[IOCCC submit server](https://submit.ioccc.org)
may be offline and unreachable as a web site.
The following steps should be taken, in order to upload your `mkiocccentry` xz
compressed tarball, to change the file (if you need to upload a different file
or you have updated the submission), and to check the status of it after the
contest closes:
First, open the web page in your browser. It should look like this:
With the login id and password already input, It should look something like
this:
<img src="../png/submit-server-login.png"
alt="submit server login screen"
width=710 height=562>
The login is the UUID you were provided when you registered for the IOCCC and
the password is the initial password you were provided with. Click "Login".
Assuming everything is fine, it should look something like:
<img src="../png/submit-server-first-login.png"
alt="submit server password change required"
width=710 height=808>
As you can see, you have to change your password. Put in your login (UUID
username), your old (initial) password and a new password. For instance:
<img src="../png/submit-server-change-passwd.png"
alt="submit server changing password"
width=710 height=808>
Click "Change Password".
Once this is done, you will have to log in again. Using the UUID login and the
new password:
<img src="../png/submit-server-passwd-changed.png"
alt="submit server password changed"
width=710 height=344>
.. click "Login".
Once you've logged in, you will see submit slots. Each slot is for one
submission so if you update a submission, make sure you choose the right one so
you do not overwrite the wrong one!
Here is what it looks like without any uploads and no slot selected:
<img src="../png/submit-server-slots.png"
alt="submit server slots"
width=710 height=806>
Select a slot and then select a file by clicking the button "Choose File". After
doing this, it should look something like:
<img src="../png/submit-server-slot-file.png"
alt="submit server slot and file selected"
width=717 height=865>
If you need to change the file to upload, you can mouseover the file and click
it. If you wait a moment it'll show the current filename. It will look something
like this:
<img src="../png/submit-server-change-file.png"
alt="submit server change file"
width=717 height=865>
Once you're certain you have selected the correct file, click "Submit", below
the file selection step.
When it's uploaded it should look something like this:
<img src="../png/submit-server-submission-uploaded.png"
alt="submit server submission uploaded"
width=717 height=525>
Here you see the details, in particular:
- the status of the submission
- the filename, which will be in the correct format, assuming you used
`mkiocccentry(1)` which is **HIGHLY** recommended so that you do not break [Rule
17](rules.html#rule17)!
- the file length, which `txzchk(1)` will also verify (the file itself and the
tarball listing)
- the upload date
- the SHA256 hash of the file
Now if you're done, log out.
After the submission deadline is reached, you can log in to check the status of
your submissions. Here is what it will look like when the judges have verified
that your tarball / submission has been validated (NOT judged), by `txzchk(1)`
and `chkentry(1)`.:
<img src="../png/submit-server-status-updated.png"
alt="submit server status updated"
width=717 height=217>
For details on `txzchk`, see the
FAQ on "[txzchk](../faq.html#txzchk)".
For details on `chkentry`, see the
FAQ on "[chkentry](../faq.html#chkentry)".
If you need more information on what `chkentry` checks, see the
FAQ on the [".info.json file](../faq.html#info_json)"
and the
FAQ on the "[.auth.json file](../faq.html#auth_json)".
<!--
Copyright © 1984-2024 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/
-->