You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ponymail.apache.org by gi...@apache.org on 2020/06/17 10:33:47 UTC
[incubator-ponymail-site] branch asf-site updated: Automatic Site
Publish by Buildbot
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-ponymail-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 4052dd8 Automatic Site Publish by Buildbot
4052dd8 is described below
commit 4052dd82e8986bf66bdcfe688c2db40d926a572c
Author: buildbot <us...@infra.apache.org>
AuthorDate: Wed Jun 17 10:33:41 2020 +0000
Automatic Site Publish by Buildbot
---
content/docs/importing.html | 3 +++
content/docs/installing.html | 7 +++++--
2 files changed, 8 insertions(+), 2 deletions(-)
diff --git a/content/docs/importing.html b/content/docs/importing.html
index ed7f01e..97ea96f 100644
--- a/content/docs/importing.html
+++ b/content/docs/importing.html
@@ -44,6 +44,9 @@ the archive. Both the archiver and the importer use the same digest method, so
they can overlap. Usually, you'll want to set up the archiver first, and when
emails start flowing through it, you'll use the importer to import older emails.</p>
<h2 id='importingfrommodmbox'>Importing from mod_mbox<a href='#importingfrommodmbox' style='color: rgba(0,0,0,0);'>¶</a></h2>
+<h3 id='warning'>Warning<a href='#warning' style='color: rgba(0,0,0,0);'>¶</a></h3>
+<p>Pony Mail relies on the mail headers to determine the correct list name for each email.</p>
+<p>If in any doubt, import a single list at a time and use the --lid flag to specify the correct list name.</p>
<h3 id='importingasingledomain'>Importing a single domain<a href='#importingasingledomain' style='color: rgba(0,0,0,0);'>¶</a></h3>
<p>Provided you have the main mod_mbox page at https://your.tld/mod_mbox/ and your (sub)domain resources at
https://your.tld/mod_mbox/$list-yourdomain/, you can import all lists from that domain using:</p>
diff --git a/content/docs/installing.html b/content/docs/installing.html
index 1617565..da5b7cf 100644
--- a/content/docs/installing.html
+++ b/content/docs/installing.html
@@ -62,6 +62,8 @@ for detailed package installation instructions:</p>
$python3 setup.py
...[follow instructions in the setup script]</code></li>
<li>Edit <code>site/js/config.js</code> to suit your needs (usually very little editing is needed)</li>
+<li>Set up the appropriate authorisation for private lists. For examples, see:
+ https://github.com/apache/incubator-ponymail/tree/master/aaa_examples</li>
</ul>
<h3 id='usingauthforelasticsearch'>Using auth for ElasticSearch<a href='#usingauthforelasticsearch' style='color: rgba(0,0,0,0);'>¶</a></h3>
<p>If your ElasticSearch instance requires authentication for the importer/archiver, please
@@ -106,13 +108,14 @@ header determines the list ID using the --altheader argument, for instance:
class: mailman_ponymail.Archiver
enable: yes</code></p>
<p>For older mailing list systems such as Mailman 2 and ezmlm, you can also
-tak a look at our <a href="archiving.html">archiving examples</a> page for pointers.</p>
+take a look at our <a href="archiving.html">archiving examples</a> page for pointers.</p>
<h2 id='publicversusprivatelists'>Public versus private lists<a href='#publicversusprivatelists' style='color: rgba(0,0,0,0);'>¶</a></h2>
<p>In MailMan 3, this should be auto-detected and is not a concern.
When using other ML systems via piping to STDIN, you should add
the --private arg to the python script to mark an email as private:
<code>foolist-private: "|/usr/bin/python3 /path/to/tools/archiver.py --private"
- foolist-public: "|/usr/bin/python3 /path/to/tools/archiver.py"</code></p>
+ foolist-public: "|/usr/bin/python3 /path/to/tools/archiver.py"</code>
+Note that private lists are subject to authorisation which you should set up as noted above</p>
<h2 id='importingolddataintoponymail'>Importing old data into Pony Mail<a href='#importingolddataintoponymail' style='color: rgba(0,0,0,0);'>¶</a></h2>
<p>See <a href="importing.html">this guide</a> for details on how to import old archives into Pony Mail.</p>
<h2 id='bulkeditinglists'>Bulk editing lists<a href='#bulkeditinglists' style='color: rgba(0,0,0,0);'>¶</a></h2>