Sharon Hasting wrote: > > You're absolutely right, of course - it would be terrific if I had the > opportunity to learn this product better. But it's a large doc set with lots > of pieces, and this isn't the only tool in use...so still need to learn > more. > > So, the first circumstance is what's preventing me from performing this task > successfully. I'm trying to insert the variable into a docbook para. (I must > take a moment to say that your tutorial documentation does not make it all > clear that you cannot do this, although I suppose it should have been > obvious.)
Yes. > > But more importantly - I still need to be able to create "variables" inside > my docbook XML documents that can be easily replaced for fast product and > company name changes. Is there a way I can do this? XMLmind XML Editor allows to do this using a technical standard called XInclude. As always, you don't need to know anything about XInclude to use it within our product. See procedure below. However, may be your customer/manager expects you to use an older technical standard called "references to internal/external entities". (Please ask her/him because this may be important.) If this is the case, you'll have to use another XML editor because unlike all the other XML editors, we don't support this standard. > Additional search of the > documentation doesn't find anything. > It works exactly like explained in the tutorial. Simply mentally replace XHTML <span> by DocBook <phrase>. [1] Create a new DocBook document. Let's call it variables.xml. [2] Click inside the first empty para. Use the Edit tool to insert a <phrase> element. [3] Let's suppose this phrase element is to contain the following product name: "Zenoss Enterprise Server". [4] Type in the above text, "Zenoss Enterprise Server", in the newly created <phrase> element. [5] Use the Attributes tool to give an id to the phrase element. Let's suppose you specify "product" as the value of the id attribute. [6] Repeat [2] to [5] to create new variables. [7] Close variables.xml. [8] Remove VATrates.html from the Include tool. Instead, add variables.xml. [9] Now open a document you want to variable-ize. Let's call this document: userguide.xml [10] Move the caret to a place where you want to insert a ``variable'': [a] Press Ctrl-Shift-R (Edit|Reference|Insert Reference), [b] Type the first few letters of the name of the variable (=id of a <phrase> element found in variables.xml), [c] Press Space to activate the autocompletion feature and/or use Up/Down Arrow. [d] Finally press Enter to commit your choice and insert the variable (=a *reference* to a <phrase> element found in variables.xml) into userguide.xml.
