🚀 go-pugleaf

Lynne,
     I tried the process you described, but something isn't happening the way I expect it to. When I import the file, it imports everything in the file, including all the comments and markup as text. I can't figure out how to specify the specific entity I need to use in the Frame document.

Let me expand on my original post and see if that can help clarify matters somewhat.

As I noted in my original post, I am working with a military XML DTD for technical manual development. In addition to the DTD, there are 12 external files containing entities required in the development of the manual. Each file contains multiple entities and these entities vary in length and complexity from simple text statements to literally hundreds of lines of markup and text.

1. Each of the 12 external files is declared in the DTD this way:

!ENTITY % prod_boilerplate PUBLIC "-//USA-DOD//ENTITIES MIL-STD-2361 2361 PRODUCTION Boilerplate REV 3.21 20080716//EN" "boilerplate/prodboil.ent"
%prod_boilerplate;

2. I listed each of these files in the structapps.fm file using the ENTITIES element with child PUBLIC element, for example:

Entity locations
     Public ID: -//USA-DOD//ENTITIES MIL-STD-2361 2361 PRODUCTION Boilerplate REV 3.21 20080716//EN
     Filename: boilerplate/prodboil.ent

3. As an example, here is the verbatim text from one of the entities in the prodboil.ent file referenced in the example above.

!ENTITY notices.dist.d.statement "<dist><d.statement>Distribution authorized to the Department of Defense and U.S. DoD contractors only for &notices.dist.determined-reason;, as determined on &notices.dist.determined-date;. Other requests for this document shall be referred to &notices.dist.determined-dod-office;.</d.statement></dist>"

As you can see, the entity contains markup information and nested entities, which are defined in other documents in the set of 12.

This is where I start beating my head on the wall, hence my questions.

a. Chapter 21 of the FM Developer�s Guide leads me to believe that FM treats each entity as a text inset and that if the inset contains markup, that the markup will be added to the structure of the document at the point of insertion. To that end, do I write a rule for each entity that I need to use? For example:

entity "notices.dist.d.statement" {
   is fm text inset;
   reformat using target document catalogs;
   }

b. The Dev Guide and Dev Reference repeatedly mention the Entity Declarations reference page. Is this part of the template file reference page set? If so, how do I use it to map these entities?

c. If I have followed the correct process to this point in identifying these entities to the software, how do I get the entity into a structured FM document?

Thanks for your assistance.

-Steve