config.py.sample

   1 #coding: utf8
   2
   3 # This is the sample configuration file for a blitiri blog engine.
   4 # If you omit a variable, the default will be used.
   5 #
   6 # If you prefer, you can set the values directly inside blitiri.cgi and not
   7 # have a configuration file.
   8
   9
  10 # Directory where entries are stored
  11 data_path = "/tmp/blog/data"
  12
  13 # Are comments allowed? (if False, comments_path option is not used)
  14 enable_comments = False
  15
  16 # Directory where comments are stored (must be writeable by the web server)
  17 comments_path = "/tmp/blog/comments"
  18
  19 # Path where templates are stored. Use an empty string for the built-in
  20 # default templates. If they're not found, the built-in ones will be used.
  21 templates_path = "/tmp/blog/templates"
  22
  23 # Path where the cache is stored (must be writeable by the web server)
  24 cache_path = "/tmp/blog/cache"
  25
  26 # URL to the blog, including the name. Can be a full URL or just the path.
  27 blog_url = "/blog/blitiri.cgi"
  28
  29 # Style sheet (CSS) URL. Can be relative or absolute. To use the built-in
  30 # default, set it to blog_url + "/style".
  31 css_url = blog_url + "/style"
  32
  33 # Blog title
  34 title = "I don't like blogs"
  35
  36 # Default author
  37 author = "Hartmut Kegan"
  38
  39 # Article encoding
  40 encoding = "utf8"
  41
  42 # You can customize the captcha engine by providing a Captcha class with this
  43 # interface:
  44 # Constructor:
  45 #       Captcha(article) -> constructor, takes an article[1] as argument
  46 # Attributes:
  47 #       puzzle -> a string with the puzzle the user must solve to prove he is
  48 #                 not a bot (can be raw HTML)
  49 #       help -> a string with extra instructions, shown only when the user
  50 #               failed to solve the puzzle
  51 # Methods:
  52 #       validate(form_data) -> based on the form data[2],  returns True if
  53 #                              the user has solved the puzzle uccessfully
  54 #                              (False otherwise).
  55 #
  56 # Note you must ensure that the puzzle attribute and validate() method can
  57 # "communicate" because they are executed in different requests. You can pass a
  58 # cookie or just calculate the answer based on the article's data, for example.
  59 #
  60 # Example: a captcha class to completely disable the captcha feature
  61 # class Captcha (object):
  62 #       def __init__(self, article):
  63 #               self.puzzle = ''
  64 #               self.help = ''
  65 #       def validate(form_data):
  66 #               return True
  67 # Remove the captcha input field from the form template, and that's it!
  68 #
  69 # [1] article is an object with all the article's information:
  70 #       path -> string
  71 #       created -> datetime
  72 #       updated -> datetime
  73 #       uuid -> string (unique ID)
  74 #       title -> string
  75 #       author -> string
  76 #       tags -> list of strings
  77 #       raw_contents -> string in rst format
  78 #       comments -> list of Comment objects (not too relevant here)
  79 # [2] form_data is an object with the form fields (all strings):
  80 #       author, author_error
  81 #       link, link_error
  82 #       catpcha, captcha_error
  83 #       body, body_error
  84 #       action, method
  85