We describe how to install and operate the html script we've designed to replace the bespoke server-side machinery used to print the Dayton Experiment and follow on DIG Handbooks.
One or more "launch" pages will be configured to find and format pages starting from a short list of links. A Frame plugin will recognize this list and offer to "download" the exported version. Printing starts with the list and proceeds by tiers finding pages progressively further along the paths made by links.
Prepare a launch page. Add a Frame with this markup:
http://ward.dojo.fed.wiki/assets/pages/print-all-pages/listed.html HEIGHT 300
The first line of markup (folded above) accepts parameters after a ? mark and separated by & signs. Unspecified parameters are assumed to be =1.
Say sequential=3 to to print the first three tiers of pages in the order they are encountered starting with tier 1, the list on the launch page.
Say alphabetical=2 to print the next two tiers in alphabetical order. One more tier is acknowledge and specifically omitted from the print.
See Print Strategies for how to organize content into tiers sometimes called the story and garden.
During the download operation the titles that are encounter in each tier are reported in the order that they are found, not as printed in the alphabetical tiers.
Links on pages introduce titles for the next tier but these are only printed if they are found present in the sites chosen for printing. Titles outside of these bounds are marked with ✘ and show in gray in the print.
Print looks for pages where the launch page is located. Add a Roster plugin to expand this space. When a title names a page that has twins, the most recently edited page will be chosen. Note, this precedence differs from the usual collaborative link conventions.
ward.dojo.fed.wiki eric.dojo.fed.wiki code.fed.wiki.org
Upon completion a file draft-pages.html will be written to the browser's Downloads area and a Print Statistics page is added to the lineup.
Open the draft-pages.html file in your browser to confirm that the desired pages are present. Use the browser's Print dialog to send the result to a printer or convert it to pdf for sharing with others.
Examine the Print Statistics to be sure it is as expected. Pages that presented some problem while printing will be listed collected under the specific complaint. Clicking these links may not open the newest version of twins. Choose the newest twin to understand the complaint.