From e5913200a9f566d841b09a40b050e69dce518b2d Mon Sep 17 00:00:00 2001 From: emkael Date: Thu, 15 Jun 2017 12:57:07 +0200 Subject: Makefile documentation --- docs/building.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) (limited to 'docs') 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 -- cgit v1.2.3