What is it?
Stabe is ___Sta___tic ___B___logging ___E___ngine writen in Python inspired from
Octopress and Pelican. Designed to make it painless to author and update large blogs.
Some key features are:
- Cross platform
- Standalone content directory.
- Easy-to-author configuration.
- Use your favorite editor for everything.
- Easy installation, easy to use, extendable and customize
Here's a sample of [publishing using Stabe](http://blog.arissh.com/).
- Static output
- Use any editor
- One-step to add a new post and page
- Uses existing DSLs: Markdown (content) + YAML (metadata) + Mustache (template)
- Simple logic-less templates
- Mobile device layout support
- Ability to work offline
- Logical placement of assets (content-related ones near the content, layout ones in the template)
- Incremental building and fast builds.
- Auto generated RSS Feed
- Live preview with a local server
- Content directory format is decoupled from output.
- Deploy to general hosting (via RSync and FTP) and or cloud hosting (PaaS like GAE, Github, Heroku, AppFog, etc)
1. Clone the repository via `git clone firstname.lastname@example.org:riespandi/stabe.git`
2. Run `cd stabe` to get to your newly cloned repository.
2. Install all required dependencies by running `pip install -r requirements.txt`.
3. Run `./stabe` to build and `./stabe preview` to run a webserver.
4. Open <http://localhost:4000> in your browser.
5. That's all, enjoy it!
> ./stabe build
Forcibly rebuild everything regardless of whether or not there have been
changes made to the content. This is useful if you change your template.
> ./stabe rebuild
Start watching for local changes to the content, rebuilding
incrementally based on that.
> ./stabe watch
Start a really simple local web server with its document root pointing
to the output directory.
> ./stabe preview
Deploy the site to the specified server (gae, ftp, rsync, git). Default
deploy server defined at `stabe.yaml`.
> ./stabe deploy <server>
- `/articles/` contains your articles written in Markdown.
- `/include/` contains files for included when generating output.
- `/output/` contains files generated by Stabe.
- `/plugins/` contains Stabe plugins script.
- `/themes/` contains files written in HTML and Mustache templates.
- `/site.yaml` is the configuration file about your site.
- `/stabe.yaml` is the Stabe configuration file.
Stabe is released under the terms of the MIT License and is free to use and modify.
It's free to redistribute as long as you abide by the distribution terms of the license.
Copyright (c) 2013 Aris S Ripandi, aris [at] arissh.com
Read MIT License here: <http://opensource.org/licenses/MIT>
Aris S Ripandi "riespandi"
- Sebastian Wagner "sebix"
- Moritz Schlarb "moschlar"
- Mark van Lent "markvl"
- Thomas Weißschuh "t-8ch"
- Alexander Zhirov "nevkontakte"
- Christoph Polcin "chripo"
- Daniel Pritchard "dpritchard"
TODO: Brief introduction on what you do with files - including link to relevant help section.