<div dir="ltr"><div style="font-family:arial,sans-serif;font-size:13px">We're kicking the tires here with Publican 3.1.5, hoping to move our documentation set to Docbook. A couple head scratchers have come up -- any advice is welcome. :)</div>
<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">In just starting with a plain book ala:</div><div style="font-family:arial,sans-serif;font-size:13px">
<br></div><div style="font-family:arial,sans-serif;font-size:13px"># publican create --name New_Book</div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">
and then building html and pdf via:</div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px"># cd New_Book</div><div style="font-family:arial,sans-serif;font-size:13px">
# publican build --formats=html,pdf --langs=en-US --publish</div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">When viewing the output, we see title page content (from Book_Info.xml) in the HTML output, however it's completely missing from PDF output.  PDF's appear to be processed via html-pdf.xsl and then rendered to pdf via wkhtmltopdf.  Is html-pdf.xsl incomplete currently, or are we overlooking something?  The manual mentions title page output for PDF documents, so we're puzzled.</div>
<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">Our other question is regarding entities. They are working fine when used within normal paragraph content, however when trying to use one within Book_Info.xml like:</div>
<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px"><productnumber>&PRODUCTVER;</productnumber><br></div><div style="font-family:arial,sans-serif;font-size:13px">
<br></div><div style="font-family:arial,sans-serif;font-size:13px">The build will fail with:</div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">
Invalid format for version. Value (EMPTY) does not conform to constraint (^[0-9]) at /usr/bin/publican line 713.<br></div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">
So apparently validation happens before substitution.  Our intent would just be to abstract some of these items into a central entities file used by a collection of docs. Perhaps there is a better route to achieve this?</div>
<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">Again, we're new to this, so any input is appreciated.</div><div style="font-family:arial,sans-serif;font-size:13px">
<br></div><div style="font-family:arial,sans-serif;font-size:13px"><div>Thanks,</div>-- <br><span style="border-collapse:collapse"><font color="#333333" face="arial, helvetica, sans-serif"><b>James Pooton</b></font></span><div>
<span style="border-collapse:collapse"><font face="arial, helvetica, sans-serif">videoNEXT Federal Systems, Inc.</font></span></div></div>
</div>