statico

command module
v0.0.7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 16, 2021 License: MIT Imports: 20 Imported by: 0

README

Statico

A static site generator for creative devs

If you like any of my work, you can support me on: https://barelyhuman.dev/donate

Motivation

I use markdown for most of my writing and really like the simplicity. This started as an experiment to power my websites but is now at a decent level of generalisation to be used by others.

Features

  • Supports Templates (Go Templates)
  • Watch Mode
  • Local server
  • ⚡ Fast
  • Markdown => HTML

Documentation

Documentation - You can find your documentation here

Install

  • You can download the binaries from the releases page for your specific system and add it to a directory that is in your PATH variables.

Usage

$ statico [flags]

Usage of statico:
  -c -config
        alias -config
  -config string
        Config file to use
  -s -serve
        alias -serve
  -serve
        Enable file server
  -w -watch
        alias -watch
  -watch
        Start statico in watch mode

statico doesn't come with any necessary boilerplate and just injects a few variables into the provided templates using a .config.yml file. You can either use the default template or make your own with inspirations and hacking the following available templates

The tool needs a config.yml and you can find a template in this repository config.template.yml

Template Development

  • If you wish to develop templates for the same, please try naming them in the following format statico-<name>-template, to make it easier for people looking for other templates and make sure you have a demo/preview link for the same on the repo.

  • The templates are purely built on go-templates and you can include and do all kinds of stuff that you'd do with a normal go template, the only limitation being that the config can take only so many 4 types of template name so those 4 are to act as your umbrella templates, you can always use the above example templates for checking out use-cases

Contribute

Issues and PR's are your way to go, fork the repository, create a PR and you're done. Just make sure you let the maintainer know about the issue you pick up to avoid overlaps

License

MIT © Reaper

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL