Difference between revisions of "User:XXOs/Regiohashing"

From Geohashing
(New regions!)
(v1.1.0 with new vanity features!)
 
(8 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
'''Issue:''' [[User:Hessophanes|Hessophanes's]] [[User:Hessophanes/Regiohashing|regiohashing progress displaying tool]] no longer works.
 
'''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.
 
  '''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 11: Line 11:
 
Consequently, the parts after the base URL should be (mostly) the same; the base URL is now:
 
Consequently, the parts after the base URL should be (mostly) the same; the base URL is now:
  
  [https://thexxos.github.io/regiohash/? https://thexxos.github.io/regiohash/?] (running v1.0.0)
+
  [https://thexxos.github.io/regiohash/? https://thexxos.github.io/regiohash/?] (v1.1.0)
  
 
The parameters should also be basically the same as [[User:Hessophanes/Regiohashing#How_to_use_it...|the original]]; to avoid this page being mostly the same, '''I'll only show the differences here'''. (Let me know on [[User_talk:XXOs|my talk page]] if you want the full list instead)
 
The parameters should also be basically the same as [[User:Hessophanes/Regiohashing#How_to_use_it...|the original]]; to avoid this page being mostly the same, '''I'll only show the differences here'''. (Let me know on [[User_talk:XXOs|my talk page]] if you want the full list instead)
Line 24: Line 24:
 
* '''Entering your progress manually'''
 
* '''Entering your progress manually'''
 
** ''started=yyyy-mm-dd'': Doing it without the dashes won't work, unfortunately.
 
** ''started=yyyy-mm-dd'': Doing it without the dashes won't work, unfortunately.
 +
 +
* '''Vanity options''' (new)
 +
** ''cherry'': Replaces all [[File:Minesweeper geohash 0.jpg]] with [[File:Minesweeper_geohash_cherry.png]]
 +
*** ''press'': If cherry is used alongside this, it replaces all [[File:Minesweeper geohash flag.png]] and [[File:Minesweeper green flag.png]] with [[File:Minesweeper geohash 0.jpg]]
 +
** ''blue'': Replaces all [[File:Minesweeper geohash empty.jpg]] with [[File:Mindsweeper_blue.jpg]]
 +
** ''sunglasses'': Replaces all [[File:Minesweeper geohash 8 number.png]] with [[File:Minesweeper geohash 8.png]]
 +
*** ''sun'' and ''glasses'' also work
  
 
* '''Redirecting the tool to your userpage'''
 
* '''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.
+
** ''wikiuser=User'': This hasn't been implemented yet.
  
 
An example of how you would use this is as follows:
 
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
+
  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&blue
  
 
== What it looks like... ==
 
== What it looks like... ==
 
This is an example board (i.e. not my real board).
 
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.
 
  
 
[[File:XXOs-example-regiohash.png]]
 
[[File:XXOs-example-regiohash.png]]
Line 41: Line 46:
 
As mentioned multiple times above, this tool isn't quite at the point at which it's as good as the original.
 
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'''
 
# '''Adding '''''wikiuser=User''''' functionality'''
 
# '''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.
 
# '''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 ==
 
== List of available regions ==
 +
''Note: if you use the full name of a region, replace the spaces with underscores)''
  
 
{|border=1
 
{|border=1
Line 54: Line 61:
 
|-
 
|-
 
|Australia (AU)
 
|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)
+
|Western Australia (WA), Northern Territory (NT), South Australia (SA), Queensland (QLD), New South Wales (NSW), Victoria (VIC), Tasmania (TAS), Australian Capital Territory (ACT)
 
|[[User:XXOs|XXOs]], using [[User:UnwiseOwl|UnwiseOwl]]'s [[User:UnwiseOwl/Australia|map]]
 
|[[User:XXOs|XXOs]], using [[User:UnwiseOwl|UnwiseOwl]]'s [[User:UnwiseOwl/Australia|map]]
 
|-
 
|-
 
|Germany (DE)
 
|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)
+
|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)
 
|[[User:Fippe|Fippe]] (I think)
 
|[[User:Fippe|Fippe]] (I think)
 
|-
 
|-
 
|Israel (IL)
 
|Israel (IL)
|Darom (D), Haifa (HA), Jerusalem (JM), Merkaz (M), Tel_Aviv (TA), Yosh (YS), Zafon (Z)
+
|Darom (D), Haifa (HA), Jerusalem (JM), Merkaz (M), Tel Aviv (TA), Yosh (YS), Zafon (Z)
 
|[[User:Fippe|Fippe]] (I think)
 
|[[User:Fippe|Fippe]] (I think)
 
|-
 
|-
Line 79: Line 86:
  
 
== Feedback ==
 
== Feedback ==
You can either leave a message on [[User_talk:XXOs|my talk page]] or message me on the [[Discord#Server|Geohashing Discord server]] (my account is XXOs#1317).
+
You can either leave a message on [[User_talk:XXOs|my talk page]] (or on [[User_talk:XXOs/Regiohashing|the talk page for this page which I didn't know existed??]]) or message me on the [[Discord#Server|Geohashing Discord server]] (my account is XXOs#1317).
  
 
== My agenda ==
 
== My agenda ==
Line 86: Line 93:
 
[[Category:Regional geohash map]]
 
[[Category:Regional geohash map]]
 
[[Category:Fun stuff]]
 
[[Category:Fun stuff]]
 +
[[Category:Implementations]]

Latest revision as of 23:28, 8 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.1.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.
  • Vanity options (new)
    • cherry: Replaces all Minesweeper geohash 0.jpg with Minesweeper geohash cherry.png
      • press: If cherry is used alongside this, it replaces all Minesweeper geohash flag.png and Minesweeper green flag.png with Minesweeper geohash 0.jpg
    • blue: Replaces all Minesweeper geohash empty.jpg with Mindsweeper blue.jpg
    • sunglasses: Replaces all Minesweeper geohash 8 number.png with Minesweeper geohash 8.png
      • sun and glasses also work
  • Redirecting the tool to your userpage
    • wikiuser=User: This hasn't been implemented yet.

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&blue

What it looks like...

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

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.

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

  1. Adding more maps
  2. Adding wikiuser=User functionality
  3. Adding a notvisited= parameter, which isn't a functionality of the original but is in the What it still lacks section of it.
  4. 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

Note: if you use the full name of a region, replace the spaces with underscores)

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