RE: TECHWR-L: XML as Help Format

Subject: RE: TECHWR-L: XML as Help Format
From: Katie Kearns <kkearns -at- cisco -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 23 Oct 2001 11:48:22 -0700

At 11:25 AM 10/22/01 -0700, you wrote:

"Chris Knight" <cknight -at- attcanada -dot- ca> wrote:
> XML will allow us to store information in an appropriately structured way,
> then search, retrieve, and present, to both humans and computer programs,
> that information.

This is misleading. XML is only a family of markup languages. *It* won't
"search, retrieve, and present". Only applications that can parse and
process XML will do these things. I wouldn't mention this picky point, but
the rest of Chris's post may lead to misunderstanding of XML.

Right -- and a word document in and of itself doesn't do anything without Word to read it in and print it. I think the whole point is just that a different sort of interaction between programs is made possible using XML -- and that's true. The key phrase is "appropriately structured". Other formats are not appropriately structured.

Hence, to speak of WYSIWYG tools for XML doesn't
really make any sense either. The *file format* of any XML document is
ASCII. So Notepad is as much a WYSIWYG for XML as there could ever be. (The
WYSIWYG for an XHTML document is an XHTML-compatible browser or editor.)

Actually, there's a program called XMetaL Pro by softquad that is a sort of WYSIWYG program for XML.

You can customize it to do all sorts of great things, like tell it where your DTDs and stylesheets are, and it will let you edit your XML document while you see your text the way it would be displayed with the stylesheet. If that's not WYSIWYG, I don't know what is.

It allows writers to interact with XML and DTDs as if they were just writing a doc in framemaker or something. Apply your tags, and you can see how it looks. Only the tags are more useful, structurally, than just "Bullet", "Body", or "Heading".

By the way, you CAN create XML documents in Word and Frame. Just save them
as plain text. This does not involve conversion to/from XML. It is
conversion to/from ASCII, but the files are always XML.

And if you save a frame document as a MIF, it's being saved in a text format. So are GIFs. That doesn't mean you call them text files.


Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day. For details and online registration, visit

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: RE: *.dat file
Next by Author: Re: TECHWR-L: XML & the future of tech writing (topic from last week) LONG
Previous by Thread: RE: TECHWR-L: XML as Help Format
Next by Thread: Lawyers want to gut our tools

What this post helpful? Share it with friends and colleagues:

Sponsored Ads