Python for Everybody

Welcome to the under-construction book "Python for Everybody".

While this book is under construction, it is copyright, all rights reserved Charles R. Severance. Once the book is in better shape I will move it back to Creative Commons.

These *.mkd files are now the master files for the book (i.e. I will not run the conversion any more).

To produce the PDF of the book, you will need to install LaTeX on your system. For Debian-derived (Ubuntu, Mint, etc.) Linux:

sudo apt-get install texlive-full
sudo apt-get install pandoc

For Macintosh,

https://www.tug.org/mactex/
https://www.tug.org/mactex/mactextras.html

To produce the book run

bash book.sh

The output bash book.sh is in the file x.pdf and x.epub.

Note that the build scripts require Python 2

Alternate Build Scripts

In addition to the official book.sh1, there are other build scripts that make alternate versions of the book.

htmlbook.sh will make an html verion of the book, with interactive examples embedded in trinkets. These files are in books/html if you want to download or view them.
zipbook.sh will make two html versions of the book with Trinket branding, one with interactive examples (that require an internet connection to work) and one with syntax highlighted code blocks for completely offline viewing. A zip containing these is at /book/zips/pfe.zip if you'd just like to download it.
trinketbook.sh will make the nunjucks template that we use to host the book at books.trinket.io. This is likely not of use to you unless you're looking for an example of how to get the book source into your own templating language. If you'd like to see the output of this script it's in books/trinket/pfe.

If you'd like to make your own build script, you can use these as examples. If your build script might have use to others, consider contributing it in a pull request. Note that each build script plays nicely with the others and the represent parallel workflows. Please don't alter any of the python scripts that are used by another script if you intend on contributing a new script.

Contributing

If you want to contribute, feel free to fork the pythonlearn repository and send me pull requests.

https://github.com/csev/pythonlearn

We can also use the issue tracker to coordinate if that helps.

This is a very rough conversion. I wrote several Python programs (see the convert folder) to go through the LaTeX, hack it, extract anything that looked like code, run it through 2to3 and put in the converted book. So some of the code is converted perfectly but other bits are still broken or Python 2.0 because my auto-process missed something. We will fix those by hand.

/Chuck