aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAdam Mathes <adam@trenchant.org>2017-02-21 20:36:04 -0800
committerAdam Mathes <adam@trenchant.org>2017-02-21 20:36:04 -0800
commitb764487efda09b1b7cb3a9997c4f5293dd95cea0 (patch)
tree6cebec1252dbd311e337935bde8eb91cafca8bf9
parentff4ebd38aa7d5316418979e7256048638eae9ed0 (diff)
downloadsnkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.tar.gz
snkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.tar.bz2
snkt-b764487efda09b1b7cb3a9997c4f5293dd95cea0.zip
update readme
-rw-r--r--README.md39
1 files 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