add manpage stuff

This commit is contained in:
Martin Zimmermann 2014-03-19 14:00:49 +01:00
parent ad31a67d8f
commit b19084b3e2
3 changed files with 45 additions and 2 deletions

View File

@ -1,3 +1,6 @@
include man/man1/isso.1
include man/man5/isso.conf.5
include isso/js/embed.min.js
include isso/js/embed.dev.js
include isso/js/count.min.js

View File

@ -232,8 +232,10 @@ latex_documents = [
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
('index', 'isso', u'Isso Documentation',
[u'Martin Zimmermann'], 1)
('docs/man/index', 'man1/isso', u'a Disqus alternative',
[u'Martin Zimmermann'], 1),
('docs/configuration/server', 'man5/isso.conf', u'server configuration',
[u'Martin Zimmermann'], 5)
]
# If true, show URL addresses after external links.

38
docs/docs/man/index.rst Normal file
View File

@ -0,0 +1,38 @@
Isso
====
What's Isso?
------------
Isso is a lightweight commenting server similar to Disqus. It allows anonymous
comments, maintains identity and is simple to administrate. It uses JavaScript
and cross-origin ressource sharing for easy integration into static websites.
No, I meant "Isso"
------------------
Isso is an informal, german abbreviation for "Ich schrei sonst!", which can
roughly be translated to "I'm yelling otherwise". It usually ends the
discussion without any further arguments.
In germany, Isso `is also pokémon N° 360`__.
.. __: http://bulbapedia.bulbagarden.net/wiki/Wynaut_(Pok%C3%A9mon)
What's wrong with Disqus?
-------------------------
No anonymous comments (IP address, email and name recorded), hosted in the USA,
third-party. Just like IntenseDebate, livefrye etc. When you embed Disqus, they
can do anything with your readers (and probably mine Bitcoins, see the loading
times).
Setup
-----
.. toctree::
:maxdepth: 1
../quickstart
../troubleshooting