Red Hat Bugzilla – Bug 679955
— entity in admonitions displayed in locally built guides but not staged copies.
Last modified: 2011-03-23 00:54:25 EDT
Description of problem:
I have a number of admonitions in a guide with titles that contain the — entity:
<title>Note — Bundled JBoss Enterprise Application Platform restrictions</title>
When I build locally these are displayed correctly in both html and pdf output formats. When run through publican brew however I found that in the resultant package both the pdf and html output is missing the dash.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. Create a chapter in the guide with doctype tags as follows:
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "Technical_Reference_Guide.ent">
2. Add an admonition to the chapter that has a title which contains an — entity.
3. Build locally, observe that the output contains the dash.
4. Build remotely (brew), observe that the output does not contain the dash.
Brewed copy does not contain the — at all.
Admonition titles with — entity.
Rudi has informed me that I can just replace the docbook entity with the appropriate unicode character but I thought I would report anyway as this *should* work.
I am attaching screenshots of the local and remote build results so that you can see what I mean.
Created attachment 480599 [details]
Created attachment 480600 [details]
After further investigation I have determined that the entities declaration was not included at the top of all chapters in the relevant book. Fixing this and re-submitting to brew the issue appears to have gone away.
I'm going to close as I am now of the belief that my PEBKAC.