Mercurial > blahgd > experimental
changeset 1022:1224c5a5be96
samples: add a sample config that demonstrates every config knob
Signed-off-by: Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
author | Josef 'Jeff' Sipek <jeffpc@josefsipek.net> |
---|---|
date | Mon, 22 Jun 2020 09:28:03 -0400 |
parents | 15914b85084b |
children | a39617d07de4 |
files | samples/full.lisp |
diffstat | 1 files changed, 103 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/full.lisp Mon Jun 22 09:28:03 2020 -0400 @@ -0,0 +1,103 @@ +( + ; The configuration file is a single s-expression. For the most part, it is + ; a list of key-value pairs, with a couple of exceptions. A semicolon + ; character starts a comment, and everything to the end of the line is + ; ignored. + + ;;;;;; + ; SCGI + + ; The port to listen on for SCGI requests. Defaults to port 2014. + (scgi-port . 4321) + + ; Number of threads to use for SCGI request processing. 0 means use one + ; per CPU. Default is 0. + (scgi-threads . 4) + + ;;;;;; + ; Paths & URLs + + ; The location of the data directory. Default is "./data". This is where + ; the posts, comments, and other assorted data is read and written. + ; + ; Under this path, two subdirectories must exist: "posts" and "requests". + ; The requests directory is used for request logging. The posts directory + ; contains a directory for each post. + (data-dir . "/blahg/data") + + ; The location of the web directory with static files. Default is "./web". + (web-dir . "/blahg/web") + + ; The location of the templates directory. Default is "./templates". + (template-dir . "/blahg/templates") + + ; The base URL for the blahg. This is the URL for the index page. + (base-url . "http://blahg.example.com") + + ; The base URL for the \bug fmt3 command. + (bug-base-url . "http://bugs.example.com") + + ; The base URL for the \wiki fmt3 command. + (wiki-base-url . "http://en.wikipedia.org/wiki") + + ; The base URL for the \photo and \photolink fmt3 commands. + (photo-base-url . "http://example.com/photos") + + ;;;;;; + ; Comment spam filtering + ; (See docs/comment-spam.txt for details about comment spam fighting + ; techniques.) + + ; The minimum and maximum number of seconds since a page load that the + ; comment form is valid. Submitting a comment before the minimum or after + ; the maximum number of seconds elapsed will cause the comment to be + ; discarded automatically. Defaults are 10 seconds minimum, 1 day maximum. + (comment-min-think . 10) + (comment-max-think . 86400) + + ; The two captcha numbers. To submit a comment, the user must provide the + ; sum of these. By default, two random numbers are chosen on startup. + (comment-captcha-a . 27) + (comment-captcha-b . 42) + + ;;;;;; + ; Pagination & other rendering tweaks + + ; Number of posts to display per page. Defaults are 10 for text/html + ; output and 15 for atom/rss2 feeds. + (html-index-stories . 10) + (feed-index-stories . 15) + + ; The minimum and maximum font size used for tag cloud words. Defaults are + ; 6pt minimum and 18pt maximum. + (tagcloud-min-size . 6) + (tagcloud-max-size . 18) + + ;;;;;; + ; Twitter + + ; The Twitter username to attribute the posts to. + (twitter-username . "TwitterName") + + ; The description of the blahg for twitter card rendering. + (twitter-description . "My Personal Blahg") + + ;;;;;; + ; Migration + + ; A map of category names/numbers to tag names. This allows for easy + ; migration from wordpress installations where categories are identified by + ; a number. The daemon generates a permanent redirect (HTTP 301) to the + ; corresponding tag URL. The category names are strings. + ; + ; Note that this is a list and therefore there is no '.' after + ; category-to-tag. Each entry is of the format: + ; (category-name . tag-name) + (category-to-tag + ("1" . "miscellaneous") + ("2" . "programming") + ("3" . "work") + ("9" . "rants") + ("11" . "movies") + ("12" . "humor") + ("star-trek/tng" . "tng")))