HELP file for !IndexSort Program written by ATOMIC SOFTWARE © R.W.Darlington 2009 This program is especially built for only one purpose: To be used with the Wild Flower Finder webset of HTML pages. It will run properly if put inside the directory 'Pages'. [But it can be put elsewhere on a hard drive, and will look ONLY in the directory which is one level further up]. It will act only upon the 'SubjectIndex/htm' file. When run, it will put into alphabetical order only the names of flowers in a menu. It will only do this to HTML lines beginning with:
If the URL name misses the '../' bit out, then contrive to put it in, by going down a directory level then back up a level. where [Flower Name] is the name of the flower. It will put all the flower names in alphabetical order (ignoring hyphens, (), spaces, [] and ??'s), leaving untouched any other part of the HTML file. It will then re-save the file, OVER-WRITING the original! IMPORTANT --------- Every Subject Index entry should always begin with
and -------------------------- Before it does anything at all, it checks the validation of paired with which is crucial to the program working correctly. If those two are not paired correctly, it issues a validation error, and stops. ADJACENT DUPLICATION OF ENTRIES ------------------------------- It also checks adjacent lines for duplicats. If it finds any duplicates, it flags them up. Naturally, after it has sorted them, there may be more adjacent duplicates that it missed the first time around; but they will get picked up the next time the program is run. ----------------------------------------------------------------------------- NOTES FOR RWD: In particular, it WILL NOT move a flower manually placed in the wrong Aa section into the correct Aa section. You must put extra entries at the foot of the page between these two : --- For sub-entries like, for instance:
Carnivorous plants
Sundews Then the 'Carnivorous plant may drift in relation to its sub-indexes, unless it doesn't beging with '
Carnivorous plants' So to keep them together, then put a character between the '
' and the '' I have chosen to insert the colon ':' character, like so:
: Carnivorous plants
Sundews It wont stop them drifting out of alphabetical order, but they will all stay together. So all you need do is put them back in order manually every so often. --- ----------------------------------------------------------------------------- HOW TO USE IT: A better way of adding extra flowers is to put them at the foot of the HTML file, between these two HTML : It will then put them into the correct Two-letter (for instance, Cr) index section, and then sort them into alphabetical order within that two-letter index section. ----------------------------------------------------------------------------- Before it does anything, it backs up the SubjectIndex/htm file as SubjectIndexBAK/htm. It leaves untouched all other HTML lines, including those under the headings: WORTS: BERRIES: BUTTERFLIES: BANES: etc, as these start with
and not
You have to do those exceptions manually.