[publican-list] sect3 weirdness with page breaks?

[Jared Morgan]

Hi Jeremy 

Thanks for taking the time to write to the list. 

<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. 

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. 

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. 

The DocBook official site [2] is the canonical source for DocBook element usage, however it isn't very user-friendly. 

I hope this information helps you, Jeremy. 

Kind regards 

Jared Morgan 
Content Author 
Red Hat Asia Pacific 
1/193 North Quay 
BRISBANE QLD 4000 

P: +61 7 3514 8242 
M: +61 413 005 479 

[1] http://hudson.jboss.org/hudson/job/JBoss_Documentation_Guide/lastSuccessfulBuild/artifact/JBoss_Documentation_Guide/target/docbook/publish/en-US/html_single/index.html 

[2] http://www.docbook.org/tdg/en/html/ 
----- Original Message ----- 
From: "Jeremy Cowgar" <jeremy at cowgar.com> 
To: publican-list at redhat.com 
Sent: Friday, March 19, 2010 9:34:49 AM 
Subject: [publican-list] sect3 weirdness with page breaks? 

I am brand new to creating docbook files, however, I believe I have done 
things correctly. I have: 

<chapter id="stack-words"> 
<title>Stack Words</title> 
<sect1> 
... 
<sect2> 
<sect3>... 
<sect2> 
<sect3>... 

On the first sect2, all sect3's appear on the same page. When I get to 
the bottom of the sect3 list (about 20) under the first sect2, then it 
wants me to go to a new page (normal). However, once it goes to a new 
page, each and every sect3 of the next set is on it's own page. 

You can see this at: 

http://www.josl.org/manual/en-US/html/stack-words.html 

The file that is responsible for that HTML is: 

http://www.josl.org/manual/Chapter_Stack.xml 

Am I doing something wrong or is this a bug in publican? 

Jeremy Cowgar 

_______________________________________________ 
publican-list mailing list 
publican-list at redhat.com 
https://www.redhat.com/mailman/listinfo/publican-list 
Wiki: https://fedorahosted.org/publican 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/publican-list/attachments/20100318/a74682e9/attachment.htm>