summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authordakkar <dakkar@thenautilus.net>2017-01-29 14:24:58 +0000
committerdakkar <dakkar@thenautilus.net>2017-01-29 14:25:36 +0000
commitcf02f74750e42528c6db764e319fb5252368635c (patch)
tree37954ab0d8e79b5bf88fcc4da3a289773059e609
parentfix lang in anime it (diff)
downloadthenautilus-cf02f74750e42528c6db764e319fb5252368635c.tar.gz
thenautilus-cf02f74750e42528c6db764e319fb5252368635c.tar.bz2
thenautilus-cf02f74750e42528c6db764e319fb5252368635c.zip
update Sietima page
-rw-r--r--src/SW/Sietima/document.en.rest.txt40
-rw-r--r--src/SW/Sietima/document.it.rest.txt41
2 files changed, 73 insertions, 8 deletions
diff --git a/src/SW/Sietima/document.en.rest.txt b/src/SW/Sietima/document.en.rest.txt
index 27f0a65..846c504 100644
--- a/src/SW/Sietima/document.en.rest.txt
+++ b/src/SW/Sietima/document.en.rest.txt
@@ -11,8 +11,7 @@ What is it
Sietima is a mailing list manager construction toolkit, written in
Perl 5. It's an exercise in modularity, a showcase of the latest
-features of Perl 5, and should eventually include an actually usable
-mailing list manager.
+features of Perl 5, and an actually usable mailing list manager.
History
=======
@@ -35,7 +34,38 @@ Construction toolkit?
Sietima provides a bunch of modules you can plug together to make your
ideal mlm. Writing new plugins to add features should be as easy as
-possible. It is currently not a "just works" application, though.
+possible. It is currently not a "just works" application, although the
+repository includes an `example application`_ that works.
+
+Is it production-ready?
+=======================
+
+Yes! I'm using Sietima to run three mailing lists on this
+domain. Since I use ``qmail``, I have the following configuration:
+
+- ``/var/qmail/users/assign`` contains lines like::
+
+ +the-list:mailinglists:1016:1004:/var/qmail/mailinglists/:-:the-list:
+
+ so messages sent to ``the-list@thenautilus.net`` (and all addresses
+ of the form ``the-list-*@thenautilus.net``) are routed to the
+ ``mailinglists`` user
+
+- ``/var/qmail/mailinglists/.qmail-the-list`` is::
+
+ |/usr/local/sietima/bin/sietima-the-list send
+
+ so messages sent to the list go through the list-specific program
+
+- ``/var/qmail/mailinglists/.qmail-the-list-bounce`` is::
+
+ &dakkar@thenautilus.net
+
+ so bounces go to me (I haven't written VERP or bounce handler
+ plugins)
+
+- ``/usr/local/sietima/bin/sietima-the-list`` looks very much like the
+ `example application`_
Contributing
============
@@ -49,7 +79,9 @@ me about it`_. Or `ask me to give you write access to the repository`_.
.. _`YAPC::EU 2003`: http://conferences.mongueurs.net/ye2003/talk/355
.. _`the full history as written by Simon`: http://www.thegestalt.org/simon/siesta-article.pod
-.. _`the source code`: https://www.thenautilus.net/cgit/Sietima/
+.. _`example application`: /cgit/Sietima/tree/example/sietima
+
+.. _`the source code`: /cgit/Sietima/
.. _`email me about it`: mailto:dakkar@thenautilus.net?subject=Code%20for%20Sietima
.. _`ask me to give you write access to the repository`: mailto:dakkar@thenautilus.net?subject=Please%20allow%20me%20to%20push%20to%20Sietima
diff --git a/src/SW/Sietima/document.it.rest.txt b/src/SW/Sietima/document.it.rest.txt
index e0c91b2..7df77e0 100644
--- a/src/SW/Sietima/document.it.rest.txt
+++ b/src/SW/Sietima/document.it.rest.txt
@@ -11,8 +11,8 @@ Che cos'è
Sietima è un kit per costruire gestori di mailing list, scritto in
Perl 5. È un esercizio di modularizzazione, una vetrina per le
-funzionalità più recenti di Perl 5, e prima o poi includerà un gestore
-di mailing list più o meno usabile.
+funzionalità più recenti di Perl 5, e un gestore di mailing list
+effettivamente usabile.
Storia
======
@@ -36,7 +36,38 @@ Kit di costruzione?
Sietima fornisce una collezione di moduli che potete combinare per
costruire il vostro gestore di liste ideale. Scrivere nuovi plugin per
aggiungere funzioni dovrebbe essere quanto più semplice possibile. Al
-momento, però, non è un'applicazione "chiavi in mano".
+momento non è proprio un'applicazione "chiavi in mano", anche se il
+repository contiene un'`applicazione di esempio`_.
+
+È "production-ready"?
+=====================
+
+Sì! Uso Sietima per gestire tre mailing list su questo
+dominio. Siccome uso ``qmail``, la mia configurazione è fatta così:
+
+- ``/var/qmail/users/assign`` contiene righe tipo::
+
+ +la-lista:mailinglists:1016:1004:/var/qmail/mailinglists/:-:la-lista:
+
+ così che messaggi inviati a ``la-lista@thenautilus.net`` (e a tutti
+ gli indirizzi della forma ``la-lista-*@thenautilus.net``) sono
+ passati all'utente ``mailinglists``
+
+- ``/var/qmail/mailinglists/.qmail-la-lista``::
+
+ |/usr/local/sietima/bin/sietima-la-lista send
+
+ per cui messaggi inviati alla lista passano dal programma apposito
+
+- ``/var/qmail/mailinglists/.qmail-la-lista-bounce``::
+
+ &dakkar@thenautilus.net
+
+ per cui messaggi rimbalzati da altri server vengono recapitati a me
+ (non ho scritto nessun plugin per gestire VERP o bounce)
+
+- ``/usr/local/sietima/bin/sietima-la-lista`` è fatto allo stesso modo
+ dell'`applicazione di esempio`_
Per contribuire
===============
@@ -51,7 +82,9 @@ accesso in scrittura al repository`_.
.. _`YAPC::EU 2003`: http://conferences.mongueurs.net/ye2003/talk/355
.. _`la storia completa scritta da Simon`: http://www.thegestalt.org/simon/siesta-article.pod
-.. _`codice sorgente`: https://www.thenautilus.net/cgit/Sietima/
+.. _`applicazione di esempio`: /cgit/Sietima/tree/example/sietima
+
+.. _`codice sorgente`: /cgit/Sietima/
.. _`fatemelo sapere per email`: mailto:dakkar@thenautilus.net?subject=Codice%20per%20Sietima
.. _`chiedetemi di darvi accesso in scrittura al repository`: mailto:dakkar@thenautilus.net?subject=Dammi%20accesso%20a%20Sietima,%20per%20favore