[postgis-tickets] [PostGIS] #3726: PDF manual from dblatex renders fancy quotes for programlisting

PostGIS trac at osgeo.org
Wed Mar 8 14:43:29 PST 2017


#3726: PDF manual from dblatex renders fancy quotes for programlisting
---------------------------+----------------------------
 Reporter:  Mike Toews     |      Owner:  robe
     Type:  enhancement    |     Status:  new
 Priority:  low            |  Milestone:  PostGIS Future
Component:  documentation  |    Version:  trunk
 Keywords:                 |
---------------------------+----------------------------
 As [http://gis.stackexchange.com/q/231162/1872 described in this Q/A],
 parts of the PostGIS manual e.g.
 [http://postgis.net/docs/ST_MLineFromText.html ST_MLineFromText] define an
 example like this within `programlisting`:
 {{{
 <programlisting>SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5,
 6 7))');</programlisting>
 }}}
 which renders fine for HTML outputs, however the PDF rendering via dblatex
 on [http://postgis.net/stuff/postgis-2.3.pdf page 29] shows:
 {{{
 SELECT ST_MLineFromText(’MULTILINESTRING((1 2, 3 4), (4 5, 6 7))’);
 }}}
 which has fancy, but bad quotes. Straight quotes need to be preserved in
 the programlisting environment. The PostgreSQL PDF manual does not have
 this issue.

 Possible fixes are to use the "-s latex_style, --texstyle=latex_style"
 [http://dblatex.sourceforge.net/doc/manual/re01.html option for dblatex]
 in the doc/Makefile.in, which would reference a static customized LaTeX
 style file that may modify how LaTeX handles these characters (e.g.
 [http://tex.stackexchange.com/q/7735/2951 this] or other method).

--
Ticket URL: <https://trac.osgeo.org/postgis/ticket/3726>
PostGIS <http://trac.osgeo.org/postgis/>
The PostGIS Trac is used for bug, enhancement & task tracking, a user and developer wiki, and a view into the subversion code repository of PostGIS project.


More information about the postgis-tickets mailing list