PythonDataScienceHandbook/website
Jake VanderPlas 97c8c91c59 Adjust website build to work with colab badges: 2018-08-28 14:11:16 -07:00
..
content remove unneeded images 2017-08-15 09:14:59 -07:00
theme Fix some links 2017-08-15 09:14:58 -07:00
.gitignore Fix some links 2017-08-15 09:14:58 -07:00
Makefile Update publish info 2017-08-15 09:14:57 -07:00
README.md Adjust website build to work with colab badges: 2018-08-28 14:11:16 -07:00
copy_notebooks.py Adjust website build to work with colab badges: 2018-08-28 14:11:16 -07:00
fabfile.py add website framework 2017-08-15 09:14:57 -07:00
pelicanconf.py Add landing page 2017-08-15 09:14:58 -07:00
publishconf.py Update publish info 2017-08-15 09:14:57 -07:00

README.md

2# Tools for creating http://jakevdp.github.io/PythonDataScienceHandbook/

The website is generated using the Pelican static site generator. The themes here are adapted from those used for my blog: https://github.com/jakevdp/jakevdp.github.io-source

Building the Website

Clone the repository & make sure submodules are included

$ git clone https://github.com/jakevdp/PythonDataScienceHandbook.git
$ git checkout origin/website
$ git submodule update --init --recursive
$ cd website

Install the required packages:

$ conda create -n pelican-blog python=3.5 jupyter notebook
$ source activate pelican-blog
$ pip install pelican Markdown ghp-import
$ mkdir plugins
$ git submodule add git://github.com/danielfrg/pelican-ipynb.git plugins/ipynb
$ git submodule add https://github.com/getpelican/pelican-plugins.git plugins/pelican-plugins

Copy the notebook content to the right location (this script also modifies some links for the HTML):

$ python copy_notebooks.py

Build the html and serve locally:

$ make html
$ make serve
$ open http://localhost:8000

Deploy to github pages

$ make publish-to-github