[publican-list] [Bug 688585] Accented letters in book or article title

[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=688585

--- Comment #2 from Jeff Fearn <jfearn at redhat.com> 2011-03-17 19:08:37 EDT ---
(In reply to comment #1)
> (In reply to comment #0)
> > Description of problem:
> > I would use accented letters in book/article title. As I cannot use them on
> > command line or subtag <title>,  I've tried to set them in docname param but it
> > doesn't compile.
> 
> Hi Luigi --
> 
> Publican uses the contents of the <title> tag to generate the name of the RPM
> package for the book, and RPM packages can only have basic ASCII characters in
> their names. 
> 
> To use accented letters in a document title:
> 
> 1. Create the book using only basic ASCII characters in the "name" option:
> 
> publican create --name Si_puo_fare_di_piu
> 
> 2. Edit the <title> tag in the Book_Info.xml or Article_Info.xml file to
> include the correct name of the document:
> 
> <title>Si può fare di più</title>
> 
> 3. Edit the publican.cfg file to include the RPM-friendly version of the
> document name:
> 
> docname: Si_puo_fare_di_piu
> 
> This is documented in the Publican Users' Guide: 3.1.2. Book_Info.xml, but
> admittedly, could be more explicit. 
> 
> I'd change this to a documentation bug now, but since accented characters only
> matter to RPM packaging, I wonder if we're catching them at the best place?
> Maybe the check should apply to the "publican package" command but not to
> "publican create" or "publican build"?

This will just lead to people creating books that can't be packaged and then
complaining they should have been told or not allowed to do it. It can't be
packaged because docname is not just the name of the package, it's the name of
the main file as well.

Might be worth allowing one of those use cases for docname to be over ridden
with another variable.

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