Skip to content

aquatix/paragoo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2033350 · Jun 5, 2023
Sep 9, 2015
Apr 6, 2019
Oct 29, 2018
Apr 29, 2016
Jan 11, 2015
Sep 20, 2015
May 25, 2018
Apr 6, 2019
Mar 8, 2018
Jun 5, 2023
Oct 7, 2020
Jun 5, 2023
Apr 7, 2019

Repository files navigation

paragoo

PyPI version PyPI license Code Health Codacy Badge

paragoo is a static site generator, written in Python. It takes a simple yaml file with the structure of the site, the source Markdown/HTML content files and the Jinja2 based templates and builds a directory structure with the final website.

Installation

From PyPI

Assuming you already are inside a virtualenv:

pip install paragoo

From Git

Create a new virtualenv (if you are not already in one) and install the necessary packages:

git clone https://github.com/aquatix/paragoo.git
cd paragoo
mkvirtualenv paragoo # or whatever project you are working on
pip install -r requirements.txt

Usage

Run python paragoo.py to get help. Typically, a command line looks like this:

python paragoo.py generate_site -s /path/to/site_config -t /path/to/site_templates -o /path/to/output_dir

A more involved command including a Secure CoPy to a remote server can look like this:

python paragoo.py generate_site --clean -s ../aquariusoft.org/site -t ../aquariusoft.org/templates -o /tmp/aqs --clean; scp -pqr /tmp/aqs/* vps01:/srv/aquariusoft.org/

or:

python paragoo.py generate_site --clean --cachebuster -s ../../../website/mydomain.net/site -t ../paragoo-theme-material/build/material-grey --pathprefix page --makerooturi -o /srv/mydomain.net

To see what commands are available, run paragoo with --help:

python paragoo.py --help

or:

python paragoo.py generate_site --help

Templates

Some pre-made templates to go with paragoo: paragoo material theme.

parawah?

The name is derived from παράγω, which is Greek for ‘generate’, ‘produce’.

What's new?

See the Changelog.