2003-12-08

prog: (coffee)
2003-12-08 10:11 am

Phootnotes Phollowup

  • I didn't know about auto-linking either; I probably should have edited my post to trick LJ into thinking that wasn't a URL, but that would have meant looking up character entities for key letters, and I was too lazy. I will try it in this post to see if it works.

  • What I will do for now is:
    • Use inline links to toss out informal references to large websites (things like "http://adobe.com"), and create footnotes, with last-update/last-access timestamps (interesting!), for highly specific Web-based document references. (Ahh, crap, there goes my trick-LJ theory. Well, it was worth a shot.) (UPDATE: No, no, it did work, I just momentarily forgot how to use numeric HTML entities. Doyf!)

    • Continue to wrap both raw URLs and inline-annotated text in DocBook's ulink element, and will later on worry about dinking around with the HTML and PDF style sheets to make it look nice, perhaps with different behavior if it's the child of a cite element. (And maybe I can make a clever print-out stylesheet that does exactly what the Web one does, except that it barfs all the URLs out onto the page first...)

    • Get myself a style manual. I mean: Duh, jmac. According to O'Reilly's Style Guide, that house uses the ol' Chicago Manual. Why don't I have a copy of this? An easy fix.

    • Actually read the aforementioned ORA style guide, rather that just Google up its link to look like a shmartash. No, ORA isn't my intended publisher (for I don't have one at all, at this time), but one could do worse for tech-book style advice.

  • prog: (Default)
    2003-12-08 10:42 am

    (no subject)

    I had an awesome dream that I saw "The Terminator", the first one, and it was horrible.Ultra-violent, kind of gross, mostly stupid dream imagery )
    prog: (Default)
    2003-12-08 11:44 pm

    Example.com

    Found RFC 2606 today (with a nudge from [livejournal.com profile] daerr), which reserves example.com and related domains for safe use in documentation. It also declares that the .example TLD can never actually exist and is therefore similarly safe, which is theoretically useful; I'm not convinced that "anything.example" looks like a domain, versus "anything.com". Guess it's time to break out the context stick.

    Pretty neat, anyway. If you're into that sort of thing...