reduce bold links in a few link heavy areas
While the use of `**font-weight: bold;` helps links standout in
most cases, there a few "_link heavy_" pages were the **MANY BOLD
LINK IN CLOSE PROXIMITY** looks excessive to the point of being
distracting. In areas where **nearly everything is BOLD, nothing
seems to stand out**.
Fortunately there seems to be only a very few places where this is a problem:
* `faq.html` - the table of contents
* `authors.html` - nearly the entire page
* `location.html` - nearly the entire page
* `years.html` - nearly the entire page
As an **bold** 😎 experiment we added to the CSS:
```css
/*
* To make a link non-bold, use: <a class="normal" href="url">link text</a>
*/
a.normal {
font-weight: normal;
}
```
And then modified select tools and a markdown file to "_unbold_"
those "_link heavy_" areas of the 4 pages above.
We don't claim that this is the best solution and there may be an
even better way to solve this, nevertheless we **do** think the it
improves the look and feel of the "_link heavy_" areas of the 4
pages above. For example, in `faq.html` beyond the table of
contents, the bold links look reasonable (although again there are
some quasi-"_link heavy_" areas down in the page look a bit too
bold, but perhaps not enough to warrant changing so we only altered
the table of contents).
In a few cases, while we were editing code that generated links,
we remove a few "**.**"'s where we didn't think they helped the
look and feel.
Change `bin/gen-authors.sh` VERSION from "1.10.3 2024-05-24"
to "1.10.4 2024-07-13".
Change `bin/gen-location.sh` VERSION from "1.4.2 2024-05-19"
to "1.4.3 2024-07-13".
Change `bin/gen-years.sh` VERSION from "1.3.3 2024-07-07"
to "1.3.4 2024-07-13".
Performed `make www` to accomplish the above and to test under macOS.
This commit is contained in:
Landon Curt Noll committed
1 parent
5d191a19aa
commit
7b100f1264
9 files changed
+1636
-1629
No files matched your search
@@ -385,102 +385,102 @@
|
||||
<h1 id="faq-table-of-contents">FAQ Table of Contents</h1>
|
||||
<h2 id="section-0---submitting-entries-to-a-new-ioccc">Section 0 - <a href="#faq0">Submitting entries to a new IOCCC</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq0_0">0.0 - How may I enter the IOCCC?</a></li>
|
||||
<li><a href="#faq0_1">0.1 - What types of entries have been frequently submitted to the IOCCC?</a></li>
|
||||
<li><a href="#faq0_2">0.2 - What should I put in my entry’s Makefile?</a></li>
|
||||
<li><a href="#faq0_3">0.3 - May I use a different source or compiled filename than prog.c or prog?</a></li>
|
||||
<li><a href="#faq0_4">0.4 - What platform should I assume for my entry?</a></li>
|
||||
<li><a href="#faq0_5">0.5 - How may I comment or make a suggestion on IOCCC rules, guidelines and tools?</a></li>
|
||||
<li><a href="#faq0_6">0.6 - What is the best way to ask a question about the IOCCC rules, guideline and tools?</a></li>
|
||||
<li><a href="#faq0_7">0.7 - What are the IOCCC best practices for using markdown?</a></li>
|
||||
<li><a href="#faq0_8">0.8 - How do I report bugs in a <code>mkiocccentry</code> tool?</a></li>
|
||||
<li><a class="normal" href="#faq0_0">0.0 - How may I enter the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq0_1">0.1 - What types of entries have been frequently submitted to the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq0_2">0.2 - What should I put in my entry’s Makefile?</a></li>
|
||||
<li><a class="normal" href="#faq0_3">0.3 - May I use a different source or compiled filename than prog.c or prog?</a></li>
|
||||
<li><a class="normal" href="#faq0_4">0.4 - What platform should I assume for my entry?</a></li>
|
||||
<li><a class="normal" href="#faq0_5">0.5 - How may I comment or make a suggestion on IOCCC rules, guidelines and tools?</a></li>
|
||||
<li><a class="normal" href="#faq0_6">0.6 - What is the best way to ask a question about the IOCCC rules, guideline and tools?</a></li>
|
||||
<li><a class="normal" href="#faq0_7">0.7 - What are the IOCCC best practices for using markdown?</a></li>
|
||||
<li><a class="normal" href="#faq0_8">0.8 - How do I report bugs in a <code>mkiocccentry</code> tool?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-1---history-of-the-ioccc">Section 1 - <a href="#faq1">History of the IOCCC</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq1_0">1.0 - How did the IOCCC get started?</a></li>
|
||||
<li><a href="#faq1_1">1.1 - Why are some years missing IOCCC entries?</a></li>
|
||||
<li><a href="#faq1_2">1.2 - What is the history of the IOCCC website?</a></li>
|
||||
<li><a href="#faq1_3">1.3 - How has the IOCCC size limit rule changed over the years?</a></li>
|
||||
<li><a class="normal" href="#faq1_0">1.0 - How did the IOCCC get started?</a></li>
|
||||
<li><a class="normal" href="#faq1_1">1.1 - Why are some years missing IOCCC entries?</a></li>
|
||||
<li><a class="normal" href="#faq1_2">1.2 - What is the history of the IOCCC website?</a></li>
|
||||
<li><a class="normal" href="#faq1_3">1.3 - How has the IOCCC size limit rule changed over the years?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-2---ioccc-judging-process">Section 2 - <a href="#faq2">IOCCC Judging process</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq2_0">2.0 - How many entries do the judges receive for a given IOCCC?</a></li>
|
||||
<li><a href="#faq2_1">2.1 - What should I put in the remarks.md file of my entry?</a></li>
|
||||
<li><a href="#faq2_2">2.2 - Why don’t you publish entries that do not win?</a></li>
|
||||
<li><a href="#faq2_3">2.3 - How much time does it take to judge the contest?</a></li>
|
||||
<li><a href="#faq2_4">2.4 - How many judging rounds do you have?</a></li>
|
||||
<li><a href="#faq2_5">2.5 - Why do some IOCCC entries receive the Grand Prize or Best of Show award?</a></li>
|
||||
<li><a href="#faq2_6">2.6 - How are IOCCC entries announced?</a></li>
|
||||
<li><a class="normal" href="#faq2_0">2.0 - How many entries do the judges receive for a given IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq2_1">2.1 - What should I put in the remarks.md file of my entry?</a></li>
|
||||
<li><a class="normal" href="#faq2_2">2.2 - Why don’t you publish entries that do not win?</a></li>
|
||||
<li><a class="normal" href="#faq2_3">2.3 - How much time does it take to judge the contest?</a></li>
|
||||
<li><a class="normal" href="#faq2_4">2.4 - How many judging rounds do you have?</a></li>
|
||||
<li><a class="normal" href="#faq2_5">2.5 - Why do some IOCCC entries receive the Grand Prize or Best of Show award?</a></li>
|
||||
<li><a class="normal" href="#faq2_6">2.6 - How are IOCCC entries announced?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-3---compiling-and-running-ioccc-entries">Section 3 - <a href="#faq3">Compiling and running IOCCC entries</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq3_0">3.0 - What Makefile rules are available to build or clean up IOCCC entries?</a></li>
|
||||
<li><a href="#faq3_1">3.1 - Why doesn’t an IOCCC entry compile?</a></li>
|
||||
<li><a href="#faq3_2">3.2 - Why does an IOCCC entry fail on my 64-bit system?</a></li>
|
||||
<li><a href="#faq3_3">3.3 - Why do some IOCCC entries fail to compile under macOS?</a></li>
|
||||
<li><a href="#faq3_4">3.4 - Why does clang or gcc fail to compile an IOCCC entry?</a></li>
|
||||
<li><a href="#faq3_5">3.5 - What is this cb tool that is mentioned in the IOCCC?</a></li>
|
||||
<li><a href="#faq3_6">3.6 - An IOCCC entry messed up my terminal application, how do I fix this?</a></li>
|
||||
<li><a href="#faq3_7">3.7 - How do I run an IOCCC entry that requires X11?</a></li>
|
||||
<li><a href="#faq3_8">3.8 - How do I compile an IOCCC entry that requires SDL1 or SDL2?</a></li>
|
||||
<li><a href="#faq3_9">3.9 - How do I compile an IOCCC entry that requires (n)curses?</a></li>
|
||||
<li><a href="#faq3_10">3.10 - How do I compile and use an IOCCC entry that requires sound?</a></li>
|
||||
<li><a href="#faq3_11">3.11 - Why do Makefiles use -Weverything with clang?</a></li>
|
||||
<li><a href="#faq3_12">3.12 - How do I find out how to send interrupt/EOF etc. for entries that require it?</a></li>
|
||||
<li><a href="#faq3_13">3.13 - Why does an IOCCC entry fail to compile and/or fail to run?</a></li>
|
||||
<li><a href="#faq3_14">3.14 - How do I compile and install tcpserver for entries that require it?</a></li>
|
||||
<li><a href="#faq3_15">3.15 - How do I compile and install netpbm for entries that require it?</a></li>
|
||||
<li><a href="#faq3_16">3.16 - How do I compile and install libjpeg-turbo for entries that require it?</a></li>
|
||||
<li><a href="#faq3_17">3.17 - How do I compile and install ImageMagick for entries that require it?</a></li>
|
||||
<li><a href="#faq3_18">3.18 - How do I compile and install OpenGL for entries that require it?</a></li>
|
||||
<li><a href="#faq3_19">3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?</a></li>
|
||||
<li><a href="#faq3_20">3.20 - How do I download individual winning entries or all winning entries of a given year?</a></li>
|
||||
<li><a href="#faq3_21">3.21 - What are <code>try.sh</code> and <code>try.alt.sh</code> scripts and why should I use them?</a></li>
|
||||
<li><a class="normal" href="#faq3_0">3.0 - What Makefile rules are available to build or clean up IOCCC entries?</a></li>
|
||||
<li><a class="normal" href="#faq3_1">3.1 - Why doesn’t an IOCCC entry compile?</a></li>
|
||||
<li><a class="normal" href="#faq3_2">3.2 - Why does an IOCCC entry fail on my 64-bit system?</a></li>
|
||||
<li><a class="normal" href="#faq3_3">3.3 - Why do some IOCCC entries fail to compile under macOS?</a></li>
|
||||
<li><a class="normal" href="#faq3_4">3.4 - Why does clang or gcc fail to compile an IOCCC entry?</a></li>
|
||||
<li><a class="normal" href="#faq3_5">3.5 - What is this cb tool that is mentioned in the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq3_6">3.6 - An IOCCC entry messed up my terminal application, how do I fix this?</a></li>
|
||||
<li><a class="normal" href="#faq3_7">3.7 - How do I run an IOCCC entry that requires X11?</a></li>
|
||||
<li><a class="normal" href="#faq3_8">3.8 - How do I compile an IOCCC entry that requires SDL1 or SDL2?</a></li>
|
||||
<li><a class="normal" href="#faq3_9">3.9 - How do I compile an IOCCC entry that requires (n)curses?</a></li>
|
||||
<li><a class="normal" href="#faq3_10">3.10 - How do I compile and use an IOCCC entry that requires sound?</a></li>
|
||||
<li><a class="normal" href="#faq3_11">3.11 - Why do Makefiles use -Weverything with clang?</a></li>
|
||||
<li><a class="normal" href="#faq3_12">3.12 - How do I find out how to send interrupt/EOF etc. for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_13">3.13 - Why does an IOCCC entry fail to compile and/or fail to run?</a></li>
|
||||
<li><a class="normal" href="#faq3_14">3.14 - How do I compile and install tcpserver for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_15">3.15 - How do I compile and install netpbm for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_16">3.16 - How do I compile and install libjpeg-turbo for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_17">3.17 - How do I compile and install ImageMagick for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_18">3.18 - How do I compile and install OpenGL for entries that require it?</a></li>
|
||||
<li><a class="normal" href="#faq3_19">3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?</a></li>
|
||||
<li><a class="normal" href="#faq3_20">3.20 - How do I download individual winning entries or all winning entries of a given year?</a></li>
|
||||
<li><a class="normal" href="#faq3_21">3.21 - What are <code>try.sh</code> and <code>try.alt.sh</code> scripts and why should I use them?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-4---changes-made-to-ioccc-entries">Section 4 - <a href="#faq4">Changes made to IOCCC entries</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq4_0">4.0 - Why are some winning author remarks incongruent with the winning IOCCC code?</a></li>
|
||||
<li><a href="#faq4_1">4.1 - Why were some calls to the libc function gets(3) changed to use fgets(3)?</a></li>
|
||||
<li><a href="#faq4_2">4.2 - What was changed in an IOCCC entry source code?</a></li>
|
||||
<li><a class="normal" href="#faq4_0">4.0 - Why are some winning author remarks incongruent with the winning IOCCC code?</a></li>
|
||||
<li><a class="normal" href="#faq4_1">4.1 - Why were some calls to the libc function gets(3) changed to use fgets(3)?</a></li>
|
||||
<li><a class="normal" href="#faq4_2">4.2 - What was changed in an IOCCC entry source code?</a></li>
|
||||
<li><a href="#faq4_3">4.3 - Why do author remarks sometimes not match the source and/or why are there
|
||||
other inconsistencies with the original entry?</a></li>
|
||||
<li><a href="#faq4_4">4.4 - What is the meaning of the file ending in .orig.c in IOCCC entries?</a></li>
|
||||
<li><a href="#faq4_5">4.5 - Why were alternate versions added to some entries when the original entry worked fine and well?</a></li>
|
||||
<li><a href="#faq4_6">4.6 - Why was arg count and/or type changed in main() in some older entries?</a></li>
|
||||
<li><a href="#faq4_7">4.7 - Why were some filenames changed?</a></li>
|
||||
<li><a href="#faq4_8">4.8 - Why were files added or removed from some entries?</a></li>
|
||||
<li><a class="normal" href="#faq4_4">4.4 - What is the meaning of the file ending in .orig.c in IOCCC entries?</a></li>
|
||||
<li><a class="normal" href="#faq4_5">4.5 - Why were alternate versions added to some entries when the original entry worked fine and well?</a></li>
|
||||
<li><a class="normal" href="#faq4_6">4.6 - Why was arg count and/or type changed in main() in some older entries?</a></li>
|
||||
<li><a class="normal" href="#faq4_7">4.7 - Why were some filenames changed?</a></li>
|
||||
<li><a class="normal" href="#faq4_8">4.8 - Why were files added or removed from some entries?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-5---helping-the-ioccc">Section 5 - <a href="#faq5">Helping the IOCCC</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq5_0">5.0 - How may I help the IOCCC?</a></li>
|
||||
<li><a href="#faq5_1">5.1 - How do I report a bug in an IOCCC entry?</a></li>
|
||||
<li><a href="#faq5_2">5.2 - How may I submit a fix to an IOCCC entry?</a></li>
|
||||
<li><a href="#faq5_3">5.3 - How may I report an IOCCC website problem?</a></li>
|
||||
<li><a href="#faq5_4">5.4 - How may I submit a fix to the IOCCC website?</a></li>
|
||||
<li><a href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a></li>
|
||||
<li><a href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a></li>
|
||||
<li><a href="#faq5_7">5.7 - How may I support the IOCCC?</a></li>
|
||||
<li><a href="#faq5_8">5.8 - I deobfuscated some entry code, how may I contribute the source?</a></li>
|
||||
<li><a class="normal" href="#faq5_0">5.0 - How may I help the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq5_1">5.1 - How do I report a bug in an IOCCC entry?</a></li>
|
||||
<li><a class="normal" href="#faq5_2">5.2 - How may I submit a fix to an IOCCC entry?</a></li>
|
||||
<li><a class="normal" href="#faq5_3">5.3 - How may I report an IOCCC website problem?</a></li>
|
||||
<li><a class="normal" href="#faq5_4">5.4 - How may I submit a fix to the IOCCC website?</a></li>
|
||||
<li><a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a></li>
|
||||
<li><a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a></li>
|
||||
<li><a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, how may I contribute the source?</a></li>
|
||||
</ul>
|
||||
<h2 id="section-6---miscellaneous-ioccc">Section 6 - <a href="#faq6">Miscellaneous IOCCC</a></h2>
|
||||
<ul>
|
||||
<li><a href="#faq6_0">6.0 - How did an entry that breaks the size rule 2 win the IOCCC?</a></li>
|
||||
<li><a href="#faq6_1">6.1 - Is there a list of known bugs and (mis)features of IOCCC entries?</a></li>
|
||||
<li><a href="#faq6_2">6.2 - May I mirror the IOCCC website?</a></li>
|
||||
<li><a href="#faq6_3">6.3 - May I use parts of the IOCCC in an article, book, newsletter, or instructional material?</a></li>
|
||||
<li><a href="#faq6_4">6.4 - Why do you sometimes use the first person plural?</a></li>
|
||||
<li><a href="#faq6_5">6.5 - What is an <code>author handle</code>?</a></li>
|
||||
<li><a href="#faq6_6">6.6 - What is an author_handle.json file and how are they used?</a></li>
|
||||
<li><a href="#faq6_7">6.7 - What is an <code>entry_id</code>?</a></li>
|
||||
<li><a href="#faq6_8">6.8 - What is the purpose of the .top, .year and .path files?</a></li>
|
||||
<li><a href="#faq6_9">6.9 - What is the current meaning of the IOCCC terms Author, Entry, and Submission?</a></li>
|
||||
<li><a href="#faq6_10">6.10 - How does someone make a change to a file and submit that change as a GitHub pull request?</a></li>
|
||||
<li><a href="#faq6_11">6.11 - Am I allowed to use IOCCC content?</a></li>
|
||||
<li><a href="#faq6_12">6.12 - What is Mastodon and why does IOCCC use it?</a></li>
|
||||
<li><a href="#faq6_13">6.13 - How may I find my author handle?</a></li>
|
||||
<li><a href="#faq6_14">6.14 - How do I set certain tabstops for viewing source code in vi(m)?</a></li>
|
||||
<li><a href="#faq6_15">6.15 - How do the menus on the website work and what can I do if they don’t work?</a></li>
|
||||
<li><a href="#faq6_16">6.16 - How do I find more information about a winning author of an entry?</a></li>
|
||||
<li><a class="normal" href="#faq6_0">6.0 - How did an entry that breaks the size rule 2 win the IOCCC?</a></li>
|
||||
<li><a class="normal" href="#faq6_1">6.1 - Is there a list of known bugs and (mis)features of IOCCC entries?</a></li>
|
||||
<li><a class="normal" href="#faq6_2">6.2 - May I mirror the IOCCC website?</a></li>
|
||||
<li><a class="normal" href="#faq6_3">6.3 - May I use parts of the IOCCC in an article, book, newsletter, or instructional material?</a></li>
|
||||
<li><a class="normal" href="#faq6_4">6.4 - Why do you sometimes use the first person plural?</a></li>
|
||||
<li><a class="normal" href="#faq6_5">6.5 - What is an <code>author handle</code>?</a></li>
|
||||
<li><a class="normal" href="#faq6_6">6.6 - What is an author_handle.json file and how are they used?</a></li>
|
||||
<li><a class="normal" href="#faq6_7">6.7 - What is an <code>entry_id</code>?</a></li>
|
||||
<li><a class="normal" href="#faq6_8">6.8 - What is the purpose of the .top, .year and .path files?</a></li>
|
||||
<li><a class="normal" href="#faq6_9">6.9 - What is the current meaning of the IOCCC terms Author, Entry, and Submission?</a></li>
|
||||
<li><a class="normal" href="#faq6_10">6.10 - How does someone make a change to a file and submit that change as a GitHub pull request?</a></li>
|
||||
<li><a class="normal" href="#faq6_11">6.11 - Am I allowed to use IOCCC content?</a></li>
|
||||
<li><a class="normal" href="#faq6_12">6.12 - What is Mastodon and why does IOCCC use it?</a></li>
|
||||
<li><a class="normal" href="#faq6_13">6.13 - How may I find my author handle?</a></li>
|
||||
<li><a class="normal" href="#faq6_14">6.14 - How do I set certain tabstops for viewing source code in vi(m)?</a></li>
|
||||
<li><a class="normal" href="#faq6_15">6.15 - How do the menus on the website work and what can I do if they don’t work?</a></li>
|
||||
<li><a class="normal" href="#faq6_16">6.16 - How do I find more information about a winning author of an entry?</a></li>
|
||||
</ul>
|
||||
<h1 id="the-ioccc-faq">The IOCCC FAQ</h1>
|
||||
<div id="faq0">
|
||||
|
||||
Reference in new issue
Block a user