arno/isso
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

add faq.rst

Browse Source
This commit is contained in:
Martin Zimmermann 2013-12-18 16:20:52 +01:00
parent 1153b9cf6e
commit ecfaf9828e
4 changed files with 57 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/_isso/layout.html
View File

@ -86,7 +86,7 @@
</header> </header>
<nav> <nav>
<ul> <ul>
<li><a href="{{ pathto('news') }}">News</a></li> <li><a href="{{ pathto('faq') }}">FAQ</a></li>
<li><a href="{{ pathto('contribute') }}">Contribute</a></li> <li><a href="{{ pathto('contribute') }}">Contribute</a></li>
<li><a href="{{ pathto('docs') }}">Documentation</a></li> <li><a href="{{ pathto('docs') }}">Documentation</a></li>
</ul> </ul>

15
docs/_static/css/site.scss vendored
View File

@ -298,6 +298,21 @@ main {
margin-bottom: 0; margin-bottom: 0;
} }
blockquote {
margin: 1em;
text-align: center;
font-size:125%;
font-style:italic;
}
blockquote:before {
content: "» ";
}
blockquote:after {
content: " «";
}
ul { ul {
margin: 1em 0; margin: 1em 0;

18
docs/docs/index.rst
View File

@ -33,18 +33,18 @@ times).
Isso is not the first open-source commenting server: Isso is not the first open-source commenting server:
* `talkatv <https://github.com/talkatv/talkatv>`_, written in Python. * `talkatv <https://github.com/talkatv/talkatv>`_, written in Python.
Unfortunately, talkatv's (read "talkative") development stalled. Neither Unfortunately, talkatv's (read "talkative") development stalled. Neither
anonymous nor threaded comments. anonymous nor threaded comments.
* `Juvia <https://github.com/phusion/juvia>`_, written in Ruby (on Rails). * `Juvia <https://github.com/phusion/juvia>`_, written in Ruby (on Rails).
No threaded comments, nice administration webinterface, but... yeah... Ruby. No threaded comments, nice administration webinterface, but... yeah... Ruby.
* `Tildehash.com <http://www.tildehash.com/?article=why-im-reinventing-disqus>`_, * `Tildehash.com <http://www.tildehash.com/?article=why-im-reinventing-disqus>`_,
written in PHP__ (compare to Python__). Did I forgot something? written in PHP__ (compare to Python__). Did I forgot something?
* `Unobtrusive, self-hosted comments <http://stackoverflow.com/q/2053217>`_, * `Unobtrusive, self-hosted comments <http://stackoverflow.com/q/2053217>`_,
discussion on StackOverflow. discussion on StackOverflow.
.. __: http://www.cvedetails.com/vendor/74/PHP.html .. __: http://www.cvedetails.com/vendor/74/PHP.html
.. __: http://www.cvedetails.com/vendor/10210/Python.html .. __: http://www.cvedetails.com/vendor/10210/Python.html

32
docs/faq.rst Normal file
View File

@ -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: