Welcome to the source text of the Data Wrangling Handbook. The handbook is a project of the Open Knowledge Foundation. If you are reading this it is likely you are looking to contribute in some way, whether that's translation, feedback, editing or adding more content. If you just want to read the handbook, then please head over to the http://handbook.schoolofdata.org/.
We have several ways you can help. The project is split into a few roles. Our authors write content, editors merge those submissions into the handbook, designers help beautify it and translators bring the handbook to all countries of the world.
About our tools
datawrangling/ text/ examples bin/ build/
datawranglingis the base directory.
textis where we keep the plain text source files.
examplesis where we put example code and utilities
buildis where rendered, or "built", HTML files live.
Rendering the handbook
Move into the base directory of the project:
Install Sphinx, with a minimum version of 1.0. Instructions for Debian and Ubuntu:
apt-get install python-sphinx
Make sure you have installed the theme by initializing the git submodules for this repo:
git submodule init git submodule update
Render the HTML, using
Deploying the Handbook
We use ReadTheDocs to host the handbook. ReadTheDocs will automatically rebuild the site each time you push a change to the master branch.