Help |
Home
Technical Notes
The documents listed below are probably of interest only to website designers and site managers.
For my opinions about website design, see the FAQ.
Style
- The Elements of ATI Style: A style sheet that summarizes some of the grammatical, spelling, organizational, and HTML principles I observe on Access to Insight. I refer to it often.
Shell scripts, etc.
In keeping with the unfortunate long-standing tradition that calls for software code to be as incomprehensible as possible, I have left out detailed explanations. To make sense of any of these, you'll just have to plod through the comments. Use at your own risk.
- makeweb. START HERE. Installs .html files into the website from the "staging" directory.
- _install-html. Used by makeweb. Installs a single HTML file onto the website.
- htmlstamp. Used by _install-html and makebulk. Applies a custom time stamp to an .html file.
- stamp_rev-date A simple wrapper to htmlstamp. Used by most Makefiles. Applies a "revision date" stamp to an .html file.
- stamp_bulkversion A simple wrapper to htmlstamp. Applies a bulk download "version number" stamp to an .html file.
- do-makefiles. Looks for any makefiles in the website and make's 'em.
- maketech. Updates the tech directory (in case some of the tech files that reside ~/bin are modified).
- makebulk. Updates the bulk.zip file, which contains the entire website.
- BULKMAKE. The MAKEFILE used by makebulk.
- bulkfix. Used by makebulk to clean up specially tageed text in certain files in bulk.zip.
- bulkfix.sed. "sed" script used by bulkfix.
- bulkfixlist. Prepares the list of files that will be filtered by bulkfix.
- _newbulkroot. Used by makebulk. Creates a new bulk file (atibulk.zip) from bulk.zip, so that the files reside in a new root directory.
- bulklist. Prepares a nice list of files from "bulk.zip".
- bulk_allfiles.hdr. HTML header for the "allfiles" list.
- bulk_allfiles.tail. HTML footer for the "allfiles" list.
- bulk_newfiles.hdr. HTML header for the "newfiles" list.
- bulk_newfiles.tail. HTML footer for the "newfiles" list.
- bulklist.sed.1. Ugly "sed" script #1.
- bulklist.sed.2. Ugly "sed" script #2.
- bulklist.sed.3. Ugly "sed" script #3.
Revised: Mon 10 February 2003
http://www.accesstoinsight.org/tech/index.html