| Andrew Cooke | Contents | Latest | RSS | Twitter | Previous | Next

C[omp]ute

Welcome to my blog, which was once a mailing list of the same name and is still generated by mail. Please reply via the "comment" links.

Always interested in offers/projects/new ideas. Eclectic experience in fields like: numerical computing; Python web; Java enterprise; functional languages; GPGPU; SQL databases; etc. Based in Santiago, Chile; telecommute worldwide. CV; email.

Personal Projects

Lepl parser for Python.

Colorless Green.

Photography around Santiago.

SVG experiment.

Professional Portfolio

Calibration of seismometers.

Data access via web services.

Cache rewrite.

Extending OpenSSH.

C-ORM: docs, API.

Last 100 entries

Learning From Trump; Chinese Writer Hu Fayun; C++ - it's the language of the future; And; Apricot Jam; Also; Excellent Article on USA Politics; Oh Metafilter; Prejudice Against The Rurals; Also, Zizek; Trump; Why Trump Won; Doxygen + Latex on CentOS 6; SMASH - Solve 5 Biggest Problems in Physics; Good article on racism, brexit, and social divides; Grandaddy are back!; Consciousness From Max Entropy; Democrats; Harvard Will Fix Black Poverty; Modelling Bicycle Wheels; Amusing Polling Outlier; If Labour keeps telling working class people...; Populism and Choice; Books on Defeat; Enrique Ferrari - Argentine Author; Transcript of German Scientists on Learning of Hiroshima; Calvert Journal; Owen Jones on Twitter; Possible Japanese Authors; Complex American Literature; Chutney v5; Weird Componentized Virus; Interesting Argentinian Author - Antonio Di Benedetto; Useful Thread on MetaPhysics; RAND on fighting online anarchy (2001); NSA Hacked; Very Good LRB Article on Brexit; Nussbaum on Anger; Tasting; Apple + Kiwi Jam; Hit Me; Sudoku - CSP + Chaos; Recycling Electronics In Santiago; Vector Displays in OpenGL; And Anti-Aliased; OpenGL - Render via Intermediate Texture; And Garmin Connect; Using Garmin Forerunner 230 With Linux; (Beating Dead Horse) StackOverflow; Current State of Justice in China; Axiom of Determinacy; Ewww; Fee Chaos Book; Course on Differential Geometry; Okay, but...; Sparse Matrices, Deep Learning; Sounds Bad; Applebaum Rape; Tomato Chutney v4; Have to add...; Culturally Liberal and Nothing More; Weird Finite / Infinite Result; Your diamond is a beaten up mess; Maths Books; Good Bike Route from Providencia / Las Condes to Panul; Iain Pears (Author of Complex Plots); Plum Jam; Excellent; More Recently; For a moment I forgot StackOverflow sucked; A Few Weeks On...; Chilean Book Recommendations; How To Write Shared Libraries; Jenny Erpenbeck (Author); Dijkstra, Coins, Tables; Python libraries error on OpenSuse; Deserving Trump; And Smugness; McCloskey Economics Trilogy; cmocka - Mocks for C; Concept Creep (Americans); Futhark - OpenCL Language; Moved / Gone; Fan and USB issues; Burgers in Santiago; The Origin of Icosahedral Symmetry in Viruses; autoenum on PyPI; Jars Explains; Tomato Chutney v3; REST; US Elections and Gender: 24 Point Swing; PPPoE on OpenSuse Leap 42.1; SuperMicro X10SDV-TLN4F/F with Opensuse Leap 42.1; Big Data AI Could Be Very Bad Indeed....; Cornering; Postcapitalism (Paul Mason); Black Science Fiction; Git is not a CDN; Mining of Massive Data Sets; Rachel Kaadzi Ghansah; How great republics meet their end

© 2006-2015 Andrew Cooke (site) / post authors (content).

How To Write Papers with Restructured Text

From: andrew cooke <andrew@...>

Date: Sun, 22 May 2011 01:21:58 -0400

I wrote http://www.acooke.org/pytyp.pdf as "ordinary" text.  You can see the
source at http://code.google.com/p/pytyp/source/browse/pytyp.rst#23 and I hope
you'll agree that, apart from the Latex in the header, it's as easy to read as
the final PDF.

That "natural" formatting style is called "restructured text" and is commonly
used for Python documentation.  But it can be used for general writing too.
Tools exist to convert it to various formats, including HTML and Latex (and
from Latex to PDF, of course).

There's a simple overview of how to format things at
http://sphinx.pocoo.org/rest.html (that's part of the documentation for a
larger package called Sphinx, but Sphinx uses restructured text, so it's
relevant here).  The best detailed reference is
http://docutils.sourceforge.net/docs/ref/rst/directives.html  But really, you
can pick almost everythin up just by looking at an example like the source I
gave earlier - http://code.google.com/p/pytyp/source/browse/pytyp.rst#23


To generate the PDF from that file I used the commands

  rst2latex.py \
    --documentoptions='10pt,paper=letter,DIV=20,headinclude=false,footinclude=false,twoside=false,twocolumn=true' \
    --literal-block-env=lstlisting pytyp.rst pytyp.tex

  pdflatex pytyp.tex

The first generates Latex from the source; the second converts that to PDF.

The documentoptions in the first command controls how Latex formats the
result.  The literal-block-env part is for the program listings.


You also need to install restructured text and Latex - for OpenSuse that means
installing the "docutils" and the "texlive-latex" packages from Yast.

Andrew

Comment on this post