Hi, I'm using XXE with DocBook and wish to use shared text entities as explained here: http://www.sagehill.net/docbookxsl/ModularEntities.html. I've read your documentation about "Managed and non-managed references to external documents" (inserted below) and it looks like it should work but I'm a little confused. Will XXE expand the entity in the XXE GUI but keep the entity untouched when saving the file or will the entity be overwritten with its text.
Thanks, /Kenneth ---- Managed and non-managed references to external documents Currently, XXE only knows how to preserve the physical structure of: references to external entities containing a single element, xi:include elements pointing to a single element. These references are said to be managed. In the document view, these references are replaced by the elements they specify and the referenced elements are marked as being read-only. Tip Non-editable elements are displayed with a light-gray background (this is specified in the CSS style sheet using the :read-only extension pseudo-class -- see Power User's Guide). Being inside a non-editable node is also clearly indicated by the node path bar. Tip See Edit|Document Reference|Edit Referenced Document to learn how to conveniently edit the documents specified by such managed references. Preserving the physical structure means that when you modify a document containing such managed references and you save it to disk, XXE will generate a file containing the proper &entity_name; and <xi:include href="location#xpointer"/>. Currently, XXE does not know to preserve the physical structure of: references to external entities containing multiple elements, references to external entities containing a mix of text and elements, xi:include elements with parse="text", xi:include elements pointing to the root element plus sibling comments and processing instructions, etc. These references are said to be non-managed. In the document view, these references are replaced by the nodes they specify and the nature of the reference (external entity or xi:include) is definitely lost. This means that when you modify a document containing such non-managed references and you save it to disk, XXE will generate a ``flat'' XML file. -------------------------------------------------------- Kenneth Johansson Technical Documentation Manager Sectra Imtec AB Teknikringen 20 E-mail: ke-joh AT sectra DOT se SE-583 30 Link?ping Phone: +46 13 23 52 00 SWEDEN Web: http://www.sectra.se
