docs

jawsboot/README.md

@@ -0,0 +1,25 @@
+# jawsboot
+
+Provides a statically served and embedded version of [Bootstrap](https://getbootstrap.com/).
+
+Example usage that loads your templates, favicon and Bootstrap. Also uses the templatereloader
+so that when running with `-tags debug` or `-race` templates are reloaded from disk as needed.
+
+```go
+//go:embed assets
+var assetsFS embed.FS
+
+func setupRoutes(jw *jaws.Jaws, mux *http.ServeMux) (err error) {
+	var tmpl jaws.TemplateLookuper
+	if tmpl, err = templatereloader.New(assetsFS, "assets/ui/*.html", ""); err == nil {
+		jw.AddTemplateLookuper(tmpl)
+		var faviconuri string
+		if faviconuri, err = staticserve.HandleFS(assetsFS, "assets", "static/images/favicon.png", mux.Handle); err == nil {
+			if err = jawsboot.Setup(jw, mux.Handle, faviconuri); err == nil {
+				// set up your other routes
+			}
+		}
+	}
+	return
+}
+```

staticserve/README.md

@@ -0,0 +1,6 @@
+# staticserve
+
+`staticserve` is a cache-busting HTTP handler for static files. It supports
+GET operations requesting the file with no encoding or gzip encoding.
+
+For an example how to use it, see `jawsboot/README.md`.

staticserve/staticserve.go

@@ -11,9 +11,9 @@ import (
 )
 
 type StaticServe struct {
-	Name        string
-	ContentType string
-	Gz          []byte
+	Name        string // the cache-busting file name, e.g. "static/filename.1234567.js"
+	ContentType string // Content-Type of the file, e.g. "application/javascript"
+	Gz          []byte // gzipped data, will be unpacked as needed
 }
 
 // New returns a StaticServe that serves the given data with a filename like 'filename.12345678.ext'.

templatereloader/README.md

@@ -0,0 +1,7 @@
+# templatereloader
+
+A templatereloader is a `jaws.TemplateLookuper` that will reload templates from
+disk as needed if running with `-tags debug` or `-race`. If not, it simply calls
+`template.New("").ParseFS(fsys, fpath)` and has no overhead.
+
+For example usage, see `jawsboot/README.md`