From 5ddbdbc453f536b11415030f9c7312bb99be2527 Mon Sep 17 00:00:00 2001 From: sanine Date: Fri, 21 Jan 2022 10:32:45 -0600 Subject: update README.md config keys table --- README.md | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 7f53a8e..0884788 100644 --- a/README.md +++ b/README.md @@ -22,17 +22,23 @@ Move the resulting `argent` binary to somewhere on your PATH (probably `~/bin`). using argent -------------------------------- -You need to provide Argent with a configuration file. By default this file is `argent.lua` in the current working directory; you can override that with the `-c [config_file]` command-line option. The configuration file should be a Lua script that returns a table containing the following: - -| Key | Type | Meaning | -|------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------| -| site_directory | string | filename of the directory where the site files are located | -| layout_directory | string | filename of the directory where layouts are located | -| exclude | table | array of files and directories in the `site_directory` to exclude from the public site | -| include | table | array of files and directories in the `site_directory` to forcibly include (e.g. `.htaccess` files, since dotfiles are normally excluded) | -| keep | table | array of files and directories in the public result to not touch during site generation. | -| noprocess | table | array of files and directories in the `site_directory` to exclude from processing (e.g. lua files specified here will **not** be converted into HTML). | -| rss_include | table | array of files and directories to include in the site's `rss.xml` file. | +You need to provide Argent with a configuration file. By default this file is `argent.lua` in the current working directory; you can override that with the `-c [config_file]` command-line option. The configuration file should be a Lua script that returns a table. The keys for this table are listed below. None of these are mandatory, and if they are omitted their default values will be used. + +| Key | Type | Default | Meaning | +|------------------|--------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| site_name | string | (nil) | the name of the site (used for RSS feeds, and may be used by layouts) | +| site_address | string | (nil) | the web address of the site root. required for RSS. | +| site_description | string | (nil) | a description of the site, used for RSS | +| site_copyright | string | (nil) | copyright message for RSS. | +| site_directory | string | site | name of the directory where the site files are located | +| output_directory | string | public | name of the directory to store the output in | +| layout_directory | string | (nil) | filename of the directory where layouts are located | +| plugin_directory | string | (nil) | directory to add to `package.path` | +| exclude | table | (nil) | array of patterns. if a file in `site_directory` matches one of the patterns, it will be excluded from the output. | +| include | table | (nil) | array of patterns. if a file in `site_directory` matches one of the patterns, it will be included, even if it matches an exclusion pattern. (This is useful for things like `.htaccess` files, since dotfiles are normally excluded) | +| keep | table | (nil) | array of files and directories in the public result to not touch during site generation. | +| noprocess | table | (nil) | array of patterns. if a file in `site_directory` matches one of the patterns, it will not be processed but instead copied into the output. (This is useful for .lua files you would like to include in the output.) | +| rss_include | table | (nil) | array of patterns. if set, the site will create an RSS feed and include matching files in it. | ### site directory -- cgit v1.2.1