Help | Home

# Technical Notes

The documents listed below are mainly of interest only to website designers and site managers. And it's doubtful that even they'd find this stuff interesting. In keeping with a long-standing tradition that technical computer documents be as incomprehensible as possible, I have left out detailed explanations. As long as you know what shell scripts and comment lines are, you should be able to figure things out.

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 'n stuff

To make sense of these, you'll just have to plod through their comments.

- 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. Applies a custom "time 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 certain files in bulk.zip.
- bulkfix.sed. "sed" script used by bulkfix.

- 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: Sun 17 June 2001