Staticli

This application provides a number of tools related to static site generation, all running in docker containers from a single binary file. Rather than go through the hassle of installing Ruby, rake, bundler, jekyll, python, proselint, gulp, etc. you only need the one single binary file and to have docker installed.

Tools

Staticli provides the tools that its developers regularly use to work with static websites. We're open to pull requests for additional tooling, but it must be relevant to static web site development (feel free to create your own Cali app for other tools). The tools we currently provide include:

Installation

Usage

From this one single binary you can now run rake tasks to preview and validate Jekyll blogs, run proselint to check for best practises in writing, and run gulp to turn sass into css. All of this happens inside docker containers, so you don't actually need to install any extra tooling. You will need an internet connection the first time you run each subcommand in order to download the container though.

For any command which exposes a port (typically an http server to render a site) we default to exposing this on port 2000. You can override this by setting --port 4000 or -p 4000 to listen on (for example) port 4000 instead.

staticli ag runs Silver Searcher in the current directory.

staticli rake runs bundle install --path=_vendor && bundle exec rake $@ in the current directory. This assumes the default rake task runs preview on a Jekyll site, and therefore exposes port 4000 on the container as port 2000 on the host. This means you can browse to http://127.0.0.1:2000 to view the site. You can change the port exposed on the host by setting --port 4000 to use (for example) port 4000.

staticli bundle runs bundle in the current directory. Since the rake command installs required gems anyway, this command is mostly useful as a way of upgrading gems.

staticli gulp runs the gulp watch task. You can add -t foo to run the foo task instead.

staticli heroku runs the Heroku cli, and takes any parameters and subcommands you need (uses ~/.netrc for authentication)

staticli hugo runs the hugo static site generator

staticli mkdocs new . creates a new static website for project documentation, staticli mkdocs serve will serve it (though note you'll need to set dev_addr)

staticli ponysay runs ponysay, a cowsay replacement for ponies. Whilst this isn't strictly speaking a static site generator, it can be useful for notifying that we've finished generating a static site

staticli proselint README.md runs proselint against the file README.md to check for best practises in writing.

staticli simplehttp runs Python SimpleHTTP in the current directory.

staticli surge runs surge, allowing you to deploy the current directory to a surge.sh site.

staticli github-release for releasing something to github (see the Makefile for how this is used, it's probably not that helpful except for releasing new versions of staticli)

You can also see what version of staticli you are running with staticli version which will also tell you about any available updates if you are online. If there are available updates you can get the latest version with staticli update. You can also use staticli update to update all of the local Docker images that Staticli uses by passing in -i.