This blog is a note to myself on how I setup my website editing stuff. I've chosen to use pelican because I wanted a static generated, template capable platform. As I have some Markdown experience this was another important requirement in choosing the right platform.

Editing with Sublime Text 2

Is use Sublime Text 2 with the MarkdownEditing Package on Mac OS.

Installations steps (see here):

  1. Open the console: View -> Show Console
  2. Copy the text below and press ENTER. This wil install Package Control for Sublime 2

import urllib2,os,hashlib; h = '2deb499853c4371624f5a07e27c334aa' + 'bf8c4e67d14fb0525ba4f89698a6d7e1'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp) else None; urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler()) ); by = urllib2.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); open( os.path.join( ipp, pf), 'wb' ).write(by) if dh == h else None; print('Error validating download (got %s instead of %s), please try manual install' % (dh, h) if dh != h else 'Please restart Sublime Text to finish installation')

  1. Open the command palette in Sublime (CMD + SHIFT + p) and type "install"
  2. Select the option "Package Control: Install Package" and press ENTER
  3. Type "Markdown" and select "MarkdownEditing"
  4. Restart Sublime
  5. When opening a Markdown file for the first time set the correct syntax via View -> Syntax -> MarkdownEditing

Installing Python virtual environment

Pelican is build in Python an it looks like it is common practise to use a virtual environment when working with Python. Why? Don't know, that sounds like it is going to be another blog post.

> easy_install pip
> pip install virtualenv
> mkdir $HOME/virtualenvs
> cd !$
> virtualenv pelican
> source pelican/bin/activate
(pelican) > deactivate
>

Installing Pelican with Markdown

Install Pelican and Markdown from within the "pelican" virtual environment.

> cd $HOME/virtualenvs/pelican
> source bin/activate
(pelican) > pip install pelican
(pelican) > pip install markdown

Pelican themes

Clone the git repository locally and install the themes you want.

> mkdir $HOME/git
> cd !$
> git clone https://github.com/getpelican/pelican-themes.git
> cd $HOME/virtualenvs/pelican
> source bin/activate
(pelican) > pelican-themes -i crowsfoot
(pelican) > pelican-themes -l

references