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")))