Introduce a Makefile

Author: vemv

.gitignore

@@ -0,0 +1 @@
+/package-lock.json

Makefile

@@ -0,0 +1,14 @@
+.PHONY: npm build deploy
+.DEFAULT_GOAL := build
+
+npm: package.json
+	npm install --no-fund --no-audit --no-progress --save-dev --loglevel=error
+	npm run antora -- --version
+
+build: npm
+	npm run antora -- --fetch antora-playbook.yml
+
+deploy: build
+	git add docs
+	git commit -m 'Update site docs'
+	git push

README.adoc

@@ -13,7 +13,7 @@ Installing the Antora is super simple:
 
 [source]
 ----
-$ npm i -g @antora/[email protected] @antora/[email protected]
+$ make npm
 ----
 
 Check out https://docs.antora.org/antora/2.0/install/install-antora/[the detailed installation instructions]
@@ -25,15 +25,15 @@ You can build the documentation locally from this repo.
 
 [source]
 ----
-$ cd cider-site
-$ antora --pull antora-playbook.yml
+$ cd docs.cider.mx
+$ make build
 ----
 
-After you're done with the initial setup you can use the `deploy` script to push changes to the site:
+After you're done with the initial setup you can use the `deploy` task to push changes to the site:
 
 [source]
 ----
-./deploy
+$ make deploy
 ----
 
 NOTE: You'll need commit access to the repository for this to work.

deploy

@@ -0,0 +1,9 @@
+{
+  "dependencies": {
+    "@antora/cli": "3.1.3",
+    "@antora/site-generator": "3.1.3"
+  },
+  "scripts": {
+    "antora": "antora"
+  }
+}