From b19084b3e2b9f6c34a578b8bd27c84012f0b55af Mon Sep 17 00:00:00 2001 From: Martin Zimmermann Date: Wed, 19 Mar 2014 14:00:49 +0100 Subject: [PATCH] add manpage stuff --- MANIFEST.in | 3 +++ docs/conf.py | 6 ++++-- docs/docs/man/index.rst | 38 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 45 insertions(+), 2 deletions(-) create mode 100644 docs/docs/man/index.rst diff --git a/MANIFEST.in b/MANIFEST.in index e0debfb..d79f6fe 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -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 diff --git a/docs/conf.py b/docs/conf.py index b114fe3..1c2581e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -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. diff --git a/docs/docs/man/index.rst b/docs/docs/man/index.rst new file mode 100644 index 0000000..072b4c4 --- /dev/null +++ b/docs/docs/man/index.rst @@ -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 +