[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

Ruediger Landmann <r.landmann at redhat.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |r.landmann at redhat.com

--- Comment #1 from Ruediger Landmann <r.landmann at redhat.com> 2011-03-17 18:36:53 EDT ---
(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"?

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