A Python Static Website Generator
Python
Pull request Compare This branch is 9 commits ahead, 176 commits behind hyde:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
hyde
resources
.gitignore
AUTHORS.rst
CHANGELOG.rst
LICENSE
MANIFEST.in
README.rst
TODO.rst
dev-req.txt
distribute_setup.py
h
requirements.txt
setup.py

README.rst

This is a fork of Hyde http://github.com/hyde/hyde that are used in http://derechoaleer.info/ website

clone this repo!

Install Hyde with Virtualenv in Debian

If your distribution does not provide a recent virtualenv you can install the current version using easy_install (easy_install is provided by python-setuptools).

apt-get remove python-virtualenv

Install Virtualenv

easy_install virtualenv

Create a Virtualenv in /opt/hyde_workenv

cd /opt
virtualenv --no-site-packages hyde_workenv

Activate Virtualenv

source  hyde_workenv/bin/activate

note that "(hyde_workenv)" appears in your prompt

Install pip

easy_install pip
export PIP_RESPECT_VIRTUALENV=true

Install Hyde from this repo

pip install -e git://github.com/hyde/hyde.git#egg=hyde

voila! :)


Version 0.8.5a14

A brand new hyde

This is the new version of hyde under active development. Hyde documentation is a work in progress.

Hyde starter kit by merlinrebrovic is a really nice way to get started with hyde.

Hyde layout for bootstrap by auzigog is also a good alternative if you like Twitter's bootstrap framework.

You can also take a look at Hyde Powered Websites for inspiration and reference.

Installation

To get the latest released version:

pip install hyde

For the current trunk:

pip install -e git://github.com/hyde/hyde.git#egg=hyde

Creating a new hyde site

The following command:

hyde -s ~/test_site create

will create a new hyde site using the test layout.

Generating the hyde site

cd ~/test_site
hyde gen

Serving the website

cd ~/test_site
hyde serve
open http://localhost:8080

Publishing the website

cd ~/test_site
hyde publish -p github

Hyde supports extensible publishers.

Github

The hyde documentation is published to github pages using this command with the following configuration:

publisher:
    github:
        type: hyde.ext.publishers.dvcs.Git
        path: ../hyde.github.com
        url: git@github.com:hyde/hyde.github.com.git

Note

Currently, the initial path must have clone of the repository already in place for this command to work.

PyFS

Hyde also has a publisher that acts as a frontend to the awesome PyFS library (thanks to rfk). Here are a few configuration options for some PyFS backends:

publisher:
    zip:
        type: hyde.ext.publishers.pyfs.PyFS
        url: zip://~/deploy/hyde/docs.zip
    s3:
        type: hyde.ext.publishers.pyfs.PyFS
        url: s3://hyde/docs
    sftp:
        type: hyde.ext.publishers.pyfs.PyFS
        url: sftp:hydeuser:hydepassword@hydedocs.org

Note

PyFS is not installed with hyde. In order to use the PyFS publisher, you need to install pyfs seprately.

Any PyFS dependencies (Example: boto for S3 publishing) need to be installed seprately as well.

pip install fs
pip install boto

To get additional help on PyFS backends, you can run the following command once PyFS is installed:

fsls --listopeners

Examples

  1. Hyde Documentation Source
  2. Cloudpanic
  3. Ringce

A brief list of features

  1. Evented Plugins: The Plugin hooks allow plugins to listen to events that occur during different times in the lifecycle and respond accordingly.
  2. Metadata: Hyde now supports hierarchical metadata. You can specify and override variables at the site, node or the page level and access them in the templates.
  3. Organization: The sorter, grouper and tagger plugins provide rich meta-data driven organizational capabilities to hyde sites.
  4. Publishing: Hyde sites can be published to variety of targets including github pages, Amazon S3 & SFTP.

Links

  1. Changelog
  2. Authors