logya 1.0

Logya is a static Web site generator written in Python designed to be easy to use and flexible.

Logya is a static Web site generator written in Python designed to be
easy to use and flexible.

Features
========

- Create responsive static Web sites
- Built-in Web server with info level logging for immediate editing
feedback
- Commands for site creation, generation, and serving
- Automatic index generation in created folders
- Site configuration

Requirements
============

- `Python 2.7`_
- `Jinja2`_

Directory Structure
===================

Logya Source
------------

- logya all logya source files needed for running

- ext extension modules
- sites barebone example Web sites

- tests

Site Source
-----------

The following folders and files are recognized when generating a Web
site with Logya.

- content - required
- templates - required
- site.cfg - required
- static - optional

Roadmap
=======

Version 1.1
-----------

- add exclude option to exclude headings , e.g. h1, to
jquery.headerindex.js
- implement scripts and styles as extensions that process multi value
document header fields
- add support for default scripts and styles in site configuration
- add tags extension

Version 1.2
-----------

- define types of extensions, re-think index and doc
- options to enable and or disable extensions in site configuration

Version 1.3
-----------

- RSS feed generation from indexes as extension
- XML and HTML sitemap generation as extension

Version 1.4
-----------

- Add logya extension create name command
- minify and concatenate CSS and JS

Further Plans and Ideas
-----------------------

- content snippets that are replaced when generating document
- shared extensions .logya/ext
- shared libraries for extensions .logya/lib
- specify indexes in configuration?
- make site.cfg optional?
- Use mongodb and implement the following sub commands:

- logya import - import documents info database, existing ones that
are not older than source file modification will be kept
- logya refresh - refresh existing deployment, update indexes and
recreate updated content
- logya generate - complete generation of deployment files
- collections: documents, directories with references to all
documents inside
- example document:

- filepath /index.html
- urlpath /index/
- title “title”
- tags one two three
- content "

.. raw:: html

<p>

page content

.. raw:: html

</p>