From b764487efda09b1b7cb3a9997c4f5293dd95cea0 Mon Sep 17 00:00:00 2001 From: Adam Mathes Date: Tue, 21 Feb 2017 20:36:04 -0800 Subject: update readme --- README.md | 39 +++++++++++++++++++++------------------ 1 file changed, 21 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 2c69aa3..7db66e6 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,11 @@ # snkt -`snkt` is a static web site generator for with a focus on simplicity and efficiency. +`snkt` is a static web site generator with focused on simplicity and efficiency. snkt only does a few things, but strives to do them well, in a coherent manner. snkt generates my [personal web site of ~2000 articles in under a second](https://trenchant.org/daily/2017/1/31/). Additional work may be done to increase efficiency, but it should be fast enough to regularly regenerate your site without concern in near real-time if needed. -## Status - -Currently in development. It powers [trenchant.org](https://trenchant.org) but is "alpha" quality and parts may change. - -## TODO - - * finish these docs - * half-baked / may change - * permalink formatter - * filters - * date handling in templates - * additional functions in templates - * themes + example sites - * complex archive types - * multiple archives/lists/post outputs - ## What Takes a bunch of plain text files, processes them via templates, and generates HTML. Pretty much like you'd expect of a static site generator. @@ -34,16 +18,22 @@ This time it's in Go. Maybe you'll find it useful. I found it fun to get myself thinking in Go. Also, it's 10x faster than the old version in Python. +## Status + +It powers [trenchant.org](https://trenchant.org) but is under active development and pieces may change. See TODO for future / in progress work. ## Getting snkt [Install Go](https://golang.org/doc/install) + Set up $GOPATH $ mkdir $HOME/go $ export GOPATH=$HOME/go - + +See also: [The GOPATH environment variable](https://golang.org/doc/code.html#GOPATH) + Add $GOPATH/bin to your PATH $ export PATH=$PATH:$GOPATH/bin @@ -54,6 +44,8 @@ Download and build `snkt` This should download depdendencies, build `snkt` and place it in $GOPATH/bin +`snkt` should now be a self-contained binary, you can move it if needed. + ## Setting up a site Use the "-init" option to create the skeleton for a new site - @@ -286,3 +278,14 @@ filters: *also not done* +## TODO + + * finish these docs + * half-baked / may change + * permalink formatter + * filters + * date handling in templates + * additional functions in templates + * themes + example sites + * complex archive types + * multiple archives/lists/post outputs -- cgit v1.2.3