🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: adobe.framemaker.sgml
Article #476

Need advice creating XML files - content to be used for a book

#476
From: michael_randall
Date: Sun, 21 Dec 2008 22:29
32 lines
1998 bytes
Hi,

I'm not sure how to proceed here. I'm just beginning with structured frame and XML. Every thing I have read provides small examples of using XML in FrameMaker (proposal). We create user help manuals/books that follow a similar structure: cover, legal, contents, preface, multiple chapters, glossary, appendix, index.

However, I'm not sure the best way to design my xml pages to work within that structure. My understanding of XML is that it should be in small topics, for example if our product has 2 features we could create two xml files such as:

<feature name="WonderThing1">
<description>
text text text text text text text text text text text text
</desription>
<procedure>
<step number="1">
<step number="2">
</procedure </feature>

<feature name="WonderThing2">
<description>
text text text text text text text text text text text text
</desription>
<procedure>
<step number="1">
<step number="2">
</procedure </feature>

I could also seperate procedures from conceptual information by creating seperate xml pages for feature vs concept info.

So, what is the best practice? Should I create an XML page that matches the structure of each part of the document or is there a (simple) way to create xml pages that are similar to what i mentioned above and then pull those into structured Frame document?

Any advice/best practices would be appreciated.

Thanks,
Michael
Technical Details
Message-ID: <59b75418.-1@webcrossing.la2eafNXanI>
Path: arc1-ca.pugleaf.net!g2news2.google.com!news2.google.com!news.glorb.com!news2!newshub.sdsu.edu!webcrossing

Show Full Headers
Complete Article Headers
X-Google-Thread: fcc08,1df8805d365403b6,start
X-Google-Attributes: gidfcc08,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
From: michael_randall@adobeforums.com
Path: arc1-ca.pugleaf.net!g2news2.google.com!news2.google.com!news.glorb.com!news2!newshub.sdsu.edu!webcrossing
Newsgroups: adobe.framemaker.sgml
Subject: Need advice creating XML files - content to be used for a book
Message-ID: <59b75418.-1@webcrossing.la2eafNXanI>
Date: Sun, 21 Dec 2008 14:29:46 -0800
Lines: 45
MIME-Version: 1.0
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: 8bit