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 # URL to the blog, including the name. Can be a full URL or just the path.
  24 blog_url = "/blog/blitiri.cgi"
  25
  26 # Style sheet (CSS) URL. Can be relative or absolute. To use the built-in
  27 # default, set it to blog_url + "/style".
  28 css_url = blog_url + "/style"
  29
  30 # Blog title
  31 title = "I don't like blogs"
  32
  33 # Default author
  34 author = "Hartmut Kegan"
  35
  36 # Article encoding
  37 encoding = "utf8"
  38
  39 # You can customize the captcha engine by providing a Captcha class with this
  40 # interface:
  41 # Constructor:
  42 #       Captcha(article) -> constructor, takes an article[1] as argument
  43 # Attributes:
  44 #       puzzle -> a string with the puzzle the user must solve to prove he is
  45 #                 not a bot (can be raw HTML)
  46 #       help -> a string with extra instructions, shown only when the user
  47 #               failed to solve the puzzle
  48 # Methods:
  49 #       validate(form_data) -> based on the form data[2],  returns True if
  50 #                              the user has solved the puzzle uccessfully
  51 #                              (False otherwise).
  52 #
  53 # Note you must ensure that the puzzle attribute and validate() method can
  54 # "communicate" because they are executed in different requests. You can pass a
  55 # cookie or just calculate the answer based on the article's data, for example.
  56 #
  57 # Example: a captcha class to completely disable the captcha feature
  58 # class Captcha (object):
  59 #       def __init__(self, article):
  60 #               self.puzzle = ''
  61 #               self.help = ''
  62 #       def validate(form_data):
  63 #               return True
  64 # Remove the captcha input field from the form template, and that's it!
  65 #
  66 # [1] article is an object with all the article's information:
  67 #       path -> string
  68 #       created -> datetime
  69 #       updated -> datetime
  70 #       uuid -> string (unique ID)
  71 #       title -> string
  72 #       author -> string
  73 #       tags -> list of strings
  74 #       raw_contents -> string in rst format
  75 #       comments -> list of Comment objects (not too relevant here)
  76 # [2] form_data is an object with the form fields (all strings):
  77 #       author, author_error
  78 #       link, link_error
  79 #       catpcha, captcha_error
  80 #       body, body_error
  81 #       action, method
  82