X-Git-Url: https://git.llucax.com/software/blitiri.git/blobdiff_plain/a952c0e94cd764cf1d1cb177c46ebc0cf8c2785d..72a7e1dd08a61f423fd2356a022f932777468f9a:/config.py.sample

diff --git a/config.py.sample b/config.py.sample
index 512e1a4..79efac7 100644
--- a/config.py.sample
+++ b/config.py.sample
@@ -1,3 +1,4 @@
+#coding: utf8
 
 # This is the sample configuration file for a blitiri blog engine.
 # If you omit a variable, the default will be used.
@@ -9,10 +10,19 @@
 # Directory where entries are stored
 data_path = "/tmp/blog/data"
 
+# Are comments allowed? (if False, comments_path option is not used)
+enable_comments = False
+
+# Directory where comments are stored (must be writeable by the web server)
+comments_path = "/tmp/blog/comments"
+
 # Path where templates are stored. Use an empty string for the built-in
 # default templates. If they're not found, the built-in ones will be used.
 templates_path = "/tmp/blog/templates"
 
+# Path where the cache is stored (must be writeable by the web server)
+cache_path = "/tmp/blog/cache"
+
 # URL to the blog, including the name. Can be a full URL or just the path.
 blog_url = "/blog/blitiri.cgi"
 
@@ -29,4 +39,47 @@ author = "Hartmut Kegan"
 # Article encoding
 encoding = "utf8"
 
+# You can customize the captcha engine by providing a Captcha class with this
+# interface:
+# Constructor:
+# 	Captcha(article) -> constructor, takes an article[1] as argument
+# Attributes:
+# 	puzzle -> a string with the puzzle the user must solve to prove he is
+# 	          not a bot (can be raw HTML)
+# 	help -> a string with extra instructions, shown only when the user
+# 	        failed to solve the puzzle
+# Methods:
+#	validate(form_data) -> based on the form data[2],  returns True if
+#	                       the user has solved the puzzle uccessfully
+#	                       (False otherwise).
+#
+# Note you must ensure that the puzzle attribute and validate() method can
+# "communicate" because they are executed in different requests. You can pass a
+# cookie or just calculate the answer based on the article's data, for example.
+#
+# Example: a captcha class to completely disable the captcha feature
+# class Captcha (object):
+# 	def __init__(self, article):
+# 		self.puzzle = ''
+# 		self.help = ''
+# 	def validate(form_data):
+# 		return True
+# Remove the captcha input field from the form template, and that's it!
+#
+# [1] article is an object with all the article's information:
+# 	path -> string
+# 	created -> datetime
+# 	updated -> datetime
+# 	uuid -> string (unique ID)
+# 	title -> string
+# 	author -> string
+# 	tags -> list of strings
+# 	raw_contents -> string in rst format
+# 	comments -> list of Comment objects (not too relevant here)
+# [2] form_data is an object with the form fields (all strings):
+# 	author, author_error
+# 	link, link_error
+# 	catpcha, captcha_error
+# 	body, body_error
+# 	action, method