improve location.html

Add request for help for the "ZZ - Unknown location" authors.

Add "Jump to: top" near the bottom.

Changed `bin/gen-location.sh` VERSION from to "1.3 2024-04-16"
to "1.4 2024-04-21".

Improved FAQ 5.5, asking for help for ZZ location authors
and making better references to FAQ 6.10 about pull requests.

Run `make gen_location gen_top_html` to perform the above.

bin/gen-location.sh

@@ -84,7 +84,7 @@ shopt -s globstar	# enable ** to match all files and zero or more directories an
 
 # set variables referenced in the usage message
 #
-export VERSION="1.3 2024-04-16"
+export VERSION="1.4 2024-04-21"
 NAME=$(basename "$0")
 export NAME
 export V_FLAG=0
@@ -458,6 +458,7 @@ fi
 {
     # process unique location_codes found in author_handle JSON files in dictionary order
     #
+    export PREV_LOCATION_CODE="."
     find "$AUTHOR_DIR" -mindepth 1 -maxdepth 1 -type f -name '*.json' -print0 |
 	  xargs -0 grep '"location_code".*:' |
 	  sed -e 's/^.*: "//' -e 's/",*$//' |
@@ -499,11 +500,25 @@ fi
 
 	# output markdown entry for this location
 	#
+	if [[ $PREV_LOCATION_CODE != '.' ]]; then
+	    echo '<hr style="width:10%;text-align:left;margin-left:0">'
+	fi
 	if [[ $LOCATION_NAME == "$LOCATION_COMMON_NAME" ]]; then
 	    echo "* <div id=$LOCATION_CODE>**$LOCATION_CODE** - _${LOCATION_NAME}_</div>"
 	else
 	    echo "* <div id=$LOCATION_CODE>**$LOCATION_CODE** - _${LOCATION_NAME}_ (_${LOCATION_COMMON_NAME}_)</div>"
 	fi
+
+	# ask for help with location code ZZ (Unknown location)
+	#
+	if [[ $LOCATION_CODE == 'ZZ' ]]; then
+	    echo
+	    echo '<p>**PLEASE HELP** us identify proper locations for these authors!</p>'
+	    echo '<p>See [FAQ 5.5](faq.html#fix_author) for how you can help!</p>'
+	fi
+
+	# output author count for this location
+	#
 	echo
 	echo "  Author count: **$AUTHOR_COUNT**"
 	echo
@@ -540,7 +555,10 @@ fi
 	done
 	echo '<p></p>'
 	echo
+	PREV_LOCATION_CODE="$LOCATION_CODE"
     done
+    echo '<hr style="width:10%;text-align:left;margin-left:0">'
+    echo '<h4>Jump to: <a href="#">top</a></h4>'
 
 } | if [[ -z $NOOP ]]; then
     cat >> "$TMP_LOC_MD"

faq.html

@@ -1893,6 +1893,12 @@ and ask for help. See <a href="#fix_an_entry">FAQ 5.3</a> for information on ope
 <h2 id="faq-5.5-how-may-i-correct-or-update-ioccc-author-information">FAQ 5.5: How may I correct or update IOCCC author information?</h2>
 </div>
 </div>
+<h4 id="please-help-us-identify-proper-locations-for-ioccc-authors">PLEASE HELP us identify proper locations for IOCCC authors</h4>
+<p>If you know the location of an author listed under:</p>
+<p>      <strong><a href="location.html#ZZ">ZZ - Unknown location</a></strong></p>
+<p>or if you find IOCCC author location that is incorrect,
+then <strong>please <a href="faq.html#pull_request">submit a pull request</a></strong>,
+or at least <a href="contact.html">inform the IOCCC judges</a>.</p>
 <p>Authors of IOCCC winning entries are kept in JSON files of the form:</p>
 <pre><code>    author/author_handle.json</code></pre>
 <p>where <em>author_handle</em> is an author handle. See <a href="#author_handle">FAQ 6.5</a> for more
@@ -1901,11 +1907,11 @@ information about author handles.</p>
 about authors of IOCCC entries. See <a href="#author_json">FAQ 6.6</a> for information
 about the contents of these JSON file and how they are used.</p>
 <p>You may update IOCCC author information in a <code>author_handle.json</code> file
-by opening a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull request</a>
+by <a href="faq.html#pull_request">submitting a pull request</a>
 against the master <a href="https://github.com/ioccc-src/winner/branches">branch</a>
 of the <a href="https://github.com/ioccc-src/winner">ioccc-src/winner repo</a>.</p>
-<p>Please see <a href="#fix_an_entry">FAQ 5.2 How may I submit a fix to an IOCCC
+<p>Please see <a href="#fix_an_entry">FAQ 5.2 How may I submit a fix to an IOCCC entry</a>.</p>
-entry</a>. See also the <a href="#ull_request">FAQ 6.10 How does someone
+<p>See also the <a href="#ull_request">FAQ 6.10 How does someone
 make a change to a file and submit that change as a GitHub pull
 request</a> for more information about pull requests.</p>
 <div id="faq5_6">

faq.md

