From 6d02b98e17eb3541e9f16ebcee6cb983212ecfa0 Mon Sep 17 00:00:00 2001 From: "Rafael G. Martins" Date: Mon, 12 Mar 2018 00:29:35 +0100 Subject: make: man: improved rule docs --- man/blogc-make.1.ronn | 114 +++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 89 insertions(+), 25 deletions(-) (limited to 'man') diff --git a/man/blogc-make.1.ronn b/man/blogc-make.1.ronn index 4dc199f..6d5552b 100644 --- a/man/blogc-make.1.ronn +++ b/man/blogc-make.1.ronn @@ -35,45 +35,109 @@ See blogcfile(5) for details on the file format. ## HELPER RULES - * `all`: - Run all build rules. This is the default rule. +### all - * `clean`: - Clean built files and empty directories in output directory. +Run all build rules. This is the default rule. - * `runserver`: - Run `blogc-runserver(1)` pointing to output directory, if available. This - rule accepts some arguments, in the following format: +### clean - runserver:host=127.0.0.1,port=8080,threads=20 +Clean built files and empty directories in output directory. - The values in the example are the default values. +### runserver + +Run `blogc-runserver(1)` pointing to output directory, if available. This +rule accepts some arguments, in the following format: + + runserver:host=127.0.0.1,port=8080,threads=20 + +The values in the example are the default values. ## BUILD RULES - * `index`: - Build website index from posts. +### index + +Build website index from posts. + +The rule passes the following helper variables to blogc(1): + + * `MAKE_RULE`: + `index` + * `MAKE_TYPE`: + `post` + +### atom + +Build main atom feed from posts. + +The rule passes the following helper variables to blogc(1): + + * `MAKE_RULE`: + `atom` + * `MAKE_TYPE`: + `atom` + +### atom_tags + +Build atom feeds for each tag from posts. + +The rule passes the following helper variables to blogc(1): + + * `MAKE_RULE`: + `atom_tags` + * `MAKE_TYPE`: + `atom` + +### pagination + +Build pagination pages from posts. + +The rule passes the following helper variables to blogc(1): + + * `MAKE_RULE`: + `pagination` + * `MAKE_TYPE`: + `post` + +### posts + +Build individual pages for each post. + +The rule passes the following helper variables to blogc(1): + + * `MAKE_RULE`: + `posts` + * `MAKE_TYPE`: + `post` + * `MAKE_SLUG`: + The slug of the post being built, as provided in blogcfile + +### tags + +Build post listings for each tag from posts. + +The rule passes the following helper variables to blogc(1): - * `atom`: - Build main atom feed from posts. + * `MAKE_RULE`: + `tags` + * `MAKE_TYPE`: + `post` - * `atom_tags`: - Build atom feeds for each tag from posts. +### pages - * `pagination`: - Build pagination pages from posts. +Build individual pages for each page. - * `posts`: - Build individual pages for each post. +The rule passes the following helper variables to blogc(1): - * `tags`: - Build post listings for each tag from posts. + * `MAKE_RULE`: + `pages` + * `MAKE_TYPE`: + `page` + * `MAKE_SLUG`: + The slug of the page being built, as provided in blogcfile - * `pages`: - Build individual pages for each page. +### copy - * `copy`: - Copy static files from source directory to output directory. +Copy static files from source directory to output directory. ## FILES -- cgit v1.2.3-18-g5258