Merge pull request #397 from govdirectory/justfile

add a Justfile

README.md

@@ -18,6 +18,10 @@ Govdirectory is a static site meaning that it already has all of its pages gener
 
 Because each initial build of Snowman issues thousands (yes thousands) of SPARQL queries one should never make an **initial** build against `query.wikidata.org` but rather against a local Wikidata Query Service (WDQS) instance. However, because setting up a WDQS instance is nontrivial we provide a copy of a [Snowman build cache directory](https://github.com/govdirectory/website-cache). If in use, this will ensure Snowman only queries Wikidata when a query is updated.
 
+> [!TIP]
+> Some of the most common development commands are available through [Just](https://github.com/casey/just), if you do not use just you can still look in the `justfile` for hints.
+>
+
 ### Prerequisites
 
  - [Git](https://git-scm.com/)

jargon.txt

@@ -212,6 +212,7 @@ switzerland
 synergize
 Temaki
 th
+timeit
 timor
 TinyPNG
 tl

justfile

@@ -0,0 +1,23 @@
+@_default:
+ just --list
+
+# build the full project
+build:
+ snowman build --timeit
+
+# build the full project and once done, start the development server
+build-serve:
+ snowman build --timeit && snowman server
+
+# only update the static files of the last build
+build-static:
+ snowman build --static
+
+# clear all queries from the cache
+clear-cache:
+ snowman cache --invalidate
+
+# setup a new cache from our remote cache repository
+bootstrap-cache:
+ git clone https://github.com/govdirectory/website-cache .snowman
+