@@ -2552,6 +2552,16 @@ and ask for help.  See [FAQ 5.3](#fix_an_entry) for information on opening up an
 </div>
 </div>
 
+#### PLEASE HELP us identify proper locations for IOCCC authors
+
+If you know the location of an author listed under:
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**[ZZ - Unknown location](location.html#ZZ)**
+
+or if you find IOCCC author location that is incorrect,
+then **please [submit a pull request](faq.html#pull_request)**,
+or at least [inform the IOCCC judges](contact.html).
+
 Authors of IOCCC winning entries are kept in JSON files of the form:
 
 ```
@@ -2566,12 +2576,13 @@ about authors of IOCCC entries.  See [FAQ 6.6](#author_json) for information
 about the contents of these JSON file and how they are used.
 
 You may update IOCCC author information in a `author_handle.json` file
-by opening a [GitHub pull request](https://github.com/ioccc-src/winner/pulls)
+by [submitting  a pull request](faq.html#pull_request)
 against the master [branch](https://github.com/ioccc-src/winner/branches)
 of the [ioccc-src/winner repo](https://github.com/ioccc-src/winner).
 
-Please see [FAQ 5.2 How may I submit a fix to an IOCCC
+Please see [FAQ 5.2 How may I submit a fix to an IOCCC entry](#fix_an_entry).
-entry](#fix_an_entry).  See also the [FAQ 6.10 How does someone
+
+See also the [FAQ 6.10 How does someone
 make a change to a file and submit that change as a GitHub pull
 request](#ull_request) for more information about pull requests.
 

location.html

@@ -146,6 +146,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="BE">
 <strong>BE</strong> - <em>Kingdom of Belgium</em> (<em>Belgium</em>)
 </div>
@@ -155,6 +158,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="BR">
 <strong>BR</strong> - <em>Federative Republic of Brazil</em> (<em>Brazil</em>)
 </div>
@@ -164,6 +170,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="CA">
 <strong>CA</strong> - <em>Canada</em>
 </div>
@@ -173,6 +182,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="CH">
 <strong>CH</strong> - <em>Swiss Confederation</em> (<em>Switzerland</em>)
 </div>
@@ -182,6 +194,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="CN">
 <strong>CN</strong> - <em>People’s Republic of China</em> (<em>China</em>)
 </div>
@@ -191,6 +206,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="CZ">
 <strong>CZ</strong> - <em>Czech Republic</em> (<em>Czechia</em>)
 </div>
@@ -200,6 +218,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="DE">
 <strong>DE</strong> - <em>Federal Republic of Germany</em> (<em>Germany</em>)
 </div>
@@ -216,6 +237,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="FI">
 <strong>FI</strong> - <em>Republic of Finland </em> (<em>Finland</em>)
 </div>
@@ -233,6 +257,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="FR">
 <strong>FR</strong> - <em>French Republic</em> (<em>France</em>)
 </div>
@@ -248,6 +275,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="GB">
 <strong>GB</strong> - <em>United Kingdom of Great Britain and Northern Ireland</em> (<em>United Kingdom</em>)
 </div>
@@ -267,6 +297,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="GR">
 <strong>GR</strong> - <em>Hellenic Republic</em> (<em>Greece</em>)
 </div>
@@ -276,6 +309,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="IL">
 <strong>IL</strong> - <em>State of Israel</em> (<em>Israel</em>)
 </div>
@@ -289,6 +325,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="IT">
 <strong>IT</strong> - <em>Italian Republic</em> (<em>Italy</em>)
 </div>
@@ -300,6 +339,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="JP">
 <strong>JP</strong> - <em>Japan</em>
 </div>
@@ -315,6 +357,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="KR">
 <strong>KR</strong> - <em>Republic of Korea</em> (<em>South Korea</em>)
 </div>
@@ -324,6 +369,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="MX">
 <strong>MX</strong> - <em>United Mexican States</em> (<em>Mexico</em>)
 </div>
@@ -333,6 +381,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="NL">
 <strong>NL</strong> - <em>Kingdom of the Netherlands</em> (<em>Netherlands</em>)
 </div>
@@ -347,6 +398,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="NO">
 <strong>NO</strong> - <em>Kingdom of Norway</em> (<em>Norway</em>)
 </div>
@@ -358,6 +412,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="NZ">
 <strong>NZ</strong> - <em>New Zealand</em>
 </div>
@@ -367,6 +424,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="PL">
 <strong>PL</strong> - <em>Republic of Poland</em> (<em>Poland</em>)
 </div>
@@ -378,6 +438,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="RU">
 <strong>RU</strong> - <em>Russian Federation</em> (<em>Russia</em>)
 </div>
@@ -387,6 +450,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="SE">
 <strong>SE</strong> - <em>Kingdom of Sweden</em> (<em>Sweden</em>)
 </div>
@@ -399,6 +465,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="SG">
 <strong>SG</strong> - <em>Republic of Singapore</em> (<em>Singapore</em>)
 </div>
@@ -409,6 +478,9 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="US">
 <strong>US</strong> - <em>United States of America</em> (<em>United States</em>)
 </div>
@@ -485,9 +557,19 @@
 <p>
 </p></li>
 </ul></li>
+</ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<ul>
 <li><div id="ZZ">
 <strong>ZZ</strong> - <em>Unknown location</em>
-</div>
+</div></li>
+</ul>
+<p>
+<strong>PLEASE HELP</strong> us identify proper locations for these authors!
+</p>
+<p>
+See <a href="faq.html#fix_author">FAQ 5.5</a> for how you can help!
+</p>
 <p>Author count: <strong>46</strong></p>
 <ul>
 <li><a href="authors.html#Glyn_Anderson">Glyn Anderson</a></li>
@@ -538,8 +620,11 @@
 <li><a href="authors.html#Lord_Zarbon">Lord Zarbon</a>
 <p>
 </p></li>
-</ul></li>
 </ul>
+<hr style="width:10%;text-align:left;margin-left:0">
+<h4>
+Jump to: <a href="#">top</a>
+</h4>
 <!-- AFTER: last line of markdown file: location.md -->
 
 <!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->