TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: Can any authoring tool directly pick data from the database or XML files?
Subject:Re: Can any authoring tool directly pick data from the database or XML files? From:sburnf -at- au1 -dot- ibm -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 9 Nov 2004 23:11:20 -0700
Hi Rabia -
I've heard of people doing this sort of thing in FrameMaker using MML.
This is from the introduction to the MML Reference, which is a PDF
in the FrameMaker OnlineManuals directory:
"FrameMaker® includes support for a markup language called MML
(Maker Markup Language). You can use any standard text editor
to create an MML file. Later, you can open the MML file as a
FrameMaker document or import it into a FrameMaker template."
What you would need is a process that writes out each message from
the DB to a text file (called, say, messages.mml) and adds an
appropriate MML tag to each field, so each line might look like this:
<msgid>999<msgtext>A bad thing happened
You import messages.mml to a chapter file in FrameMaker. This is an
otherwise empty Frame document that has the page headers and footers
plus paragraph tags corresponding to <msgid> and <msgtext>. When you
want to update the manual, you just write out the current messages
from the database, open the book in FrameMaker, import the latest
messages.mml, and print to paper or PDF or whatever.
There's a bit more to it but that's the basics. The MML Reference
has samples to help get you started.
FrameMaker imports XML files too, so that's another possible route.
Regards
---
Stuart Burnfield
> We need to create a dictionary for the messages in our application
> that users can easily reference... Currently our messages are
> stored in OCX and XML files. These might be stored in the database
> if the need arises. What I need to know is, if there is any tool
> that can directly pick these messages from the database/OCX/XML
> files and enable me to generate a user friendly output with
> minimum work from my side. The core issue is that we do not want
> to maintain a separate set of messages for the dictionary. We
> want the message content to be maintained only in the back end.
ROBOHELP X5 - SEE THE ALL NEW ROBOHELP X5 IN ACTION!
RoboHelp X5 is a giant leap forward in Help authoring technology, featuring all new Word 2003 support, Content Management, Multi-Author support, PDF and XML support and much more! View an online demo: http://www.macromedia.com/go/techwrldemo
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.