
// GEN IV SHINY POKEMON TRACKER

	Created by KeyGlyph - keyglyph.com/oua-home
	Shiny menu sprites courtesy of http://www.vdexproject.net/

---------------------------------------------------------------------------------------------------------------------------------

// INTRODUCTION

	Welcome to your Gen IV Shiny Pokemon Tracker kit!

	This bundle of HTML files and sprites is meant to help you implement a clean and customizable process
	for tracking which gen I-IV pokemon you've obtained (or need to obtain!) as shinies.

	Adapted from a SQL/PHP setup I created several years ago for my own use, this Tracker aims to mimic
	the basic look and functionality of a more complicated system while using only HTML and internal/inline
	CSS. In case you're worried, having a website or webspace is not required! You can update and view
	the Tracker just as well with the standard notepad and browser applications on your local machine.

	My hope is that this approach will make the Tracker an easier and more accessible tool for a greater
	amount of people, whether or not you've already had much experience with HTML.

	Is it fancy? No. Is it elegant? No. But it works! Enjoy, and have fun making it your own.

---------------------------------------------------------------------------------------------------------------------------------

// GETTING STARTED

        -------------------------
	>> VIEWING THE TRACKER <<
        -------------------------

	To view the Tracker right away:

	* Right-click on any HTML file in the gen-iv-shiny-tracker folder.
	* Select "Open with" in the dropdown menu.
	* Choose your favorite browser from the suggested list.
	* And look at that! The Gen IV Shiny Pokemon Tracker should now be open in a new browser tab.

		------------------------------------------------------
		>> BUT WAIT, DOES THAT MEAN THE TRACKER IS WEBSITE? <<
		------------------------------------------------------
		
		Nope! It's important to note that at this moment, what you're viewing *is not* a website.
		The specific HTML file you've opened is not being accessed through the internet; it's still 
		just a local file on your computer that's being read and displayed by your browser.
		
		That's right: "web browsers" aren't just for viewing content on the web! They can read and
		display a wide variety of files, regardless of whether those files live on a distant server
		somewhere or just on your own harddrive. The more you know! ☆


        -----------------------
	>> TRACKER FUNCTIONS <<
        -----------------------

	Each Tracker page displays a specified group of pokemon sprites, whether from a particular generation
	or all 493 at once. They also include buttons that redirect you to the other HTML files within
	the gen-iv-shiny-tracker folder for easy category switching. Click around and check it out!

	By default, the Tracker sprites are set to reflect whether or not a pokemon is chainable in the gen IV
	games. If a pokemon species can be chained via the pokeradar in Diamond, Pearl, or Platinum, their sprite
	will appear in the proper colors and detail, but will be semi-transparent. If they *cannot* be chained by
	pokeradar, they will appear only as a translucent silhouette.

	There is also a visual key at the top of each page to demonstrate how the pokemon sprites will look
	when you've assigned different statuses to them (e.g., obtained by chaining, obtained via soft reset).

	Have a look at the STATUSES LIST below for the full catalog of available options.


        -------------------
	>> STATUSES LIST <<
        -------------------

	CLASS
	ATTRIBUTE VALUE		DESCRIPTION

	blank			unobtained pokemon that are not chainable with the pokeradar in gen IV.
	chained			shinies you've obtained via pokeradar chaining.
	egg			shinies you've hatched from eggs without the assistance of RNG.
	evolved			shiny forms you've obtained through evolution, as opposed to direct capture.
	faded			unobtained pokemon that CAN be chained with the gen IV pokeradar.
	re			shinies you randomly encountered at full odds.
	rng			shinies obtained through RNG methods.
	sr			shinies you obtained by soft resetting.
	trade			shinies you obtained through trades, distribution events, Wonder Cards, etc.


	Feel free to adjust these definitions, add new statuses, and/or tweak the visual stylings as you see fit!

---------------------------------------------------------------------------------------------------------------------------------

// UPDATING THE TRACKER

        -------------------------------------
	>> UPDATING LOCALLY [OFFLINE MODE] <<
        -------------------------------------

	If you'll be using your Shiny Tracker locally (i.e., not uploading the HTML files to a webspace or pasting
	their contents into webpages), here's how to manage your progress.

	* Right-click on the HTML file that contains the species whose status you wish to update.
	* Select "Open with" in the dropdown menu.
	* Choose a text editing program like Notepad or Notepad++ from the suggested list.

		(At this point you're going to see all of the HTML and CSS laid out before you,
		but if that feels overwhelming, try not to worry. I got you!)

	* Use Ctrl+F or the "Find" function to search for the three-digit National Dex number of the target species.
	* In the <img> string for that pokemon, change the class attribute value to match the new desired status.
	* Save!

	You'll see your changes reflected the next time you open or refresh the HTML file in your browser.

       		---------------------
		>> A QUICK EXAMPLE <<
        	---------------------

		So let's say you just hatched a shiny Bulbasaur. Congratulations! You would then:

		* Open shinytracker-all.html or shinytracker-geni.html in Notepad.
		* Use Ctrl+F to search for 001.
		* Change the existing <img class="blank" src="pokes/001.png"> to <img class="egg" src="pokes/001.png"> .
		* Save!
		* Repeat the process with any other applicable pages.


	Please note that making changes to one HTML file affects ONLY that specific HTML file.
	Updating Bulbasaur in shinytracker-all.html will NOT update Bulbasaur in shinytracker-geni.html or vice versa;
	you'll have to edit both individually.


        -------------------------------------------------------
	>> UPDATING WITHIN YOUR OWN WEBSPACE [INTERNET MODE] <<
        -------------------------------------------------------

	If you've uploaded the Shiny Tracker HTML files to your own webspace or have pasted their contents into
	existing webpages, you'll follow much of the same process above for the offline folks.

	* Access your webspace and open your Tracker page(s) in your website editor.
	* Use Ctrl+F or the "Find" function to search for the three-digit National Dex number of the target species.
	* In the <img> string for that pokemon, change the class attribute value to match the new desired status.
	* Save!
	* Repeat the process with any other applicable pages.
	
	Please note that making changes to one HTML file affects ONLY that specific HTML file.
	Updating Bulbasaur in shinytracker-all.html will NOT update Bulbasaur in shinytracker-geni.html or vice versa;
	you'll have to edit both individually.

      	----------------------------------------------
	>> A QUICK NOTE ABOUT MENU SPRITE LOCATIONS <<
       	----------------------------------------------

	Wherever you're keeping your Shiny Tracker HTML, those files will be looking for a subfolder within
	that same directory called "pokes" for the pokemon menu sprites.

	So what does that mean?

	For the webmasters among you, it means you'll need to upload the "pokes" folder and its contents to
	your webspace within the same location as the HTML files to prevent broken images.

	If you're viewing the Gen IV Shiny Tracker files locally in a browser by using the "Open With..." feature,
	the images should be fetched appropriately from the "pokes" subfolder, so long as you don't move it.

---------------------------------------------------------------------------------------------------------------------------------

// CONCLUSION

        --------------------
	>> SPECIAL THANKS <<
        --------------------

	Special thanks to the amazing folks at the Poke Classic Network for bringing gen IV trading back to us,
	and especially to Aethena and Anders for feedback, suggestions, and the inspiration to bite the bullet
	on this adaptation project with their own awesome tracking methods and spreadsheets.

	Team MAIL is here!
