I nev­er re­mem­ber how to do foot­notes right us­ing Re­Struc­tured Tex­t.

If that, or some­thing sim­i­lar, hap­pens to you, get my rst cheat­sheet and print it, it's a two-sid­ed A4 page.

This is an ear­ly ver­sion, the left­-­hand col­umns need lots of love.

Al­so, you may want to take a look at this one-­page python cheat­sheet, too.

Both are cre­at­ed us­ing re­struc­tured text and rst2pdf, and li­censed un­der Cre­ative Com­mon­s.

I would love to see trans­la­tions to oth­er lan­guages. If you want to help, con­tact me!

Since this is the first post that ap­pears in Plan­et Python, a small in­tro is in or­der.

Hi, my name is Rober­to Alsi­na, I am a for­mer KDE de­vel­op­er, am­a­teur pro­gram­mer 1 , python fan.

This post (and many you will see from me) is about rst2pdf, a tool to con­vert re­struc­tured text to PDF. For ex­am­ple, it turns the python li­brary ref­er­ence in­to this PDF (not pro­duc­tion qual­i­ty yet).

If you are a rst2pdf 0.11 user, or a sphinx or do­cu­tils us­er who wants to try an al­ter­na­tive way to cre­ate PDF­s, then I would like your help test­ing the SVN trunk code.

These are some of the new fea­tures since 0.11:

• PDF­Builder, a Sphinx ex­ten­­sion to gen­er­ate PDF­s.

• Kern­ing (re­quires wor­­daxe from SVN)

• AAFig­ure sup­­port (di­a­­grams us­ing ASCII Art)

• Page­Breaks can be odd­­/even/any

• Sup­­port for ad­­vanced page coun­ters (man­u­al num­ber­ing, ro­­man/ara­bic/let­ter­s)

• Much bet­ter styling, spe­­cial­­ly for ta­bles.

• About two dozen bug­­fix­es.

So, please, take a look, you may like it!

1

That just means I love pro­gram­ming.

The guy at Mis­sion: Cog­ni­tion ac­tu­al­ly re­leased his spread­sheet!

I havenot test­ed it, but it looks sweet.

See it here