Metadata-Version: 1.0
Name: floyd
Version: 0.0.3
Summary: A command line static website generator for popular cloud hosting providers
Home-page: http://github.com/nikcub/floyd
Author: Nik Cubrilovic <nikcub@gmail.com>
Author-email: nikcub@gmail.com
License: BSD
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)
        
Keywords: website,appengine,s3,cms,blog
Platform: linux
Platform: osx
Platform: win32
