A command line static website generator for popular cloud hosting providers
Project description
# Floyd v0.0.3-alpha
An advanced MVC CMS that generates static sites for Google AppEngine and Amazon S3
Usage: floyd <sources> <outputdir>
# Features
Full MVC - define your routes, controllers, etc. and then generate
Full data model (eg. floyd.db.Query(‘Posts’).filter(post_type=’page’).order(‘-datetime’).fetch())
Data model reads from flat source files
Convert text, markdown or HTML pages into HTML output
Automatically configures AppEngine sites
Supports different templating engine (defaults jinja2)
# Install
$ pip install floyd
or if you don’t have pip you can use easy_install (default on OS X and with python installations on other platforms)
$ easy_install floyd
# Usage
$ cd /path/to/site $ floyd create [site created] $ floyd generate [site generated] $ floyd deploy appengine [site deployed] (in theory)
# Help
$ floyd help
or for a command
$ floyd help [command]
# Upgrading to the latest stable release
depends on your install method:
$ pip install –upgrade floyd
$ easy_install floyd
$ git pull upstream $ python setup.py install
# Latest Development Branch
Using pip
$ pip install -e git://github.com/nikcub/Floyd.git#egg=floyd
Or straight from the git repository:
$ git clone git://github.com/nikcub/Floyd floyd $ cd floyd $ python setup.py install
# Google AppEngine Support
Download the [Google AppEngine SDK](http://code.google.com/appengine/downloads.html) for your platform and install it
Open the command line (Terminal in OS X, Command Prompt in Windows) and cd to the directory containing the generated site
Run: $ appcfg.py update .
# Safe Password Storage
If you have two-factor authentication activated with your Google ID, or you do not wish to store your Google password in configuration files (which is strongly recommended) then create a single-use password that is used in automatic deployments to Google App Engine from Floyd.
To do this:
1. Recommended: enable 2-step authentication by visiting the [Google Account](https://www.google.com/settings/) page and enabling the setting under ‘Security’ (switch ‘2-step verification’ to on) 1. Generate an application specific password by going to the [Authorized Access Settings Page](https://accounts.google.com/b/0/IssuedAuthSubTokens) 1. Under the heading ‘Application Specific Passwords’ enter a name such as floyd deploy and generate a password 1. Store the generated password in your Floyd configuration file under password (spaces are not important, they are there for legibility)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.