Commit Graph

181 Commits

Author SHA1 Message Date
Martin Zimmermann
20fc700e98 fix typos 2014-05-27 22:04:53 +02:00
Martin Zimmermann
fd8465eb1c warn about incorrect notification backends, fix #95
SMTP is now also recognized as `smtp`backend. You may use multiple
notification backends (separated by comma). Defaults to `stdout`.
2014-05-27 12:18:40 +02:00
Martin Zimmermann
29085979e5 document jade as new (build) dependency 2014-05-26 16:00:28 +02:00
Martin Zimmermann
47618d06f2 simplify GH readme to avoid repetition 2014-05-24 16:03:42 +02:00
Martin Zimmermann
4f98bca202 hide avatars with data-isso-avatar="false", part of #49 2014-05-21 20:38:29 +02:00
Martin Zimmermann
fb182ae93f Merge branch 'pr-83', closes #83 2014-05-17 11:07:51 +02:00
Martin Zimmermann
e6fdfb03eb do not limit From: field to email address-only, closes #87
You may now set a full From header, e.g.:

    [smtp]
    from = Foo Bar <spam@local>

If not, the old name "Ich schrei sonst!" is used.
2014-05-15 10:59:39 +02:00
Martin Zimmermann
123ea26ca9 handle WP's query-string "pages" and variable WXR namespaces
Site links such as /?p=1234 are imported *as is* and maybe do work in
Isso. Do not use a query-based URL structure as permalinks. Ever.

Also, depending on the pages you are going to export, WXR' XML namespace
may change from ../export/1.0/ to ../export/1.2/. Isso tries to import
any WXR 1.x
2014-05-03 00:16:54 +02:00
Srijan Choudhary
26ae30f76c Update docs 2014-05-03 01:52:32 +05:30
Martin Zimmermann
333bba728b update docs 2014-05-02 11:57:47 +02:00
Martin Zimmermann
cb36107eda reword and clean documentation 2014-04-28 19:42:36 +02:00
Martin Zimmermann
0509e15f67 clarify [general] host usage a bit 2014-03-29 12:58:41 +01:00
Martin Zimmermann
e60ebfbdca correct manpage title 2014-03-28 13:34:24 +01:00
Martin Zimmermann
0d6d072281 add isso.conf example to source distribution
mv sample configuration to share/
2014-03-25 18:50:18 +01:00
Martin Zimmermann
ce35b9ff0e Merge branch 'doc-improvements' 2014-03-20 17:09:34 +01:00
Martin Zimmermann
0b816a0677 store session-key in database (once generated on db creation), #74
Store a random session key used to sign and verify comment ownership
once the database is initialized, not on every application startup.

Currently fixed session keys in [general] session-key are migrated into
the database on startup. The configuration parser will notice you about
the change and suggest you to remove this option.
2014-03-20 16:32:25 +01:00
Martin Zimmermann
de50c683bc extend installation docs
* add interludium for users new to Python
* include guides for prebuilt packages and building from source
  (obsoletes DEVELOPMENT.md).
2014-03-20 14:18:58 +01:00
Martin Zimmermann
2c2c911ba4 Isso requires SQLite 3.3.8 or later 2014-03-20 14:18:57 +01:00
Martin Zimmermann
b19084b3e2 add manpage stuff 2014-03-19 15:57:54 +01:00
Martin Zimmermann
ad31a67d8f get doc version via installed distribution 2014-03-19 14:00:16 +01:00
Martin Zimmermann
8f293ad435 configurable avatar colors
* data-isso-avatar-bg="#f0f0f0" sets the background color
* data-isso-avatar-fg="#0abf99 #5698c4 etc." sets up to 8 different
  forground colors
