yet another static site generator
But Darf is still a pipsqueek!
Quite right, Dwarf is in its very early stages. It’s in no way stable, scalable, secure, or a good idea in any.
Core requirements: python 2.7 + pip
OPTION 1: use pip
$ pip install Dwarf
OPTION 2: the long and laborious hard way:
git clone firstname.lastname@example.org:jpoesen/dwarf.git
create a virtual environment with virtualenv
$ cd /path/to/my/dwarf
$ virtualenv venv_dwarf
activate the virtual env
$ source venv_dwarf/bin/activate
set up Dwarf’s dependancies within your virtual environment
$ cd /path/to/my/dwarf/location
$ pip install -r requirements.txt
$ python dwarf/application.py
Where does Dwarf keep its stuff?
No SQL. No NOSQL. All source content is stored in flat markdown files:
(Files starting with an underscore are assumed to be draft content and won’t be rendered publicly.)
Your Dwarf is so pretty.
Oh you. Out of the box Dwarf uses Twitter’s Bootstrap to make itself purdy for gentleman callers. Any lipstick will do though. Go nuts.
What about pictures and discussions and such?
Multimedia content will have to be hosted elsewhere for now - Dwarf has no intention of handling all that himself, though some kind of ajaxy wizardy interface to those third party thingies may be cooked up later.
What holds the future?
Right now we are assuming a lot of things and hiding behind ‘convention over configuration’ to justify lots of magicking about. We need to move stuff into a simple config file, write unit tests and produce documentation. Stabilize now, add features later.