diff options
author | Adam Mathes <adam@trenchant.org> | 2017-02-21 20:36:04 -0800 |
---|---|---|
committer | Adam Mathes <adam@trenchant.org> | 2017-02-21 20:36:04 -0800 |
commit | b764487efda09b1b7cb3a9997c4f5293dd95cea0 (patch) | |
tree | 6cebec1252dbd311e337935bde8eb91cafca8bf9 | |
parent | ff4ebd38aa7d5316418979e7256048638eae9ed0 (diff) | |
download | snkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.tar.gz snkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.tar.bz2 snkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.zip |
update readme
-rw-r--r-- | README.md | 39 |
1 files changed, 21 insertions, 18 deletions
@@ -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 |