C[omp]ute

From: andrew cooke <andrew@...>

Date: Thu, 14 Apr 2011 20:31:39 -0300

I'm trying to write a document in restructured text and then convert it to
Latex (and then finally to PDF).  But have hit two problems.

First, "---" isn't converted into an em-dash (it remains as three dashes).  It
turns out that you need to stci a UTF em-dash directly in your rst file for
this to work correctly.  Which is not trivial in Emacs.  I finally found a
solution on a web page (which I have now lost):

 - From the "Options" menu select "MULE" and then "Select input method".
 - In the command box thing, type rfc1345 (tab will autocomplete after a 
   few letters)
 - Then you can magically type &-M for an emdash and &-N for an endash (even
   though they look the same, if you have a monospace font, Latex
   understands).
 - You can toggle between this mode (where & is magic) and normal mode by
   using C-\ (something changes bottom left of the status bar).

Second, the default layout was pretty ugly.  To improve things, change the
rst2latex command line to:

  rst2latex.py --documentoptions='10pt,a4paper,DIV=calc' \
     --literal-block-env=lstlisting foo.rst foo.tex

and add the following to the top of the file:

.. raw:: latex

  \renewcommand{\ttdefault}{txtt}
  \lstset{language=Python,
    morekeywords=[1]{yield}
  }
  \lstloadlanguages{Python}
  \lstset{
    basicstyle=\small\ttfamily,
    keywordstyle=\bfseries,
    commentstyle=\rmfamily\itshape,
    stringstyle=\slshape,
  }
  \lstset{showstringspaces=false}
  \lstset{columns=fixed,
       basewidth={0.5em,0.4em}}

Andrew