A fork of hyde, the static site generation. Some patches will be pushed upstream.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
John-Mark Gurney be6a0ec164 python3 2 months ago
docs fix typo, this should be node.. 3 years ago
hyde python3 2 months ago
resources Generation first pass complete 14 years ago
tests Fix silly span bug 8 years ago
.gitignore Fix failing tests and formatting issues. 9 years ago
.travis.yml [WIP] Add Sphinx docs 8 years ago
CHANGELOG.rst Add initial (experimental) Python 3 support. 8 years ago
CONTRIBUTING.rst Add CONTRIBUTING.rst 9 years ago
LICENSE Include project artifacts in sdist. (Issue #211) 11 years ago
MANIFEST.in Hoist tests out of the core package 9 years ago
README.rst [WIP] Add Sphinx docs 8 years ago
dev-only.txt Add coverage to tox 8 years ago
dev-req.txt Prep for 0.8.9 release. 9 years ago
docs-requirements.txt [WIP] Add Sphinx docs 8 years ago
h Added deprecation warning for h 9 years ago
requirements.txt update to 3.0, as I'm using some features in it on my 3 years ago
setup.py Add initial (experimental) Python 3 support. 8 years ago
tox.ini [WIP] Add Sphinx docs 8 years ago

README.rst

Version 0.8.9

.. image:: https://travis-ci.org/hyde/hyde.svg?branch=master

Overview
========

`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.

Currently hyde is only supported on python 2.7.x. Python 3.x support is in
progress, thanks to `jonafato`_.

Active development of hyde had stalled for some time, but thanks to `llonchj`_
and `jonafato`_ there is now a slow but steady progress towards 1.0.

Mailing List: `hyde-dev`_ on google groups.
IRC: #hyde on freenode


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 separately.

Any PyFS dependencies (Example: `boto` for S3 publishing)
need to be installed separately 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. `julien.danjou.info`_
2. `luffy.cx`_
3. `Cloudpanic`_
4. `Hyde Documentation Source`_


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`_


.. _hyde: https://github.com/lakshmivyas/hyde
.. _Hyde documentation: http://hyde.github.com
.. _Hyde Documentation Source: https://github.com/hyde/docs
.. _Cloudpanic: https://github.com/tipiirai/cloudpanic
.. _Authors: https://github.com/hyde/hyde/graphs/contributors
.. _Changelog: https://github.com/hyde/hyde/blob/master/CHANGELOG.rst
.. _Hyde starter kit: http://merlin.rebrovic.net/hyde-starter-kit/about.html
.. _merlinrebrovic: https://github.com/merlinrebrovic
.. _rfk: https://github.com/rfk
.. _PyFS library: http://packages.python.org/fs/
.. _Hyde layout for bootstrap: https://github.com/auzigog/hyde-bootstrap
.. _auzigog: https://github.com/auzigog
.. _bootstrap framework: http://twitter.github.com/bootstrap/
.. _Hyde Powered Websites: https://github.com/hyde/hyde/wiki/Hyde-Powered
.. _hyde-dev: https://groups.google.com/forum/#!forum/hyde-dev
.. _julien.danjou.info: https://github.com/jd/julien.danjou.info
.. _luffy.cx: https://github.com/vincentbernat/www.luffy.cx
.. _jonafato: https://github.com/jonafato
.. _llonchj: https://github.com/llonchj