2014-03-10 22:02:13 +01:00
Martin Zimmermann
33fa56d8e9 add suggested flattr button 2014-03-07 20:21:16 +01:00
Martin Zimmermann
3b248b293f set SMTP timeout to 10 seconds and make it configurable, ref 9a735e8 2014-03-04 09:47:54 +01:00
Martin Zimmermann
c6214e31d7 document new [markup] section 2014-02-18 17:30:37 +01:00
Martin Zimmermann
8f86109cb6 use system's python interpreter 2014-02-16 16:17:38 +01:00
Martin Zimmermann
d1a0b3f6f9 refactor docs a bit, add section for mod_fastcgi and uberspace.de 2014-02-16 15:52:28 +01:00
Martin Zimmermann
56316b8998 remove html5 writer (does not work with Sphinx)
Features like .. note:: and .. warning:: are not supported. Sadly back
to the default `html4css1` stuff :(
2014-02-11 01:20:14 +01:00
Srijan Choudhary
5525184243 Docs update: forward url protocol in sample nginx configs 2014-02-11 04:38:51 +05:30
Martin Zimmermann
079e5d19da add note about insecure connections, #65 2014-02-04 18:10:03 +01:00
Martin Zimmermann
b100517e4b update developer's guide 2014-02-03 11:19:21 +01:00
Martin Zimmermann
cfbf595605 mention mailing list and fix CSS typo 2014-02-01 20:26:08 +01:00
Martin Zimmermann
518820a4af fix typo in reply-to-self conf, #59 2014-01-27 11:53:18 +01:00
Jocelyn Delande
cbf63f5a4e default smtp to port=587 and security=starttls 2014-01-26 17:17:09 +01:00
Martin Zimmermann
aae07a3c24 Merge branch 'pr/57' 2014-01-25 22:57:04 +01:00
Martin Zimmermann
b94329fc66 also mention count.min.js 2014-01-25 22:56:55 +01:00
Jocelyn Delande
5cdab92a4b Documentation on comment counter. 2014-01-25 22:22:11 +01:00
JocelynDelalande
2e60fc7f68 Update api.rst
Added doc on count feature
2014-01-25 20:48:09 +01:00
Martin Zimmermann
cbd449dcd0 Merge branch 'transifex' 2014-01-16 12:01:04 +01:00
Martin Zimmermann
5f990e3697 link example cfg, fix markup errors and show content table, closes #52
and also reword a few paragraphs as suggested via mail.
2014-01-13 19:12:50 +01:00
Martin Zimmermann
a29393ee3f replace kriskowal/q with 50 LoC homebrew implementation, part of #51
As a result, it is no longer possible to chain promises
(then().then().then(etc.)), but that is actually not an issue for Isso.

The deferred/promise implementation is roughly based on
http://stackoverflow.com/a/17722683 and stackp/promisejs.
2014-01-07 14:28:10 +01:00
Martin Zimmermann
ebf6ca7a85 add Transifex translation to contributing guide 2014-01-06 18:38:16 +01:00
Martin Zimmermann
9dd066c6a6 reflect security = ... in docs and print warning if used 2014-01-01 22:20:00 +01:00
Martin Zimmermann
c50fe22eb1 fix port -> listen snippet 2014-01-01 22:07:16 +01:00
Martin Zimmermann
ecfaf9828e add faq.rst 2013-12-18 16:20:52 +01:00
Martin Zimmermann
1153b9cf6e extend API documentation 2013-12-18 14:14:37 +01:00
Martin Zimmermann
8bf9b1145a add link to supervisor init script, close #47 2013-12-18 11:59:49 +01:00
Martin Zimmermann
150726df13 Merge branch 'feature/27', override thread id 2013-12-12 13:07:57 +01:00
Martin Zimmermann
bcb60c4e74 add documentation 2013-12-12 13:07:44 +01:00
Martin Zimmermann
0152e627ea use apache lexer and add recipe for session key generation 2013-12-12 11:52:05 +01:00
Martin Zimmermann
336ca3ffe7 add deployment docs for mod_wsgi 2013-12-12 11:28:30 +01:00
Martin Zimmermann
ba03f0105d generate CSS for docs properly 2013-12-11 15:40:46 +01:00
Martin Zimmermann
8169b30c04 add isso.svg 2013-12-11 15:30:22 +01:00
Martin Zimmermann
75dd18ece4 add favicon.ico 2013-12-11 15:30:10 +01:00
Martin Zimmermann
dcbe282c34 rm extras/multi-site.rst, already in configuration/setup.rst 2013-12-09 12:07:36 +01:00
Martin Zimmermann
990688f6e0 Merge branch 'fix/multsite' 2013-12-08 19:20:46 +01:00
Martin Zimmermann
adc722359d move application export to isso.run
When using Gunicorn or uWSGI to run `isso.dispatch` it would
automatically initialize and a default Isso instance (and cause
several logging messages), although never used.

If you use uWSGI or Gunicorn, you have to change the module from
`isso` to `isso.run`.
2013-12-08 19:15:08 +01:00
Martin Zimmermann
b15f17738e isso.dispatch now dispatches multiple sites based on relative URLs
The previous approach using a custom X-Custom header did work for the
client-side, but not for activation and deletion links. Now, you need
to add a `name = foo` option to the general section. `isso.dispatch`
then binds this configuration to /foo and can distinguish all API
calls without a special HTTP header.
2013-12-08 19:09:56 +01:00
Federico Ceratto
9f40ba848d Create example.conf
Example configuration with comments
2013-12-08 15:58:19 +00:00
Martin Zimmermann
982316c04b show PHP #vulnerability versus Python 2013-12-07 23:50:48 +01:00
Martin Zimmermann
7d64d84d9d write contribute section 2013-12-02 14:26:12 +01:00
Martin Zimmermann
b0ecc9c16a add reason for SQLite 2013-11-29 23:09:22 +01:00
Martin Zimmermann
c2291c1121 fix links to PyPi and GitHub 2013-11-25 17:06:26 +01:00
Martin Zimmermann
b79ac583e8 use sphinx for documentation 2013-11-25 16:57:18 +01:00
Martin Zimmermann
2e9c21db15 add X-Origin to GET requests, so isso.dispatch works on a single host 2013-11-17 11:16:46 +01:00
Martin Zimmermann
8a408aea1d reST is hard 2013-11-17 00:43:01 +01:00
Martin Zimmermann
6f66960df8 add an isso.dispatch module to support multiple sites, #34 2013-11-17 00:35:32 +01:00
Martin Zimmermann
edafc5f88f client configuration for reply-to-self
also: move data-isso-* configuration to app/config
2013-11-16 22:21:00 +01:00
Martin Zimmermann
d4e7ee134d add option reply-to-self, defaults to false 2013-11-13 21:20:32 +01:00
Martin Zimmermann
9f2062a900 fix #35
Also add an option `direct-reply` to control the number of comments
on a thread without referencing a child (to avoid a simple while loop
that `curl -XPOST ...` the url).

Defaults to 3, that means a /24 (or /48 for IPv6) address can only post
3 direct responses on a thread at all.
2013-11-13 20:42:56 +01:00
Martin Zimmermann
6e85c54a2e refactor views and introduce an API for notifications
Keep Isso modular, not monolithic. Make it easy to integrate a
web interface or add XMPP notifications.

This refactorization includes minor bugfixes and changes:

* CORS middleware did not work properly due to wrong unit tests
* more type checks on JSON input
* new detection for origin and public url, closes #28
* new activation and delete url (no redirect for old urls, but you can
  convert the old urls: copy hash after `/activate/` (or delete) and
  open `/id/<id of comment>/activate/<hash>`
* move crypto.py to utils/

With this commit, SMTP is no longer automatically configured: add
`notify = smtp` to the `[general]` section to use SMTP.
2013-11-11 12:09:19 +01:00
Martin Zimmermann
18d7f37878 typo 2013-11-08 10:05:12 +01:00
Martin Zimmermann
4bb6e91f61 Isso can now listen on unix domain sockets, closes #25
This also changes the server configuration from `host` and `port`
to `listen = http://localhost:8080`.
2013-11-06 16:55:14 +01:00
Martin Zimmermann
0473afe2db add profiling option to server configuration 2013-11-03 12:32:38 +01:00
Martin Zimmermann
afcfa91179 add uWSGI docs 2013-11-01 16:43:15 +01:00
Martin Zimmermann
d19933072f move developer section from CONTRIBUTING into its own document 2013-10-31 11:57:34 +01:00
Martin Zimmermann
b672dae624 allow multiple hosts, e.g. HTTP and HTTPS sites 2013-10-29 12:22:13 +01:00
Martin Zimmermann
94b1fef28e rewrite CONFIGURATION.md in reST and extend document 2013-10-27 12:44:59 +01:00
Martin Zimmermann
48b4c9f9a5 purge comments in moderation queue after given time, closes #13 2013-10-24 14:38:40 +02:00
Martin Zimmermann
f4a64fb55d add configuration overview 2013-10-06 20:17:47 +02:00
Martin Zimmermann
560e73cc0a rewrite db backend 2013-09-19 18:44:37 +02:00
Martin Zimmermann
27022af1e6 update README, added docs/API.md draft 2013-09-12 19:10:03 +02:00