|author||Adam Mathes <email@example.com>||2017-02-21 20:36:04 -0800|
|committer||Adam Mathes <firstname.lastname@example.org>||2017-02-21 20:36:04 -0800|
Diffstat (limited to 'README.md')
1 files changed, 21 insertions, 18 deletions
@@ -1,27 +1,11 @@
-`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.
-Currently in development. It powers [trenchant.org](https://trenchant.org) but is "alpha" quality and parts may change.
- * 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
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.
+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
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*
+ * 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