Create the comments directory for an article if it doesn't exist

It is needed when comments are enabled after the article was added,
otherwise the save() will fail.

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Fix valid_link() to avoid scheme repetition

valid_link("mailto:x@y") returns "mailto:mailto:x@y". This patch fixes it,
and simplifies the code path.

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Fix links to articles in the list view

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Simplify captcha configuration

We provide some built-in captcha classes, and the user can select them
with a simple string. He/she can still use a custom class.

At the moment, only the title captcha is supported.

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Use decorator syntax

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Make the cached() decorator take into account all arguments

Also, while at it, move the test for cache_path into the decorator, and
fix the cache file name.

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Improve cache_path option comments

Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>

Fix 80 chars column limit

Add basic caching support to restructured text rendering

Add the total render time as a comment when handling CGI

Add post preview

This patch adds a post preview feature to see how a post is rendered without
adding it to the articles DB, using the URI /preview/post/ARTICLE_PATH (where
ARTICLE_PATH is the relative path to the article from the data path).

Disable unsecure rst directives for online commenting

Be aware of rst parsing errors with no line information

Remove \r (use unix style end of lines) from comments body

Store the sanitized form data when commenting online

When storing a comment, we should use the validated data instead of
the raw one.

Add (customizable) captcha support

Validate link form field when adding a comment online

Add form error reporting to online comments

Make the comment author a link only if the comment has a link attribute

Search for the right template name when rendering the comment form

Add online commenting support

This patch adds support for online commenting. A new template
``com_form.html`` to customize the commenting form is added. Online
commenting is only available if ``enable_comments`` is True, and you need
to let the web server write to the ``comments_path`` directory.

Note that this patch exposes the race in the CommentDB.save() method
(described in the previous commit), but since this event is unlikely
enough, we don't care at the moment and can be fixed later if needed.

Add a configuration option to enable the comments support

Show comments when displaying a single article

Add basic comments support

This patch implements the basics for comments support. Two new classes are
added: Comment and CommentDB.

Comments are stored in almost the same format as articles, but a comment DB is
present for each article. All comments are stored in the ``comments_path``
directory (which usually won't be the same as the ``data_path`` because,
when online comment posting is implemented, it will need to be writeable by
the web server). Each article should have a subdirectory in that path (with
the article's uuid as directory name), where a ``db`` file is expected, with
this format::

comment number, creation time (epoch)

Comments are numbered incrementally and this number is considered both the
ID and the filename where the comment contents are stored under the
article's comments directory. An empty line in the comments DB represents
a deleted comment.

Comment files have a similar format to Article files, a header is expected
in the form of key, values:
Author: Leandro Lucarella
Link: http://www.example.com/
Headers end with an empty line, where the body begin, in RestructuredText
format. The link can be any URL (for example, mailto:pomelo@example.com).

A new attribute ``comments`` is added to Article class, with a list of
comments for that article (loaded via the CommentDB class).

Note that a race is possible if more than one process add a comment at the
same time, because of how the CommentDB.save() method is implemented (the
same happens with ArticleDB.save(), but it's more likely that 2 comments
are added at the same, for example when online commenting is implemented).

Don't store leading slashes for paths in the article's DB

Use os.path.join() to build filenames

Rename DB to ArticleDB

Properly translate HTML entities in user inputs when rendering

Strip article's haders values

Add created and updated as optional parameters to Article constructor

Remove dead code

Move docutils rendering bits to a helper function

Avoid code repetition by adding a helper function Template.get_template()

Avoid code repetition by adding Article.to_vars() method

Make default template Use XHTML 1.0 Strict

The default template was not valid HTML 4.01 Transitional.

Remove <br/>s to make the default template more XHTML 1.0 Strict friendly

Use text/css as Content-type when rendering the style sheet

Use a fixed width in the default style sheet

Apply os.path.realpath() to *_path config variables to support relative paths

Make blitiri.cgi work as a symlink

Add a "list" view to list all articles.

Relax config import to make it usable.

The os.path.isfile("config.py") check is too strict: it makes blitiri
usable from the command line only if it's ran in the directory where it
lives.

There's no point in doing that, let's just relax the import.
The chances of a config module collision are too low to be worth the
usability problem.

Signed-off-by: Alberto Bertogli <albertito@gmail.com>

Be more verbose with article path errors.

It's easier to debug problems if we echo the full paths when dying because
the article is not inside the data path.

Signed-off-by: Alberto Bertogli <albertito@gmail.com>

Add coding:utf8 to the sample config file.

If somebody edits and uses a non-ascii character, importing it will
fail and blitiri will just ignore it, which is not easier to debug.

Signed-off-by: Alberto Bertogli <albertito@gmail.com>

Initial commit.

Signed-off-by: Alberto Bertogli <albertito@gmail.com>