From f841c5922e4151f46f8729222f20f11cd011195f Mon Sep 17 00:00:00 2001 From: Adam Mathes Date: Thu, 9 Feb 2017 20:28:51 -0800 Subject: readme updates --- README.md | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index cc099c8..03c4c8f 100644 --- a/README.md +++ b/README.md @@ -2,18 +2,18 @@ Snkt is a static web site generator for with a focus on simplicity and efficiency. -## Simplicity - snkt only does a few things, but strives to do them well, in a coherent manner. -## Efficiency - 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 + * lots of other things + ## 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. @@ -68,7 +68,7 @@ This will create: * `config.yml` -- configuration file -## Writing Your First Post +## First Post A one line plaint text file is a valid post. @@ -92,16 +92,16 @@ Snkt will use `config.yml` by default if it's in the working directory. Otherwis ``` Usage of snkt: - -b build the site - -c string + -b build site + -c configuration configuration file (default "config.yml") -h help -init directory initialize new site at directory - -p start local HTTP server for preview + -p preview site with local HTTP server -v print version number -verbose - log more actions while building + log actions during build ``` ## Configuration File @@ -148,8 +148,21 @@ Post with a preamble -- ## Templates +Templates use the standard library [Go text/template](https://golang.org/pkg/text/template/). + +scary line of unfinished documentation + +--- + +### home +### post +### archive +### rss + ## Advanced Features +### paged template + ### Permalink and filename formatter ### Filters -- cgit v1.2.3