Revision as of 04:07, 7 November 2021

How to fancifully display your regiohash progress ...again.

Issue: Hessophanes's regiohashing progress displaying tool no longer works.

Solution: ~~Message Hessophanes~~ Recreate it myself, in Javascript (so that it can be run on GitHub Pages), even though I had next-to-no prior experience in coding JS.

Note: This page's format will closely follow that of the original regiohashing tool's page because I'm unoriginal I want to pay tribute. There's also going to be way too many comparisons to said original.

How to use it...

I have done my best to try to keep the user side of things as close to the original as I can (given that I don't really have that much knowledge of how the tool fully worked, only what's on the page on the wiki).

Consequently, the parts after the base URL should be (mostly) the same; the base URL is now:

https://thexxos.github.io/regiohash/? (v1.0.0)

The parameters should also be basically the same as the original; to avoid this page being mostly the same, I'll only show the differences here. (Let me know on my talk page if you want the full list instead)

Querying metadata
- about: Mostly the same, except it is displayed as a table rather than as plain text.
- help: All other parameters are ignored. Displays a link to this wiki page and to the GitHub repository.

Selecting (a part of) the world
- region=name: Ideally, this would be the same as usual for maximum ease of use. However, in the program's current form, only top-level and second-level regions work. Adding third-level and further regions will be the main thing I focus on after completing the tool fully.

Entering your progress manually
- started=yyyy-mm-dd: Doing it without the dashes won't work, unfortunately.

Redirecting the tool to your userpage
- wikiuser=User: This hasn't been implemented, and will unfortunately have to be one of the last things that I do.

An example of how you would use this is as follows:

https://thexxos.github.io/regiohash/?region=AU:SA&visited=-34.138.-35.138.-35.139.-35.140.-34.140&home=-34.138&started=2020-07-27

What it looks like...

This is an example board (i.e. not my real board).

The top left counter (that displays the number of graticules left) is incorrect, as I hadn't coded it to check for subregions when I got this picture. Oops.

What it still lacks...

As mentioned multiple times above, this tool isn't quite at the point at which it's as good as the original.

Here's some things that I want to do with it:

Adding more maps
Adding wikiuser=User functionality
Adding a notvisited= parameter, which isn't a functionality of the original but is in the What it still lacks section of it.
Redoing the map file parsing to allow three or more layers of regions (Maybe; it might actually be worth rewriting the entire project eventually)

List of available regions

Region	Subregion	submitted by
Australia (AU)	Western_Australia (WA), Northern_Territory (NT), South_Australia (SA), Queensland (QLD), New_South_Wales (NSW), Victoria (VIC), Tasmania (TAS), Australian_Capital_Territory (ACT)	XXOs, using UnwiseOwl's map
Germany (DE)	Baden_Württemberg (BW), Bayern (BY), Berlin (BE), Brandenburg (BB), Bremen (HB), Hamburg (HH), Hessen (HE), Mecklenburg-Vorpommern (MV), Niedersachsen (NI), Nordrhein-Westfalen (NW), Rheinland-Pfalz (RP), Saarland (SL), Sachsen (SN), Sachsen-Anhalt (ST), Schleswig-Holstein (SH), Thüringen (TH)	Fippe (I think)
Israel (IL)	Darom (D), Haifa (HA), Jerusalem (JM), Merkaz (M), Tel_Aviv (TA), Yosh (YS), Zafon (Z)	Fippe (I think)
Japan (JP) (incomplete)	Hokkaido (01), Aomori (02), Iwate (03), Miyagi (04), Akita (05), Yamagata (06), Fukushima (07), Ibaraki (08), Tochigi (09), Gunma (10), Saitama (11), Chiba (12), Tokyo (13), Kanagawa (14), Niigata (15), Toyama (16)	XXOs, partially using this map

You can also use the about parameter to check on the actual tool.

List of upcoming regions

None so far.

How to add regions

Unlike the original, this is open-source. That means that you can create a pull request that modifies the map.txt file on the GitHub repo. The format of submission should be the same, but in this version (due to how I've jankily imported the map file) the top and bottom lines SHOULD NOT BE MODIFIED. Also, as mentioned above, currently only top- and second-level regions are supported.

If you're not sure how to go about doing this, just add an issue instead.

Feedback

You can either leave a message on my talk page (or on the talk page for this page which I didn't know existed??) or message me on the Geohashing Discord server (my account is XXOs#1317).

My agenda

Do everything in the list under What it still lacks.

@@ Line 2: / Line 2: @@
 '''Issue:''' [[User:Hessophanes|Hessophanes's]] [[User:Hessophanes/Regiohashing|regiohashing progress displaying tool]] no longer works.
-'''Solution:''' <s>Message Hessophanes</s> ''[https://github.com/TheXXOs/regiohash Recreate it myself]'', in Javascript (so that it can be run on GitHub Pages), even though I have next-to-no prior experience in coding JS.
+'''Solution:''' <s>Message Hessophanes</s> ''[https://github.com/TheXXOs/regiohash Recreate it myself]'', in Javascript (so that it can be run on GitHub Pages), even though I had next-to-no prior experience in coding JS.
   '''Note:''' This page's format will closely follow that of the original regiohashing tool's page because <s>I'm unoriginal</s> ''I want to pay tribute''. There's also going to be way too many comparisons to said original.
@@ Line 41: / Line 41: @@
 As mentioned multiple times above, this tool isn't quite at the point at which it's as good as the original.
-Alongside recreating the original maps, my main priority is to get this recreation to the standard that the original was at; the order I plan to do this in is as follows:
+Here's some things that I want to do with it:
-# '''Redoing the map file parsing to allow three or more layers of regions''' (which may involve redoing the square-to-lat/long functionality)
+# '''Adding more maps'''
-# '''Fix the top-left number'''
 # '''Adding '''''wikiuser=User''''' functionality'''
 # '''Adding a '''''notvisited=''''' parameter''', which isn't a functionality of the original but is in the ''[[User:Hessophanes/Regiohashing#What_it_still_lacks...|What it still lacks]]'' section of it.
+# '''Redoing the map file parsing to allow three or more layers of regions''' (Maybe; it might actually be worth rewriting the entire project eventually)
 == List of available regions ==
@@ Line 87: / Line 87: @@
 [[Category:Regional geohash map]]
 [[Category:Fun stuff]]
+[[Category:Implementations]]

Difference between revisions of "User:XXOs/Regiohashing"