diff --git a/docs/_isso/layout.html b/docs/_isso/layout.html index bf6c8ea..2462c30 100644 --- a/docs/_isso/layout.html +++ b/docs/_isso/layout.html @@ -86,7 +86,7 @@ - News + FAQ Contribute Documentation diff --git a/docs/_static/css/site.scss b/docs/_static/css/site.scss index 669c4f9..9511860 100644 --- a/docs/_static/css/site.scss +++ b/docs/_static/css/site.scss @@ -298,6 +298,21 @@ main { margin-bottom: 0; } + blockquote { + margin: 1em; + text-align: center; + font-size:125%; + font-style:italic; + + } + blockquote:before { + content: "» "; + } + + blockquote:after { + content: " «"; + } + ul { margin: 1em 0; diff --git a/docs/docs/index.rst b/docs/docs/index.rst index ebe86ab..6fb5692 100644 --- a/docs/docs/index.rst +++ b/docs/docs/index.rst @@ -33,18 +33,18 @@ times). Isso is not the first open-source commenting server: - * `talkatv `_, written in Python. - Unfortunately, talkatv's (read "talkative") development stalled. Neither - anonymous nor threaded comments. +* `talkatv `_, written in Python. + Unfortunately, talkatv's (read "talkative") development stalled. Neither + anonymous nor threaded comments. - * `Juvia `_, written in Ruby (on Rails). - No threaded comments, nice administration webinterface, but... yeah... Ruby. +* `Juvia `_, written in Ruby (on Rails). + No threaded comments, nice administration webinterface, but... yeah... Ruby. - * `Tildehash.com `_, - written in PHP__ (compare to Python__). Did I forgot something? +* `Tildehash.com `_, + written in PHP__ (compare to Python__). Did I forgot something? - * `Unobtrusive, self-hosted comments `_, - discussion on StackOverflow. +* `Unobtrusive, self-hosted comments `_, + discussion on StackOverflow. .. __: http://www.cvedetails.com/vendor/74/PHP.html .. __: http://www.cvedetails.com/vendor/10210/Python.html diff --git a/docs/faq.rst b/docs/faq.rst new file mode 100644 index 0000000..e96d73e --- /dev/null +++ b/docs/faq.rst @@ -0,0 +1,32 @@ +Frequently asked question +========================= + +Why not use Gravatar/Libravatar/... ? +------------------------------------- + +Various people asked or complained about the generated icons next to their +comments. First, it is not an avatar, it is an identicon used to +*identify* an author of multiple comments without leaking personal +informations (unlike Gravatar). + +If you are in need of Gravatar_, then use Disqus. If you run your own +Libravatar_ server, you can work on a patch for Isso which adds *optional* +support for avatars. + +.. _Gravatar: https://secure.gravatar.com/ +.. _Libravatar: http://libravatar.org/ + +Why SQLite3? +------------ + +Although partially answered on the index page, here a more complete answer: If +you manage massive amounts of comments, Isso is a really bad choice. Isso is +designed to be simple and easy to setup, not optimizied for high-traffic +websites (use a `dedicated Disqus`_ instance then). + + comments are not big data + +For example, 209 threads and 778 comments in total only need 620K (kilobyte) +memory. Excellent use case for SQLite. + +.. _dedicated Disqus: