All in the <head>

– Ponderings & code by Drew McLellan –

– Live from The Internets since 2003 –

About

Paper-centric authoring environments

10 November 2003

Modern document authoring software works mainly on the principal that the author wishes to see what they’re getting – hence the whole WYSIWYG principal of accurate visual representation. I’ve been writing some pretty big documents the last few days in MSWord, and have come to the conclusion that I’d basically prefer not to see what I’m getting. I’d rather work with an interfaced that was focused on helping me write what I need to write rather than caring about what the final presentation format will be. I find that whenever I use Word I end up messing around with the formatting, trying to get it to do what I want and look how I intend for it to look, and always fail. The end result is that the content suffers and the presentation is still pretty shoddy.

I don’t think this is simply a discipline issue – it’s more like a usability problem to me. I usually spend my day working with web technologies that enable me to separate style from content (XHTML and CSS) only choosing to combine them in the final presentation format (a browser on screen). As soon as I start using Word, all this goes out the window and I’m forced into working with a printed document on screen. The default page layout even looks like a piece of paper. This is fine for knocking out a quick covering letter or what-have-you, but useless for authoring a document with a complex structure (like a technical brief or a proposal document).

Most documents more complex than a letter involve some sort of structure, with sections, subsections and so on. Yet all of this is presented and manipulated in the linear format of the output medium – and for what benefit? Why does Word (and editors of its ilk) trap us into a paper- and presentation-focused authoring environment rather than providing an environment more focused on content production? It’s such a poor and unhelpful way to compose a structured document.

This may require some sketches. I’ll get my pencil sharpened.

- Drew McLellan

Comments

  1. § Dysfunksional.Monkey: I’ve been thinking the exact same thing for about 6 months now. And I’ve been thinking long and hard about viable solutions. I’ve got one or two, but would be very interested to hear your ideas - sometimes, it takes another perspective to really get the ball rolling.
  2. § Michael Z.: Back when I was regularly writing essays in university, I would spend most of my writing time in MS Word’s outline mode (Word 5 on the Mac).

    It was fantastic for organizing a long paper, and it’s integration with style sheets made formatting go very quickly. This also enforced a sort of separation between content and presentation—even if I was tempted to spend time formatting before I finished writing, this was a separate activity and used a slightly different interface.

    Do these features still work as well in MS Word?
  3. § Drew: Outline view is still there - but seems to just give every block-level element a bullet mark. The most useful tool for working with structured documents seems to be the Document Map which displays the heading levels in expandable tree format, but even that it limited.
  4. § Peter: Recently, I read a nice related discusssion (with regard to PDAs) at Writing on your palm.
  5. § mike: I highly recommend OpenOffice!
    There are builds for Windows and Mac OS X, amongst others...
    As well as handling MS Word documents perfectly, its own file format is sort of like xml - which is great ;)
    It also happily exports any document to pdf! And it’s free!!!
  6. § Brian: I’ve always used Framemaker for long and highly structured docs. Bit of a learning curve and an old fashioned interface but, it’s solid as a rock.
    The latest incarnation combines the old ways with SGML/XML/DTD et al..... a bit too scary for me at the moment as I really don’t have the time (or balls!) to experiment with all the new features on a live job ;0)
    Features here http://www.adobe.co.uk/products/framemaker/newfeatures.html
    Tryouts for Windows and Mac are available FOC.
  7. § Jesse: Word with CSS feature.. I can’t think of anything but it must be out there. You could always type it all out in DW MX 2004... then maybe copy/paste the web page into Word, although it is always hit or miss with the formatting.

    Just type in XHTML from now on ;) Down with the .doc!
  8. § Brian: Mmmm.... been thinking about this a bit more.
    Some years ago I/we used Ventura publisher, now this was pretty hard going but in those days we ran GEM as an add on to DOS!
    All text was processed in WordPerfect and all drawings were done in Gem draw. Ventura provided the glue and the stylesheet, it made a superb job of it. Being an awkward bugger though, I found the stylesheet thing a real pain; make one small change to that stylesheet and all the docs using it were knackered.... a bit too relative I suppose, but thinking back it had the right idea and probably still does. May be worth a revisit?
    Those were the days eh? Software cost? maybe £1000, hardware cost? well about £3k for the 286 pc and the same again for a 300dpi HP laser...
  9. § monkeytype: I am amazed that nobody has mention latex yet!

    Ports are available for basically any operating system you can think of. Have a google for it, you may be very pleasantly surprised!
  10. § Mike: I do all my document writing in ActionOutline

    I’ve written huge docs in it that have gone through many revisions and it allows you to do cool things like link to disk files and urls etc. Then at the end you can export its as RTF or HTML or whatever (Only wish they had an export to XML function).

    In fact my life lives in outlines these days. Instead of hundreds of little .txt files with notes scattered around directories on my laptop I have them in the organised tree structures which are quickly accessed.

    Adding new nodes is simple too.
    Windowskey-A (opens it)
    INSERT (creates new node)
    Type node name
    ENTER (confirms)
    TAB (switches to window)
    Type note
    ESC (saves and minimises)

    Woo! Long live outlines!
  11. § Stephanie: This is a constant problem for me. I Googled forever and finally turned up two useful links on stylesheets in Word:
    a Microsoft tech doc
    a Woody’s Office Watch column

    This isn’t to say I’ve figured it out, although some people on my blog seem to know what they’re doing. Good luck.
  12. § eye2brain: The brand new version of Office is XML based. I haven’t installed my trial version yet, but for once I am optimistic.
  13. § David S: I would also recommend using Outline mode. Then you can focus on the structure. Also, word allows for section breaks (in the breaks dialog). You can break things up nice and logically that way.

    Mix that with proper headings and what have you and you end up with a nice document.
  14. § James: The earlier mention of LaTeX is a step in the right direction, but your lament over having to handle formatting while typing your document, to me, screams out for LyX.
  15. § Stephanie: I finally gave up and got the Office 2001 Bible from the library. I’ve studied their style chapter and posted what I’ve learned.

    Hope it helps someone besides me.

Photographs

Work With Me

edgeofmyseat.com logo

At edgeofmyseat.com we build custom content management systems, ecommerce solutions and develop web apps.

Recent Links

Affiliation

  • Web Standards Project
  • Britpack
  • 24 ways

About Drew McLellan

Photo of Drew McLellan

Drew McLellan has been hacking on the web since around 1996 following an unfortunate incident with a margarine tub. Since then he’s spread himself between both front- and back-end development projects, and now is Director and Senior Web Developer at edgeofmyseat.com in Maidenhead, UK (GEO: 51.5217, -0.7177). Prior to this, Drew was a Web Developer for Yahoo!, and before that primarily worked as a technical lead within design and branding agencies for clients such as Nissan, Goodyear Dunlop, Siemens/Bosch, Cadburys, ICI Dulux and Virgin.net. Somewhere along the way, Drew managed to get himself embroiled with Dreamweaver and was made an early Macromedia Evangelist for that product. This lead to book deals, public appearances, fame, glory, and his eventual downfall.

Picking himself up again, Drew is now a strong advocate for best practises, and stood as Group Lead for The Web Standards Project 2006-08. He has had articles published by A List Apart, Adobe, and O’Reilly Media’s XML.com, mostly due to mistaken identity. Drew is a proponent of the lower-case semantic web, and is currently expending energies in the direction of the microformats movement, with particular interests in making parsers an off-the-shelf commodity and developing simple UI conventions. He writes here at all in the head and, with a little help from his friends, at 24 ways.