url: / title: Logya Documentation template: post.html

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

Installation

Logya is an open source Python application that can be downloaded from and forked on Github.

Getting Started

Create a starter site:

logya create mysite

This command will create a new sub directory in your current working directory called mysite, that includes the resources for a logya starter site.

Change to the starter site directory:

cd mysite

Generate files to deploy:

logya generate

This command generates HTML files from the documents found in the content directory, indexes for Web site directories, and copies static resources to the newly created deploy directory.

Serve site from deploy directory:

logya serve

Run this command in the root directory of your mysite project and it will serve the static files from the deploy directory. When you edit files in your projects source directory and reload them in the browser they will be updated, so this can be used for live editing your site and see changes immediately.

Get help on logya command:

logya -h

Show the help output of the logya command with information on sub commands and options, for help on a sub command call it with the -h option, e.g. logya create -h.

Document Structure

Documents are basically html files containing the content of a page with header information to specify title, url, description, scripts and style sheets to include and self defined variables that can be accessed in templates.

Development Tips

The following tips are intended for people developing logya application code.

Create a command that points to the development source:

ln -s $HOME/code/logya/logya/main.py $HOME/bin/logyadev

This creates a symbolic link in your home bin directory to access logya commands from your development source, assuming it resides in the first directory specified above. To not override the logya command from your installation the command is called logyadev.

Credits

Logya is being developed by Ramiro Gómez. The Logya logo was created using the Earth, Internet icon by IconEden.