summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authoremkael <emkael@tlen.pl>2017-06-15 12:57:07 +0200
committeremkael <emkael@tlen.pl>2017-06-15 12:57:07 +0200
commite5913200a9f566d841b09a40b050e69dce518b2d (patch)
tree433873bfe1efba84b281af9171f24dca87c07ad8 /docs
parentaac9547683cddb963ceb6d72d8b03e456970b21e (diff)
Makefile documentation
Diffstat (limited to 'docs')
-rw-r--r--docs/building.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/building.md b/docs/building.md
index 0ccb1bf..572764b 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -22,3 +22,37 @@ python players.py http/players/
```
Name, surname and club are always used from the current `players` table. Regions, genders and age categories are read per-ranking.
+
+---
+
+Provided, is also a Makefile to do all the work within a standard setup.
+
+To build all the pages, use:
+
+```
+make
+```
+
+To minimize generated ranking pages, use:
+
+```
+make minimize
+```
+
+To sync the generated content to a remote server of your choice, use:
+
+```
+make deploy
+```
+
+Note that the last command is designed with automatization in mind, so you'd need:
+
+* `sshpass` utility to be able to provide SSH password for `rsync` in command line
+ * proper `config/deploy-path` and `config/deploy-pass` files, which are encrypted in this repository
+
+If you want to use some other way of deploying content to your target environment (like passwordless SSH connection for rsync/sftp), for now you have to do it manually.
+
+You can also use subtargets of `make`, which (re)build only part of the content:
+
+ * `make rankings` builds only ranking pages (and consists of `make tables` which creates ranking tables and `make editions` which inserts ranking editions menu into ranking page - useful if you generated ranking page for an edition manually and now you only want to re-render that menu in other ranking pages)
+ * `make players` builds only players pages