[publican-list] [Bug 706302] RFE: Improvements to publican-jboss brand for better docs bug BZ integration.

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=706302

--- Comment #5 from Jared Morgan <jmorgan at redhat.com> 2011-05-19 23:31:13 EDT ---


(In reply to comment #3)
> (In reply to comment #0)
> > 
> > 1. Update the Feedback.xml file to match the one used in the Messaging User
> > Guide [1] (Feedback.xml file attached to this issue)
> 
> Please submit these kinds of files as patches against the current package.

Sure thing. I'll check with rudi about the correct way of doing this.

> 
> > 2. Include entities used in the attached Feedback.xml file in the
> > publican-jboss brand so they are automatically added to the .ent file when a
> > new book is created. (Messaging_User_Guide.ent file attached to this issue)
> 
> This functionality does not exist and won't be added. Entities are the bane of
> translation and DocBook5 has very limited support for them, their future is not
> bright.

I also try to avoid entities as much as possible as well because of the
problems with translation. 

I don't think translation would be affected in this instance however. The
substitutions in this case would only be for Bugzilla Product and Component
names, and the BZ URL string, which from what I can tell are not translated
into other languages in the BZ web interface (correct me if I'm wrong).

If entities are not the answer here, do you have any suggestions how I could
get around the problem of editing the BZ URL in what would be uneditable text? 

> 
> FYI there is currently no maintainer for the jboss brand, so if you know anyone
> with a FAS account who wants to be the maintainer let us know and we'll get
> them hooked up.

I think Rudi and I discussed getting me sorted out with the publican-jboss
package maintenance. But I think it has slipped by the wayside. I'll chat to
rudi about it, Jeff.

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.