Skip to content

toucansites/toucan

Repository files navigation

Toucan

Toucan is a markdown-based Static Site Generator (SSG) written in Swift.

Install

Clone or download the repository & run:

# clone the repository & install toucan
git clone https://github.com/toucansites/toucan.git
cd toucan
make install
# verify installation
which toucan

NOTE: version 1.0.0-alpha.1 only supports macOS, Linux support is coming soon.

Available commands

generate

This command will generate all the static files, based on a source & destination directory, it is possible to override the base url via an optional parameter.

toucan generate ./src ./docs --base-url http://localhost:3000/

watch

Watch the source folder to any changes, to automatically re-generate the site.

toucan watch ./src ./docs --base-url http://localhost:3000/

serve

Serves a given folder using an optional port number. Your site will be available under http://localhost:3000/, if you run like this:

toucan serve ./docs -p 3000