Per Thomsen wrote: > I'm a relative newbie to DocBook and XXE. I've had great luck with a > couple of books I've been writing for a project I'm working on. Now I am > starting to write man pages, and I'm using the refentry template from > within XXE standard (File -> New). > > My problem is that I'm not able to add a 'sub-section' to my document. > 'refsect1', etc are not available to be added in a 'para' inside a > 'refsection'. When I read documentation on the refentry DTD, it seems to > me that I should be able to add lower-level sections to a refsection. > > What am I missing? How can I have sub-sections (all I want is one level > down)? Should I use a different template? > > If my question is a FAQ, I'm sorry, but I have not been able to find > anything about it on the XMLMind web site. >
You question has nothing to do with XMLmind XML Editor. It is related to DocBook. In DocBook: --> A refsection can contain other refsections. It cannot contain refsect1, refsect2, refsect3, etc. --> A refsect1 can contain refsect2, which in turn can contain refsect3, etc. It cannot contain refsections. Our refentry template is based on refsections and not on refsect1, refsect2, refsect3, etc, because refsections are more flexible than refsect1, refsect2, refsect3, etc (e.g. in a future version, you'll be able to promote and demote them). If you prefer to use refsect1, refsect2, refsect3, etc: * Select *topmost* refsection and use Edit|Replace to replace it with a refsect1. (If you have already created several top refsections, you'll need to delete all of them except one.) * OR modify the refentry.xml template found in XXE_install_dir/addon/config/docbook/template/
