User:XXOs/Regiohashing

From Geohashing
< User:XXOs
Revision as of 23:50, 4 November 2021 by XXOs (talk | contribs) (i'm baaaaaaaack...ish)

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 have 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.
Note: This project is not fully working, and I've been not working on it for a few months now. However, I do plan to start working on it again during my school holidays which begin just before December (IIRC).

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/? (running v0.0.1)

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 haven't coded it to check for subregions. Oops.

XXOs-example-regiohash.png

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.

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:

  1. Redoing the map file parsing to allow three or more layers of regions (which may involve redoing the square-to-lat/long functionality)
  2. Fix the top-left number
  3. Adding wikiuser=User functionality
  4. Adding a notvisited= parameter, which isn't a functionality of the original but is in the What it still lacks section of it.

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