Red Hat Bugzilla – Bug 561178
Publican 1.4: underscores prevent entity substitution
Last modified: 2010-11-23 23:20:26 EST
Description of problem:
Previously, entities declared in .ent files which contained underscores were correctly substituted when undergoing processing. Publican 1.4 no longer performs substitutions on entity names containing underscores (or, possibly, other characters?).
This may or may not be intentional, and therefore may or may not be a bug. It appears from a quick search that it is up to definitions in the processor as to whether underscores are allowed in entity names.
This is not an issue for the Deployment Guide as I've already converted the three entities defined therein to underscore-less versions, but this change may affect other books and cause confusion.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. Define an entity with an underscore in the book.ent file; use this entity somewhere in a DocBook XML file
2. publican build --langs=en-US --formats=html-single
in the resulting HTML, the entity shows up as, for example, "&MAJOR_OS;", instead of "Red Hat Enterprise Linux".
"Red Hat Enterprise Linux"
entity-with-underscore substitution worked in versions of publican prior to 1.4 (and, if memory serves, prior to 1.0).
publican-1.5-0.fc12 has been submitted as an update for Fedora 12.
publican-1.5-0.fc13 has been submitted as an update for Fedora 13.
publican-1.5-0.fc11 has been submitted as an update for Fedora 11.
publican-1.5-0.fc12 has been pushed to the Fedora 12 stable repository. If problems still persist, please make note of it in this bug report.
publican-1.5-0.fc11 has been pushed to the Fedora 11 stable repository. If problems still persist, please make note of it in this bug report.