<html><head><style type='text/css'>p { margin: 0; }</style></head><body><div style='font-family: Verdana; font-size: 10pt; color: #000000'><span>Hi Jeremy<br /><br />Thanks for taking the time to write to the list. <br /><br /><sect> tags are valid XML, and Publican permits these elements. What Publican doesn't do at the moment is render the <sect> elements correctly. Very few writers use the <sect> elements, because they have hierarchical constraints. <br /><br />For sections in your document, I strongly recommend using the <section> element. <section> elements are not hierarchical, so if you ever need to reorder sections in your books, you will find it quite easy.<br /><br />You may want to refer to PressGang's JBoss Documentation Guide [1], which will give you some welcome assistance concerning DocBook authoring. The guide contains a chapter containing very useful XML element usage guidelines. <br /><br />The DocBook official site [2] is the canonical source for DocBook element usage, however it isn't very user-friendly. <br /><br />I hope this information helps you, Jeremy. <br /><br />Kind regards<br /><br />Jared Morgan<br />Content Author<br />Red Hat Asia Pacific<br />1/193 North Quay<br />BRISBANE QLD 4000<br /><br />P: +61 7 3514 8242<br />M: +61 413 005 479<br /></span><br />[1] http://hudson.jboss.org/hudson/job/JBoss_Documentation_Guide/lastSuccessfulBuild/artifact/JBoss_Documentation_Guide/target/docbook/publish/en-US/html_single/index.html<br /><br />[2] http://www.docbook.org/tdg/en/html/<br />----- Original Message -----<br />From: "Jeremy Cowgar" <jeremy@cowgar.com><br />To: publican-list@redhat.com<br />Sent: Friday, March 19, 2010 9:34:49 AM<br />Subject: [publican-list] sect3 weirdness with page breaks?<br /><br />I am brand new to creating docbook files, however, I believe I have done <br />things correctly. I have:<br /><br /><chapter id="stack-words"><br /><title>Stack Words</title><br /><sect1><br /> ...<br /><sect2><br /><sect3>...<br /><sect2><br /><sect3>...<br /><br />On the first sect2, all sect3's appear on the same page. When I get to <br />the bottom of the sect3 list (about 20) under the first sect2, then it <br />wants me to go to a new page (normal). However, once it goes to a new <br />page, each and every sect3 of the next set is on it's own page.<br /><br />You can see this at:<br /><br /> http://www.josl.org/manual/en-US/html/stack-words.html<br /><br />The file that is responsible for that HTML is:<br /><br /> http://www.josl.org/manual/Chapter_Stack.xml<br /><br />Am I doing something wrong or is this a bug in publican?<br /><br />Jeremy Cowgar<br /><br />_______________________________________________<br />publican-list mailing list<br />publican-list@redhat.com<br />https://www.redhat.com/mailman/listinfo/publican-list<br />Wiki: https://fedorahosted.org/publican<br /></div></body></html>