| 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

Nussbaum on Anger; Credit Card Processing for Cat Soft LLC; Discover new movies on demand in our online cinema; Tasting; Credit Card Processing for Cat Soft LLC; Apple + Kiwi Jam; Hit Me; Increase Efficiency with GPS Vehicle Tracking for Cat Soft LLC; Sudoku - CSP + Chaos; Recycling Electronics In Santiago; Vector Displays in OpenGL; Call Center Services for Cat Soft LLC; And Anti-Aliased; OpenGL - Render via Intermediate Texture; And Garmin Connect; Using Garmin Forerunner 230 With Linux; Payroll Service Quotes for Cat Soft LLC; (Beating Dead Horse) StackOverflow; Current State of Justice in China; Now Is Cat Soft LLC's Chance To Save Up To 32% On Mail; Axiom of Determinacy; Ewww; Fee Chaos Book; Course on Differential Geometry; Increase Efficiency with GPS Vehicle Tracking for Cat Soft LLC; 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; Raspberry, Strawberry and Banana Jam; Interesting Dead Areas of Math; Later Taste; For Sale; Death By Bean; It's Good!; Tomato Chutney v2; Time ATAC MX 2 Pedals - First Impressions; Online Chilean Crafts; Intellectual Variety; Taste + Texture; Time Invariance and Gauge Symmetry; Jodorowsky; Tomato Chutney; Analysis of Support for Trump; Indian SF; TP-Link TL-WR841N DNS TCP Bug; TP-Link TL-WR841N as Wireless Bridge; Sending Email On Time; Maybe run a command; Sterile Neutrinos; Strawberry and Banana Jam; The Best Of All Possible Worlds; Kenzaburo Oe: The Changeling; Peach Jam; Taste Test; Strawberry and Raspberry Jam; flac to mp3 on OpenSuse 42.1; Also, Sebald

© 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