#8036: Sage 4.3.1 reference manual: PDF version failed to build due to non-ASCII
characters in docstring
----------------------------------------------+-----------------------------
   Reporter:  mvngu                           |       Owner:  mvngu             
  
       Type:  defect                          |      Status:  needs_review      
  
   Priority:  minor                           |   Milestone:  sage-4.3.2        
  
  Component:  documentation                   |    Keywords:  non-ASCII 
characters
     Author:  Minh Van Nguyen, John Palmieri  |    Upstream:  N/A               
  
   Reviewer:                                  |      Merged:                    
  
Work_issues:                                  |  
----------------------------------------------+-----------------------------
Changes (by newvalueoldvalue):

  * status:  needs_work => needs_review
  * author:  Minh Van Nguyen => Minh Van Nguyen, John Palmieri


Comment:

 Sphinx uses {{{\usepackage[utf8]{inputenc}}}}, so if we want to change
 this to [utf8x], we need to patch Sphinx.  I have no experience with
 [utf8] or [utf8x], but the documentation for inputenc frowns on utf8x, to
 some extent.  Another option is to add characters one by one, as needed,
 using
 {{{
 \DeclareUnicodeCharacter{blah}{blah}
 }}}
 (See the documentation for inputenc.)  If we knew the details, we could
 add lines like this to {{{SAGE_ROOT/devel/sage/doc/common/conf.py}}} --
 add to the {{{latex_preamble}}}.  I don't know the details.

 A third option is to get rid of all accents, as mvngu's patch does.

 A fourth option is to use the attached patch {{{trac_8036-tex-
 replacements.patch}}}, which does some preprocessing, changing the
 offending character to something latex can handle.

 I'll mark this as "needs review", in case option 4 is appealing.

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/8036#comment:3>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sage-trac?hl=en.

Reply via email to