Home

Developing

Pelican docs

Following these instructions:

make devserver

Then in a new terminal tab, ../topographica -n for working with notebooks.

Stop with:

./develop_server.sh stop

(If all else fails, python -m SimpleHTTPServer)

In pelicanconf.py, this is indeed useful:

#Uncomment following line if you want document-relative URLs
RELATIVE_URLS = True

NOTE: You need to modify the file before running pelican content/ for the output to be updated!

You may also want to disable caching.

MathJax seems to be running well enough.

Building

Just run:

pelican content/

Or in emacs from a content file:

cd ..; pelican content/ &> /dev/null

Pushing to master from the source branch

This seems useful:

pip install ghp-import

On the 'source' branch build as usual pelican content/ then run this:

ghp-import -b master output

Then finally push the master branch:

git push origin master

The last two steps must be repeated every time the website is to be updated. See this page for more information. In short, this line does all:

pelican content/; ghp-import -b master output; git push origin master

Links on interest

• The summary plugin
• Liquid style tags
• More on Liquid style tags
• Blogging with IPython Notebook

Theming

Clone https://github.com/wrl/pelican-mockingbird then:

pelican-themes --install pelican-mockingbird/ --verbose

Other interesting themes:

https://github.com/fle/pelican-simplegrey https://github.com/nairobilug/pelican-alchemy https://github.com/erfaan/pelican-theme-irfan https://github.com/fle/pelican-sober https://github.com/wrl/pelican-mockingbird https://github.com/gunchu/nikhil-theme https://github.com/getpelican/pelican-themes/tree/master/built-texts