Clifton Oliver wrote:
> I'm fairly new to DocBook which is what I am using XXE Pro 3.6.0 for.
> 
> I am trying to create a Chapter document to pull together a set of
> individual refentry files. I don't seem to be able to use XXE's Include
> feature to do this. Yet if I use a text editor and hand code the
> include, I see it as a referenced document the next time I use XXE to
> open the Chapter document.

This is unpractical and error prone. I hope for you that XXE does not
display a red icon in the status bar. This would mean that you have
created an invalid chapter.



> Am I missing something? Or breaking a rule of DocBook usage?

[1] Create the chapter using File|New (any chapter template will do) and
immediately *save* *it* using File|Save As.

[2] Open the document containing the refentry elements. Strongly
recommended: give an "id" attribute to all refentry elements.

[3] Select all the refentry elements (here I suppose that these elements
are siblings). For example, select the first one using the  node path
bar, then Ctrl-Shift-Click anywhere in the last one. (Personally, I
always use Esc-Left Arrow several times.)

[4] Press Ctrl-Shift-C (Edit|Reference|Copy As Reference) to copy a
reference to the N selected refentry elements. (You'll see a gray "[N]"
in the clipboard control found in the status bar.)

[5] Switch to the chapter.

--> Here, there are many places where you can paste your refentry
elements. <--

This has nothing to do with inclusions and with XXE. This has to do with
the content model of DocBook (select the chapter and press Shift-F1
(Help|Show Content Model) to learn what you can do.)

Example 1: Select all the elements after the title of the chapter and
press Ctrl-V (Edit|Paste) to replace them with references to your
refentry elements.

Example 2: Select the last element of any section contained in the
chapter. Normally, if you've just created this chapter, suffice to click
anywhere the empty para element contained in the blank section of the
new chapter. Then press Ctrl-W (Edit|Paste After) to paste references to
your refentry elements after this last element.

In all cases, you'll see your included refentry elements displayed with
a blue/gray background.




Reply via email to