Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


An IDE for Pelican sites.


Installing pelicide should be easy:

$ pip install pelicide


However, pelicide hasn't been released to pypi yet. To build a working pelicide install, there are some requirements:

  • Python 2.7 (unfortunately, not all dependencies are python 3 compatible)
  • Node.js (required to host jspm)
  • jspm (required to collect all javascript dependencies and build the production javascript files, install it using npm install jspm)
  • git (required to get the actual code and the dependencies)

Once those dependencies are installed, you can get the pelicide source code, install it's dependencies using jspm and pip:

$ git clone
$ cd pelicide
$ jspm install
$ python develop

Running pelicide

Create a project file (pelicide.ini) in your pelican directory:

deploy=make rsync_upload

All settings are optional (in fact, you can run pelicide without a project file). The default value for the pelicanconf setting is, the default python interpreter is the interpreter used to execute pelicide.

The specified python interpreter will be used to set up the pelican environment. This can be useful if you install pelicide in a different virtual environment than the one you build your site with.

The deploy option specifies what command to execute to deploy (or publish) your site. You can specify any shell command. The command will be executed in the directory your pelican config file resides in.

By default, pelicide will create a temporary directory to store the output files in (and cleans it up when pelicide exits). If you have a lot of media files that need to be copied and you restart pelicide often, you may want to specify a persistent output using tempdir.

You can also create a global configuration file in ~/.config/pelicide/pelicide.ini. This config file will be loaded first and can contain the same options as the project file.

Now, start pelicide:

pelicide pelicide.ini

Pelicide will output a lot of debug information (in fact, it is the debug output of pelican which builds your site into a temporary directory) and finally it will tell you to go to a website:

Pelicide is running. Please visit

Note that if you run pelicide without a project file and without a global configuration file, it will look for in the current directory and it will use the python interpreter used to run pelicide itself.


An IDE for Pelican Static Site Generator






No releases published


No packages published