Current automatic scheme: 

Each gallery folder now has a _generate.sh Bash script to build its own
gallery or galleries automatically, and ../build/generate-examples.py builds 
all examples/ galleries at once by running all _generate.sh scripts.  These 
automate the former and now-dated _HOW-MADE.txt instructions in examples. 

View online:

https://learning-python.com/thumbspage/examples/3.0-screenshots/_generate.sh
https://learning-python.com/thumbspage/examples/3.0-upgrades/_generate.sh
https://learning-python.com/thumbspage/build/generate-examples.py

See also: 'UserGuide.html#Running thumbspage' for alternative techniques, such 
as input-file redirection, 'here' documents, and 2.3 input-override configs.


----
Older notes:

See each folder's _HOW-MADE.txt for gallery-build details.

([3.0] thumbspage no longer uses shrinkpix on example images: it can degrade 
quality of some PNGs, and the examples/ folder was split off from the program 
download long ago due to its growing size.  See the online copy of examples/.)

thumbspage's cheat sheet for using shrinkpix on a tree with a separate _collector folder.

To shrink images in the entire examples/ tree for online use:
   To check for large images:
       $C/thumbspage$ py3 $C/shrinkpix/shrinkpix.py examples -listonly

   Run shrinkpix.py and then its collect*.py on examples/, routing _shinkpix_all_originals/ to _private/
       $C/thumbspage$ py3 $C/shrinkpix/shrinkpix.py examples
       $C/thumbspage$ py3 $C/shrinkpix/collect-unshrunk-images.py examples _private

   [Defunct: move by command or file manager (unless + _private in 1st cmd)]
       [/MY-STUFF/Code/thumbspage$ mv examples/_shrinkpix-all-originals/ _private/]

   If ever need to restore originals (e.g., for a new shrinkpix):
       [Run restore script on _private/_shinkpix_all_originals/ and rsync back to examples/]

       $C/thumbspage$ py3 $C/shrinkpix/restore-unshrunk-images.py _private/_shrinkpix-all-originals
       $C/thumbspage$ rsync -avh _private/_shrinkpix-all-originals/ examples/
       $C/thumbspage$ mv -f _private/_shrinkpix-all-originals ~/Desktop/_shrinkpix-all-originals--PRIOR
       --and reshrink and recollect per above--

After new additions:
   To find new large images:
       $C/thumbspage$ py3 $C/shrinkpix/shrinkpix.py examples -listonly
       [this one is normal: thumbspage/examples/mixedtypes/space-monkey.gif [599070 bytes, not changed]]

   Run shrinkpix.py to individually shrink any new images added:
       $C/thumbspage$ py3 $C/shrinkpix/shrinkpix.py examples/folder/newimage.jpg
       --or: all in a folder at once--
       $C/thumbspage$ py3 $C/shrinkpix/shrinkpix.py examples/folder

   Then move saved originals to _shrinkpix-all-originals by rerunning collector script
       $C/thumbspage$ py3 $C/shrinkpix/collect-unshrunk-images.py examples _private  [-listonly]?

And rebuild thumbspage galleries for new image info per the examples' _HOW-MADE.txt files.