StaGen is the static site generator behind WizTools.org.
StaGen is written in Java 8, and supports:
- Markdown for content.
- StringTemplate 4 for templating.
- JSON for storing configuration.
Read the tutorial.
At the core of StaGen engine, Guice is used for wiring the implementations with the interfaces. StaGen can be easily extended to support any new format.
This static site generator was developed for maintaining a site like WizTools.org. This is best suited for sites that have few pages generated out of few templates. We do not support themes or blog-like-static-pages. Of course, by nature of flexibility of StaGen, support for themes and blogs can be easily hacked into a StaGen site.
Read the tutorial to get started.
Prerequisite: Java 8.
Download the .zip or .tgz package from our releases section. Extract the content, and add to your PATH variable the bin folder. Once this is done, you will be able to execute stagen using the command stagen.
To build (requires Java 8 and Maven 3, or above versions):
$ mvn package
In the target directory you will find the build artifacts.
Encourage first-time visitors to read the tutorial. This will help in understanding the conventions used by StaGen.
In the command-prompt, to create a new template project structure (current direcory must be empty to create new project!):
$ stagen init
To build the project:
$ stagen gen
This command will generate the site under target directory.
To run the project using the embedded Jetty server:
$ stagen run
The run command also monitors project directory for changes, and builds automatically when a change is detected. Press Ctrl+C to quit.
To delete the target directory:
$ stagen clean
To view cli options:
$ stagen -h