1 files changed, 28 insertions(+), 4 deletions(-)

M README

@@ 5,8 5,11 @@ run on.
 It generates bare-bones web pages based on markdown input, adding two special
 files:
 
- - contents.html -- a list of all pages;
- - keywords.html -- a keyword index.
+ - contents.html -- a list of all pages (see TOC variable below);
+ - keywords.html -- a keyword index (see INDEX variable below).
+
+
+USAGE
 
 To build a site, put your markdown files in a subdirectory ('_posts' by
 default) and run make(1):


@@ 15,14 18,35 @@ default) and run make(1):
 
 You can use the following variables to overwrite makeweb defaults:
 
- - POSTS	- where to find the markdown files;
- - BUILD_DIR	- where the HTML output should be saved;
  - TOC		- name of the Table of Contents file;
  - INDEX	- name of the Keyword Index file;
+ - POSTS	- where to find the markdown files;
+ - BUILD_DIR	- where the HTML output should be saved;
  - MMD		- path of the multimarkdown program, if not found in $PATH.
+ - CUSTOM_CONFIG - path of an additional Makefile to include.
 
 To customise presentation of the pages generated by multimarkdown, use the
 `css:' property in the front matter to provide location of the CSS sheet.
 
+
+CUSTOMISATION
+
+To include some files not processed by makeweb in ${BUILD_DIR} (for easier
+distribution), you can add custom definitions.  For example, to include a CSS
+file you can save following definitions in custom.mk:
+
+	web: copy-css
+
+	copy-css:
+		cp s.css ${BUILD_DIR}/
+
+and then just run:
+
+	$ make CUSTOM_CONFIG=custom.mk
+
+Make will figure out additional dependencies and include the CSS in the output
+directory.  This method can also be used to change variables like TOC, INDEX,
+POSTS and so on.
+
 References:
 [1] https://fletcherpenney.net/multimarkdown/