You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ponymail.apache.org by hu...@apache.org on 2016/05/31 08:03:55 UTC
[2/2] incubator-ponymail-site git commit: add docs dir,
regenerate everything with absolute paths
add docs dir, regenerate everything with absolute paths
Project: http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/commit/ff17dba0
Tree: http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/tree/ff17dba0
Diff: http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/diff/ff17dba0
Branch: refs/heads/asf-site
Commit: ff17dba0b5c6d5f3ac39bcada69036a509d2fd6a
Parents: ef6ce52
Author: humbedooh <hu...@apache.org>
Authored: Tue May 31 10:03:39 2016 +0200
Committer: humbedooh <hu...@apache.org>
Committed: Tue May 31 10:03:39 2016 +0200
----------------------------------------------------------------------
content/about.html | 4 +-
content/contribute.html | 4 +-
content/docs.html | 20 +--
content/docs/api.html | 166 +++++++++++++++++++++
content/docs/archiving.html | 126 ++++++++++++++++
content/docs/building.html | 72 +++++++++
content/docs/contributing.html | 78 ++++++++++
content/docs/importing.html | 97 ++++++++++++
content/docs/install.centos.html | 166 +++++++++++++++++++++
content/docs/install.debian.html | 117 +++++++++++++++
content/docs/install.fedora.html | 141 ++++++++++++++++++
content/docs/install.ubuntu.html | 135 +++++++++++++++++
content/docs/installing.html | 221 ++++++++++++++++++++++++++++
content/downloads.html | 4 +-
content/index.html | 4 +-
content/source.html | 4 +-
content/support.html | 4 +-
source/generate.py | 9 +-
source/markdown/docs.md | 16 +-
source/markdown/docs/API.md | 134 +++++++++++++++++
source/markdown/docs/ARCHIVING.md | 95 ++++++++++++
source/markdown/docs/BUILDING.md | 19 +++
source/markdown/docs/CONTRIBUTING.md | 33 +++++
source/markdown/docs/IMPORTING.md | 64 ++++++++
source/markdown/docs/INSTALL.centos.md | 141 ++++++++++++++++++
source/markdown/docs/INSTALL.debian.md | 78 ++++++++++
source/markdown/docs/INSTALL.fedora.md | 112 ++++++++++++++
source/markdown/docs/INSTALL.ubuntu.md | 101 +++++++++++++
source/markdown/docs/INSTALLING.md | 211 ++++++++++++++++++++++++++
source/template.html | 4 +-
30 files changed, 2346 insertions(+), 34 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/about.html
----------------------------------------------------------------------
diff --git a/content/about.html b/content/about.html
index b511739..26183b6 100644
--- a/content/about.html
+++ b/content/about.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/contribute.html
----------------------------------------------------------------------
diff --git a/content/contribute.html b/content/contribute.html
index 087cd52..19384c1 100644
--- a/content/contribute.html
+++ b/content/contribute.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs.html
----------------------------------------------------------------------
diff --git a/content/docs.html b/content/docs.html
index a65fbdb..988cfe4 100644
--- a/content/docs.html
+++ b/content/docs.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
@@ -34,14 +34,14 @@
</div>
</div>
<h3>Getting started</h3>
-<p>(Optionally see the <a href="docs/INSTALLING.md">detailed installation instructions</a> for more information)</p>
+<p>(Optionally see the <a href="/docs/installing.html">detailed installation instructions</a> for more information)</p>
<h4>Supported Linux Distributions</h4>
<p>For a quick guide to installing Pony Mail, please see the guides for:</p>
<ul>
-<li><a href="docs/INSTALL.debian.md">Debian (Jessie) Installation Instructions</a></li>
-<li><a href="docs/INSTALL.ubuntu.md">Ubuntu (14.04) Installation Instructions</a></li>
-<li><a href="docs/INSTALL.centos.md">CentOS (7.1) Installation Instructions</a></li>
-<li><a href="docs/INSTALL.fedora.md">Fedora (22) Installation Instructions</a></li>
+<li><a href="/docs/install.debian.html">Debian (Jessie) Installation Instructions</a></li>
+<li><a href="/docs/install.ubuntu.html">Ubuntu (14.04) Installation Instructions</a></li>
+<li><a href="/docs/install.centos.html">CentOS (7.1) Installation Instructions</a></li>
+<li><a href="/docs/install.fedora.html">Fedora (22) Installation Instructions</a></li>
</ul>
<h4>Generic installation instructions</h4>
<ol>
@@ -49,9 +49,9 @@
<li>Install ElasticSearch</li>
<li>go to tools/ and run python setup.py - follow the instructions and enter info</li>
<li>Fiddle a bit with site/js/config.js for now</li>
-<li>Add Pony Mail as an archiver for your lists. <a href="docs/ARCHIVING.md">see this doc</a>.</li>
-<li>import mbox data with import-mbox.py if need be (see <a href="docs/IMPORTING.md">this doc</a> for details)</li>
-<li>All done :) But please see the <a href="docs/INSTALLING.md">detailed installation instructions</a> for more details</li>
+<li>Add Pony Mail as an archiver for your lists. <a href="/docs/archiving.html">see this doc</a>.</li>
+<li>import mbox data with import-mbox.py if need be (see <a href="/docs/importing.html">this doc</a> for details)</li>
+<li>All done :) But please see the <a href="/docs/installing.html">detailed installation instructions</a> for more details</li>
</ol>
<h2><a id="disclaimer"></a>Disclaimer</h2>
<p style="font-size: 8pt; line-height: 12pt;">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/api.html
----------------------------------------------------------------------
diff --git a/content/docs/api.html b/content/docs/api.html
new file mode 100644
index 0000000..7f28923
--- /dev/null
+++ b/content/docs/api.html
@@ -0,0 +1,166 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Pony Mail Archive API</h1>
+<h3>Fetching a specific email:</h3>
+<p>Usage:
+<code>GET /api/email.lua?id=$mid</code></p>
+<p>Parameters: (cookie may be required)
+ - $mid: The email ID or Message-ID: header</p>
+<p>Response example:</p>
+<p>~~~
+{
+ "references": "<a href="mailto:git-pr-18-any23@git.apache.org">git-pr-18-any23@git.apache.org</a>",
+ "from_raw": "lewismc <a href="mailto:git@git.apache.org">git@git.apache.org</a>",
+ "message-id": "<a href="mailto:20150905153416.0CDCFDFE66@git1-us-west.apache.org">20150905153416.0CDCFDFE66@git1-us-west.apache.org</a>",
+ "@import_timestamp": "2015/10/04 09:52:41",
+ "body": "Body of email here...",
+ "request_id": "06b318af97ca96c115e878c14d0814a53407751c31388410421c1751@1441467256@<dev.any23.apache.org>",
+ "@version": 1,
+ "attachments": {},
+ "list": "<dev.any23.apache.org>",
+ "date": "2015/09/05 17:34:16",
+ "from": "lewismc <a href="mailto:git@git.apache.org">git@git.apache.org</a>",
+ "gravatar": "a676c0bf448fcd49f588249ead719b4c",
+ "in-reply-to": "<a href="mailto:git-pr-18-any23@git.apache.org">git-pr-18-any23@git.apache.org</a>",
+ "epoch": 1441467256,
+ "subject": "[GitHub] any23 pull request: Gsoc 2015 Microformats2",
+ "mid": "06b318af97ca96c115e878c14d0814a53407751c31388410421c1751@1441467256@<dev.any23.apache.org>",
+ "private": false,
+ "tid": "06b318af97ca96c115e878c14d0814a53407751c31388410421c1751@1441467256@<dev.any23.apache.org>",
+ "list_raw": "<dev.any23.apache.org>"
+}
+~~~</p>
+<h3>Fetching list data</h3>
+<p>Usage:
+<code>GET /api/stats.lua?list=$list&domain=$domain[&d=$timespan][&q=$query][&header_from=$from][&header_subject=$subject]</code></p>
+<p>Parameters:
+ - $list: The list prefix (e.g. <code>dev</code>). Wildcards may be used
+ - $domain: The list domain (e.g. <code>httpd.apache.org</code>). Wildcards may be used
+ - $timespan: A <a href="#Timespans">timespan</a> value
+ - $query: A search query (may contain wildcards or negations):
+ - <code>foo</code>: Find all documents containing <code>foo</code> in headers or body
+ - <code>-foo</code>: Find all documents NOT containing <code>foo</code>.
+ - <code>foo*</code>: Find all documents containing <code>foo</code>, <code>fooa</code>, <code>foob</code> etc
+ - $from: Optional From: address
+ - $subject: Optional Subject: line</p>
+<p>Response example:</p>
+<p>~~~
+{
+ "took": 437179,
+ "firstYear": 2015,
+ "emails": {...},
+ "no_threads": 10,
+ "domain": "ponymail.info",
+ "participants": {...},
+ "lastYear": 2015,
+ "name": "dev",
+ "cloud": {...},
+ "hits": 25,
+ "thread_struct": {...},
+ "max": 5000,
+ "searchlist": "<dev.ponymail.info>",
+ "list": "dev@ponymail.info",
+ "numparts": 0,
+ "using_wc": false
+}
+~~~</p>
+<h3>Fetching preferences and quick list overview</h3>
+<p>Usage:
+<code>GET /api/preferences.lua[?logout=true]</code></p>
+<p>Parameters: (cookie required)
+ - logout: Whether to log out of the system (optional)</p>
+<p>Response example:</p>
+<p>~~~
+{
+ "lists": {
+ "ponymail.info": {
+ "user": 5,
+ "dev": 36,
+ "commits": 279
+ }
+ },
+ "descriptions": {
+ },
+ "preferences": {
+ "displayMode": "threaded",
+ "hideStats": "no",
+ "theme": "default",
+ "notifications": "direct",
+ "sortOrder": "forward",
+ "compactQuotes": "yes",
+ "fullname": "Daniel Gruno",
+ "groupBy": "thread"
+ },
+ "took": 38487,
+ "login": {
+ "notifications": 0,
+ "credentials": {
+ "fullname": "Daniel Gruno",
+ "email": "foo@bar.tld"
+ }
+ }
+}
+~~~</p>
+<h3>Fetching notifications for a logged in user</h3>
+<p>Usage:
+<code>GET /api/notifications.lua</code></p>
+<p>Parameters: <code>None</code> (cookie required)</p>
+<p>Response example:</p>
+<p>~~~
+{
+ "notifications": {...}
+}
+~~~</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/archiving.html
----------------------------------------------------------------------
diff --git a/content/docs/archiving.html b/content/docs/archiving.html
new file mode 100644
index 0000000..a10fac6
--- /dev/null
+++ b/content/docs/archiving.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Archiving New Emails to Pony Mail</h1>
+<p>This document exists to extend the <a href="INSTALLING.md">general install guide</a> provide examples on how to archive emails.</p>
+<p><strong>Note:</strong> If you plan on <a href="IMPORTING.md">importing old emails from an archive</a>,
+please set up the archiver <strong>first</strong> so as to create an overlap of new emails
+coming in and old emails being imported. The system is designed to handle this
+without creating duplicate entries in the archive.</p>
+<h2>Mailman 2.x example:</h2>
+<p>Set up a Pony Mail mail account/alias on a machine. This can be your local mail
+server, it can be the machine that Pony Mail is on (install sendmail or postfix
+etc there), or it can be any other machine with access to the ElasticSearch
+database that Pony Mail uses.</p>
+<h3>Pre-requisites</h3>
+<p>If this is not the machine Pony Mail was installed on, you'll need to copy the
+tools/ directory from your Pony Mail installation to this machine and adjust
+ponymail.cfg to point to the right place for the database. You will also need
+Python 3 and the helper libraries installed
+(<code>pip3 install elasticsearch formatflowed netaddr</code>)</p>
+<h3>Create an alias:</h3>
+<p>Set up a mail alias for public and private lists in <code>/etc/aliases</code> or similar method,
+and point them at the archiver script in tools/:</p>
+<p>~~~</p>
+<h1>You may need to add "--altheader delivered-to" to these commands, it varies</h1>
+<p>foo-public: "|/usr/bin/python3 /path/to/tools/archiver.py"
+foo-private: "|/usr/bin/python3 /path/to/tools/archiver.py --private"
+~~~</p>
+<p>Once done, run <code>newaliases</code> to update your alias DB.</p>
+<h3>Subscribe the aliases to your mailing lists</h3>
+<p>Use the mailman UI or CLI to subscribe foo-public@ to your public lists and
+foo-private to your private lists. Don't worry, the contents of private lists
+are hidden by default till the correct AAA scripting is set up.</p>
+<h2>ezmlm example:</h2>
+<p>First, see the general introduction in the MM2 example, as this applies here as well.</p>
+<h3>Create an alias:</h3>
+<p>Set up a dot-forward file for a public and a private alias:</p>
+<p>~~~
+.qmail-archive-public:
+ "|/usr/bin/python3 /path/to/tools/archiver.py"</p>
+<p>.qmail-archive-private:
+ "|/usr/bin/python3 /path/to/tools/archiver.py --private"
+~~~</p>
+<h3>Subscribe the aliases to your mailing lists</h3>
+<p>Use the ezmlm CLI to subscribe your new aliases to the lists:
+<code>ezmlm-sub foolist/ archive-public@yourhost.tld</code>
+<code>ezmlm-sub secretlist/ archive-private@yourhost.tld</code></p>
+<h2>Setting up AAA</h2>
+<p>If you have an custom OAuth2 provider and a binary approach to private access
+(either/or), you can enable private access to people by having a key/value pair
+called <code>isMember</code> set to <code>true</code> in your JSON response from the OAuth server,
+provided it is set as an authority in config.lua. This will provide anyone
+defined as a member via OAuth full access to all private lists.</p>
+<p>If you use LDAP, you can modify the LDAP queries in the example AAA file to suit
+your organization.</p>
+<h2>Importing/Archiving HTML-only emails</h2>
+<p>Should you need to import HTML-only emails into the archive, you may enable this
+with the <code>--html2text</code> command line arg. This requires that the <code>html2text</code> Python3 package
+is installed beforehand.</p>
+<h2>Munging list IDs</h2>
+<p>If you need to rewrite list IDs on the fly as emails come in, you can use the debug.cropout
+setting for this (in <code>ponymail.cfg</code>). </p>
+<p>You can either use it to just crop away something:
+~~~
+ [debug]
+ # Remove 'foo' from all list IDs
+ cropout: foo
+~~~</p>
+<p>Or you can use it as a regex substitution:
+~~~
+ [debug]
+ #Replace '<em>.bar.tld' with '</em>.blorg.bar.tld'
+ cropout: <([a-z]+).bar.tld> <\1.blorg.bar.tld>
+~~~</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/building.html
----------------------------------------------------------------------
diff --git a/content/docs/building.html b/content/docs/building.html
new file mode 100644
index 0000000..f2aec95
--- /dev/null
+++ b/content/docs/building.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Building Pony Mail for Production</h1>
+<p>Most of Pony Mail is ready-for-deployment files that just need to be checked out
+in order to work. Some areas, such as the JavaScript needs to be combined by a script,
+as they have been split into several smaller files to make it easier to find and
+work on various elements of the rendering process.</p>
+<h3>Building the JavaScript chunks</h3>
+<p>All JavaScript edits should be done to the <code>site/js/dev/*.js</code> files.
+Once done, you should run combine.sh in the <code>site/js/dev</code> directory
+to generate ponymail.js from the scripts in the dev dir:</p>
+<pre><code>$cd site/js/dev
+$bash combine.sh
+Combining JS...
+Done!
+$
+</code></pre>
+<p>You may choose to commit the initial JS changes first before
+committing the new combined JS, but that's up to you.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/contributing.html
----------------------------------------------------------------------
diff --git a/content/docs/contributing.html b/content/docs/contributing.html
new file mode 100644
index 0000000..23accda
--- /dev/null
+++ b/content/docs/contributing.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Contributing to Pony Mail</h1>
+<p>We'd LOVE it if more people would contribute to Pony Mail!
+Any form of contribution is most welcome, whether it be programming,
+documentation, evangelism, marketing, or helping out other users.</p>
+<p>Pony Mail is first and foremost a user interface, and as such, we
+are always on the lookout for user experiences. If you have used
+Pony Mail and have feedback or ideas you wish to share, please let
+us know either through an issue/PR here or on the mailing list.</p>
+<h2>Code</h2>
+<p>The Pony Mail code is on GitHub at https://github.com/apache/incubator-ponymail
+and pull requests are welcome.</p>
+<h2>Mailing lists</h2>
+<p>Developers list:
+ - list: dev@ponymail.incubator.apache.org
+ - subscribe addr: dev-subscribe@ponymail.incubator.apache.org
+ - Online version: http://lists.apache.org/list.html?dev@ponymail.incubator.apache.org</p>
+<p>Issues list:
+ - list: issues@ponymail.incubator.apache.org
+ - subscribe addr: issues-subscribe@ponymail.incubator.apache.org
+ - Online version: http://lists.apache.org/list.html?bugs@ponymail.incubator.apache.org</p>
+<h2>Chat</h2>
+<p>IRC:
+ - #ponymail on Freenode</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/importing.html
----------------------------------------------------------------------
diff --git a/content/docs/importing.html b/content/docs/importing.html
new file mode 100644
index 0000000..ae66f67
--- /dev/null
+++ b/content/docs/importing.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Importing Data to Pony Mail</h1>
+<p>Pony Mail supports many ways of importing your old mail archives via the
+<code>import-mbox.py</code> script. For command line argument tips, run <code>python3
+import-mbox.py --help</code>.</p>
+<p>Imports are digested equally every time, so you can
+import from the same source multiple times without creating duplicate emails in
+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>Importing attachments</h2>
+<p>If you wish to import attached files, add the <code>--attachments</code> flag to your import command, otherwise, attachments will be stripped.</p>
+<h2>Importing from mod_mbox</h2>
+<h3>Importing a single domain</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>
+<p><code>python3 import-mbox.py --source https://your.tld/mod_mbox/ --mod-mbox --project yourdomain</code></p>
+<p>For a quick update, which only imports the last 2 months of mail, append then <code>--quick</code> flag.</p>
+<p>You can also import just a single list by specifying that list ID:</p>
+<p><code>python3 import-mbox.py --source https://your.tld/mod_mbox/ --mod-mbox --project listname-yourdomain</code></p>
+<h3>Importing an entire archive (multiple domains)</h3>
+<p>To import an entire site, use the same command as above, but omit the <code>--project</code> flag</p>
+<p><code>python3 import-mbox.py --source https://your.tld/mod_mbox/ --mod-mbox</code></p>
+<h3>Setting the domain or list id properly in case of variance</h3>
+<p>If your old archive varies in terms of list IDs across time, you can force harmonization by using the <code>--lid</code> or <code>--domain</code> flags:</p>
+<p><code>python3 import-mbox.py --source https://your.tld/mod_mbox/ --mod-mbox --project listid-yourdomain --lid "<listid.youdomain.tld>"</code></p>
+<p>This should only be done one list at a time.</p>
+<h2>Importing from Pipermail</h2>
+<p>To import from pipermail, you will have to run the import one list at a time. As with mod_mbox imports, you must specify a source, but use <code>--pipermail</code> instead of <code>--mod-mbox</code>:</p>
+<p><code>python3 import-mbox.py --source https://your.tld/pipermail/foolist/ --pipermail</code></p>
+<h3>Pipermail and html-only emails</h3>
+<p>While you can convert HTML-only emails to text using <code>--html2text</code>, Pipermail has some peculiarities
+where it adds a text/plain message to these emails, thus preventing html2text from working. You can
+circumvent this by using the <code>--ignorebody "foo"</code> arg to ignore all text/plain bodies containing <code>foo</code>.</p>
+<p>While the <code>project</code> flag is not needed here, you may wish to specify the list ID for the import.</p>
+<h2>Importing from locally stored mbox files</h2>
+<p>To import from one or more local mbox files, specify a filesystem path as the source:</p>
+<p><code>python3 import-mbox.py --source /tmp/mylists/ --attachments</code></p>
+<p>If you have a mix of mbox and non-mbox files in the specific dir, you may wish to let Pony Mail know which files to scan:</p>
+<p><code>python3 import-mbox.py --source /tmp/mylists/ --ext .mbox --attachments</code></p>
+<h2>Test archives</h2>
+<p>We have a few test archives for those that wish to test large imports.
+They can be found in gzip format at <a href="http://ponymail.info/mboxes/">http://ponymail.info/mboxes/</a></p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/install.centos.html
----------------------------------------------------------------------
diff --git a/content/docs/install.centos.html b/content/docs/install.centos.html
new file mode 100644
index 0000000..375388b
--- /dev/null
+++ b/content/docs/install.centos.html
@@ -0,0 +1,166 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Installing Pony Mail on CentOS 7.1:</h1>
+<p>This installation is a bit trickier, as CentOS does not have
+Python 3 or any of the lua modules in its default package system.</p>
+<p>Start by installing the following CentOS packages:</p>
+<ul>
+<li>httpd</li>
+<li>git</li>
+<li>lua</li>
+<li>lua-devel</li>
+<li>gcc</li>
+<li>gcc-c++</li>
+<li>kernel-dev</li>
+<li>unzip</li>
+<li>openssl</li>
+<li>openssl-devel</li>
+<li>readline-devel</li>
+</ul>
+<p>~~~
+sudo yum install -y httpd git lua lua-devel gcc gcc-c++ kernel-devel unzip openssl openssl-devel readline-devel
+~~~</p>
+<p>Then, proceed to build LuaRocks (for lua deps):</p>
+<p>~~~
+wget http://luarocks.org/releases/luarocks-2.0.6.tar.gz <br />
+tar zxvf luarocks-2.0.6.tar.gz <br />
+cd luarocks-2.0.6 <br />
+./configure <br />
+make <br />
+sudo make install
+~~~</p>
+<p>Now build/install the required Lua modules:</p>
+<p>~~~
+sudo luarocks install lua-socket
+sudo luarocks install luasec OPENSSL_LIBDIR=/usr/lib64/
+sudo luarocks install lua-cjson
+~~~</p>
+<p>Configure, compile and install Python 3:</p>
+<p>~~~
+sudo yum groupinstall -y development
+sudo yum install -y zlib-dev sqlite-devel bzip2-devel xz-libs
+wget http://www.python.org/ftp/python/3.4.3/Python-3.4.3.tar.xz
+xz -d Python-3.4.3.tar.xz
+tar zvf Python-3.4.3.tar
+cd Python-3.4.3/
+./configure
+make
+sudo make altinstall
+~~~</p>
+<p>Install the required Python 3 modules:
+~~~
+sudo pip3.4 install elasticsearch formatflowed chardet netaddr
+~~~</p>
+<p>Install ElasticSearch:</p>
+<p>~~~
+sudo yum install -y java-1.7.0-openjdk-headless
+sudo rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch</p>
+<pre><code>(The following is taken from the ElasticSearch online guide:)
+
+Add the following in your /etc/yum.repos.d/ directory in a file with a .repo suffix,
+for example elasticsearch.repo:
+
+[elasticsearch-1.7]
+name=Elasticsearch repository for 1.7.x packages
+baseurl=http://packages.elastic.co/elasticsearch/1.7/centos
+gpgcheck=1
+gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
+enabled=1
+</code></pre>
+<p>sudo yum update
+sudo yum install elasticsearch
+~~~</p>
+<p>Configure and start up ElasticSearch:</p>
+<p>~~~
+sudo sudo /bin/systemctl daemon-reload
+sudo sudo /bin/systemctl enable elasticsearch.service
+sudo /etc/init.d/elasticsearch start
+~~~</p>
+<p>Check out a copy of Pony Mail:
+~~~
+cd /var/www
+git clone https://github.com/apache/incubator-ponymail.git
+~~~</p>
+<p>Set up Pony Mail:
+~~~
+cd /var/www/ponymail/tools
+python3.4 setup.py
+[... answer questions asked by the setup script ...]
+~~~</p>
+<p>Set up Apache httpd by adding, for example, the following virtual host configuration:
+This differs from the normal installation (because of CentOS specifics), so beware</p>
+<p>~~~
+<VirtualHost *:80>
+ LuaPackageCPath /usr/local/lib/lua/5.1/?.so
+ LuaPackagePath /usr/local/share/lua/5.1/?.lua
+ ServerName mylists.foo.tld
+ DocumentRoot /var/www/ponymail/site
+ AddHandler lua-script .lua
+ LuaScope thread
+ LuaCodeCache stat
+ AcceptPathInfo On
+</VirtualHost>
+~~~</p>
+<p>(re)start apache:</p>
+<p>~~~
+sudo apachectl restart
+~~~</p>
+<p>Once this is done, you should now have a <em>working copy</em> of Pony Mail!</p>
+<p>You may wish to tweak the settings in <code>site/js/config.js</code> and your
+elasticsearch settings once Pony mail is up and running.</p>
+<p>Refer to the <a href="INSTALLING.md">General installation documentation</a> for
+detailed information about archiving messages, OAuth, mail settings and
+much more.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/install.debian.html
----------------------------------------------------------------------
diff --git a/content/docs/install.debian.html b/content/docs/install.debian.html
new file mode 100644
index 0000000..afdaf91
--- /dev/null
+++ b/content/docs/install.debian.html
@@ -0,0 +1,117 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Installing Pony Mail on Debian Jessie:</h1>
+<p>Start by installing the following Debian packages:</p>
+<ul>
+<li>apache2</li>
+<li>git</li>
+<li>lua-sec</li>
+<li>lua-cjson</li>
+<li>lua-socket</li>
+<li>python3</li>
+<li>python3-pip</li>
+</ul>
+<p>~~~
+sudo apt-get install apache2 git lua-cjson lua-sec lua-socket python3 python3-pip
+~~~</p>
+<p>Install the required Python 3 modules:
+~~~
+sudo pip3 install elasticsearch formatflowed netaddr
+~~~</p>
+<p>Install ElasticSearch:</p>
+<p>~~~
+sudo apt-get install openjdk-7-jre-headless
+wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
+echo "deb http://packages.elastic.co/elasticsearch/1.7/debian stable main" | sudo tee -a /etc/apt/sources.list.d/elasticsearch-1.7.list
+sudo apt-get update && sudo apt-get install elasticsearch
+~~~</p>
+<p>Check out a copy of Pony Mail:
+~~~
+cd /var/www
+sudo git clone https://github.com/apache/incubator-ponymail.git
+~~~</p>
+<p>Start up ElasticSearch:</p>
+<p>~~~
+sudo service elasticsearch start
+~~~</p>
+<p>Set up Pony Mail:
+~~~
+cd /var/www/ponymail/tools
+sudo python3 setup.py
+[... answer questions asked by the setup script ...]
+~~~</p>
+<p>Set up Apache httpd by adding, for example, the following virtual host configuration:</p>
+<p>~~~
+<VirtualHost *:80>
+ ServerName mylists.foo.tld
+ DocumentRoot /var/www/ponymail/site
+ AddHandler lua-script .lua
+ LuaScope thread
+ LuaCodeCache stat
+ AcceptPathInfo On
+</VirtualHost>
+~~~</p>
+<p>Enable mod_lua and start apache:</p>
+<p>~~~
+sudo a2enmod lua
+sudo service apache start
+~~~</p>
+<p>Once this is done, you should now have a <em>working copy</em> of Pony Mail!</p>
+<p>You may wish to tweak the settings in <code>site/js/config.js</code> and your
+elasticsearch settings once Pony mail is up and running.</p>
+<p>Refer to the <a href="INSTALLING.md">General installation documentation</a> for
+detailed information about archiving messages, OAuth, mail settings and
+much more.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/install.fedora.html
----------------------------------------------------------------------
diff --git a/content/docs/install.fedora.html b/content/docs/install.fedora.html
new file mode 100644
index 0000000..0fb39dc
--- /dev/null
+++ b/content/docs/install.fedora.html
@@ -0,0 +1,141 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Installing Pony Mail on Fedora 22:</h1>
+<p>Start by installing the following Fedora packages:</p>
+<ul>
+<li>httpd</li>
+<li>git</li>
+<li>lua</li>
+<li>lua-sec</li>
+<li>lua-socket</li>
+<li>python 3</li>
+<li>luarocks</li>
+</ul>
+<p>~~~
+sudo dnf install -y httpd git lua lua-sec lua-socket python3 luarocks
+~~~</p>
+<p>Install the missing cjson package via luarocks:</p>
+<p>~~~
+sudo luarocks-5.3 install lua-cjson
+~~~</p>
+<p>Install the required Python 3 modules:
+~~~
+sudo pip3.4 install elasticsearch formatflowed chardet netaddr
+~~~</p>
+<p>Install ElasticSearch:</p>
+<p>~~~
+sudo dnf install -y java-1.8.0-openjdk-headless
+sudo rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch</p>
+<pre><code>(The following is taken from the ElasticSearch online guide:)
+
+Add the following in your /etc/yum.repos.d/ directory in a file with a .repo suffix,
+for example elasticsearch.repo:
+
+[elasticsearch-1.7]
+name=Elasticsearch repository for 1.7.x packages
+baseurl=http://packages.elastic.co/elasticsearch/1.7/centos
+gpgcheck=1
+gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
+enabled=1
+</code></pre>
+<p>sudo dnf install -y elasticsearch
+~~~</p>
+<p>Configure and start up ElasticSearch:</p>
+<p>~~~
+sudo /bin/systemctl daemon-reload
+sudo /bin/systemctl enable elasticsearch.service
+sudo /etc/init.d/elasticsearch start
+~~~</p>
+<p>Check out a copy of Pony Mail:
+~~~
+cd /var/www
+sudo git clone https://github.com/apache/incubator-ponymail.git
+~~~</p>
+<p>Set up Pony Mail:
+~~~
+cd /var/www/ponymail/tools
+sudo python3.4 setup.py
+[... answer questions asked by the setup script ...]
+~~~</p>
+<p>Set up Apache httpd by adding, for example, the following virtual host configuration:
+This differs from the normal installation (because of CentOS specifics), so beware</p>
+<p>~~~
+<VirtualHost *:80>
+ LuaPackageCPath /usr/lib/lua/5.3/?.so
+ LuaPackagePath /usr/share/lua/5.3/?.lua
+ ServerName mylists.foo.tld
+ DocumentRoot /var/www/ponymail/site
+ AddHandler lua-script .lua
+ LuaScope thread
+ LuaCodeCache stat
+ AcceptPathInfo On
+</VirtualHost>
+~~~</p>
+<p>(re)start apache:</p>
+<p>~~~
+sudo apachectl restart
+~~~</p>
+<p>IF you have SELinux running, you need to allow httpd (apache) to
+be able to connect to remotes, otherwise Pony Mail won't work:</p>
+<p>~~~
+sudo setsebool -P httpd_can_network_connect 1
+~~~</p>
+<p>Once this is done, you should now have a <em>working copy</em> of Pony Mail!</p>
+<p>You may wish to tweak the settings in <code>site/js/config.js</code> and your
+elasticsearch settings once Pony mail is up and running.</p>
+<p>Refer to the <a href="INSTALLING.md">General installation documentation</a> for
+detailed information about archiving messages, OAuth, mail settings and
+much more.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/install.ubuntu.html
----------------------------------------------------------------------
diff --git a/content/docs/install.ubuntu.html b/content/docs/install.ubuntu.html
new file mode 100644
index 0000000..5e053fb
--- /dev/null
+++ b/content/docs/install.ubuntu.html
@@ -0,0 +1,135 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Installing Pony Mail on Ubuntu 14.04 or 16.04:</h1>
+<p>Start by installing the following Ubuntu packages:</p>
+<ul>
+<li>apache2</li>
+<li>git</li>
+<li>liblua5.2-dev</li>
+<li>lua-sec</li>
+<li>lua-cjson</li>
+<li>lua-socket</li>
+<li>python3</li>
+<li>python3-pip</li>
+<li>subversion</li>
+</ul>
+<p>~~~
+sudo apt-get install apache2 git liblua5.2-dev lua-cjson lua-sec lua-socket python3 python3-pip subversion
+~~~</p>
+<p>Install the required Python 3 modules:
+~~~
+sudo pip3 install elasticsearch formatflowed netaddr
+~~~</p>
+<p>Install ElasticSearch:</p>
+<p>~~~
+sudo apt-get default-jre-headless
+wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
+echo "deb http://packages.elastic.co/elasticsearch/2.x/debian stable main" | sudo tee -a /etc/apt/sources.list.d/elasticsearch-2.x.list
+sudo apt-get update && sudo apt-get install elasticsearch
+~~~</p>
+<p>Compile and install mod_lua if necessary (httpd < 2.4.17 on Ubuntu):
+~~~
+apt-get install apache2-dev
+svn co https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/modules/lua/
+cd lua/
+apxs -I/usr/include/lua5.2 -cia mod_lua.c lua_*.c -lm -llua5.2
+~~~</p>
+<p>Check out a copy of Pony Mail:
+~~~
+cd /var/www
+git clone https://github.com/apache/incubator-ponymail.git
+~~~</p>
+<p>Configure Elasticsearch to automatically start during bootup. For Ubuntu <= 14.10:</p>
+<p>~~~
+sudo update-rc.d elasticsearch defaults 95 10
+~~~</p>
+<p>For Ubuntu >= 15.04:</p>
+<p>~~~
+sudo /bin/systemctl daemon-reload
+sudo /bin/systemctl enable elasticsearch.service
+~~~</p>
+<p>Start up ElasticSearch:</p>
+<p>~~~
+service elasticsearch start
+~~~</p>
+<p>Set up Pony Mail:
+~~~
+cd /var/www/ponymail/tools
+sudo python3 setup.py
+[... answer questions asked by the setup script ...]
+~~~</p>
+<p>Set up Apache httpd by adding, for example, the following virtual host configuration:</p>
+<p>~~~
+<VirtualHost *:80>
+ ServerName mylists.foo.tld
+ DocumentRoot /var/www/ponymail/site
+ AddHandler lua-script .lua
+ LuaScope thread
+ LuaCodeCache stat
+ AcceptPathInfo On
+</VirtualHost>
+~~~</p>
+<p>Enable mod_lua and start apache:</p>
+<p>~~~
+sudo a2enmod lua
+sudo service apache start
+~~~</p>
+<p>Once this is done, you should now have a <em>working copy</em> of Pony Mail!</p>
+<p>You may wish to tweak the settings in <code>site/js/config.js</code> and your
+elasticsearch settings once Pony mail is up and running.</p>
+<p>Refer to the <a href="INSTALLING.md">General installation documentation</a> for
+detailed information about archiving messages, OAuth, mail settings and
+much more.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/docs/installing.html
----------------------------------------------------------------------
diff --git a/content/docs/installing.html b/content/docs/installing.html
new file mode 100644
index 0000000..706e21f
--- /dev/null
+++ b/content/docs/installing.html
@@ -0,0 +1,221 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
+<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png">
+<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png">
+<link rel="manifest" href="/icons/manifest.json">
+<meta name="msapplication-TileColor" content="#ffffff">
+<meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png">
+<meta name="theme-color" content="#ffffff">
+</head><body>
+<div style="margin: -10px; background: #7e614a; color: #EEE; margin-bottom: 20px; text-align: center;">
+ <a href="#contribute"><img align='left' style="width: 150px; height: 150px; position: relative; left: -4px; border: 0;" src="images/devme.png" alt="Fork/Download Pony Mail"></a>
+ <h1><a id="Pony_Mail_0"></a>Apache Pony Mail (Incubating)</h1>
+ <div id="menubar" style="font-size: 20pt; background: #5e514a; padding-top: 5px;">
+ <ul>
+ <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li>
+ <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li>
+ <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li>
+ <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li>
+ <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li>
+ <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li>
+ </ul>
+ </div>
+</div>
+<h1>Installing Pony Mail</h1>
+<p>If your distro is on this list, please refer to that specific document
+for detailed package installation instructions:</p>
+<ul>
+<li><a href="INSTALL.debian.md">Debian (Jessie) Installation Instructions</a></li>
+<li><a href="INSTALL.ubuntu.md">Ubuntu (14.04) Installation Instructions</a></li>
+<li><a href="INSTALL.centos.md">CentOS (7.1) Installation Instructions</a></li>
+<li><a href="INSTALL.fedora.md">Fedora (22) Installation Instructions</a></li>
+</ul>
+<p>Otherwise, read the next two chapters:</p>
+<h2>Pre-requisites</h2>
+<p>You will need the following software installed on your machine:</p>
+<ul>
+<li>ElasticSearch >= 1.3 (2.0 should also work just fine)</li>
+<li>Python 3.x for the archiver plugin (setup.py will handle dependencies) and importer</li>
+<li>Apache HTTP Server 2.4.x with mod_lua (see http://modlua.org/gs/installing if you need to build mod_lua manually)</li>
+<li>Lua >=5.1 with the following modules: cjson, luasec, luasocket</li>
+</ul>
+<h2>Download and Install</h2>
+<ul>
+<li>Download the git repo: <code>git clone https://github.com/apache/incubator-ponymail.git</code></li>
+<li>Start ElasticSearch on the machine it needs to run on.</li>
+<li>Run setup.py in the <code>tools</code> dir:
+<code>$cd tools
+ $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>
+</ul>
+<h3>Using auth for ElasticSearch</h3>
+<p>If your ElasticSearch instance requires authentication for the importer/archiver, please
+add the following lines in the <code>elasticsearch</code> block of <code>ponymail.cfg</code> once generated:</p>
+<p>~~~
+user: [username for ES]
+password: [password for ES]
+~~~</p>
+<h3>Using Apache HTTP Server:</h3>
+<ul>
+<li>Set up a VirtualHost block in Apache httpd that points to the <code>site/</code> directory in Pony Mail</li>
+<li>Add the configuration snippets from <code>configs/ponymail_httpd.conf</code> to the virtual host</li>
+<li>Start Apache httpd to enable the user-facing interface</li>
+</ul>
+<h3>Using nginx:</h3>
+<ul>
+<li>To use nginx, you will also need to install the <code>lua-apr</code> module from your distro.</li>
+<li>Set up a Server block in nginx that points to the <code>site/</code> directory in Pony Mail</li>
+<li>Add the configuration snippets from <code>configs/ponymail_nginx.conf</code> to the server config</li>
+<li>Start nginx to enable the user-facing interface</li>
+</ul>
+<h2>Setting up the archiver</h2>
+<p>First off, you will need both <code>tools/archiver.py</code> and the generated
+<code>tools/ponymail.cfg</code> present on the machine that your mail server runs on. This
+machine should also have access to the ElasticSearch backend.</p>
+<p>If your mailing list supports feeding emails to a program, feed the incoming new
+emails to <code>python3 /path/to/tools/archiver.py</code> and it will use STDIN as the
+transport mechanism. If you are simply using aliases or dot-forwards and no ML
+system, you can add (for example) <code>"|/usr/bin/python3
+/path/to/tools/archiver.py"</code> to your alias file to enable archiving. If you are
+not using a Mailing List manager, you will need to tell Pony Mail which email
+header determines the list ID using the --altheader argument, for instance:
+<code>foolist: "|/usr/bin/python3 /path/to/tools/archiver.py --altheader delivered-to"
+ foolist-private: "|/usr/bin/python3 /path/to/tools/archiver.py --altheader delivered-to --private"</code></p>
+<p>If you are using MailMan 3, you can add archiver.py as an archive by following the instructions inside the python script:
+- Copy the archiver.py file to <code>$mailman_plugin_dir/mailman_ponymail/__init__.py</code>
+- Copy ponymail.cfg to the same dir (for ES configuration)
+- Enable the module by adding the following to your <code>mailman.cfg</code> file::
+<code>[archiver.ponymail]
+ # Pony Mail
+ 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.md">archiving examples</a> page for pointers.</p>
+<h2>Public versus private lists</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>
+<h2>Importing old data into Pony Mail</h2>
+<p>See <a href="IMPORTING.md">this guide</a> for details on how to import old archives into Pony Mail.</p>
+<h2>Bulk editing lists</h2>
+<p>You can use <code>edit-list.py</code> to perform bulk operations:
+- Rename lists
+- Mark entire lists are private or public</p>
+<p>Run <code>python3 edit-list.py --help</code> for CLI args.</p>
+<h2>Setting up OAuth for Pony Mail</h2>
+<p>If you want people to be able to log in and reply via the Web UI, you can either
+use the default Persona login (works for all email addresses) or specify an
+OAuth provider.</p>
+<h3>Setting up or disabling Persona</h3>
+<p>Persona is enabled by default, as it's a fast and convenient way to enable
+logins for <em>public</em> lists. Should you wish to disable Persona, set the
+<code>enabled</code> variable to <code>false</code> in the persona section of <code>site/js/config.js</code>.
+Persona will only ever work for public lists. For private lists, you will need
+to specify and implement an OAuth provider.</p>
+<h3>Setting up an OAuth provider</h3>
+<p>Pony Mail comes with a few default OAuth examples in <code>site/js/config.js</code>, such
+as ASF Oauth and Google OAuth. You can enable these by uncommenting the lines in
+question, or set up your own OAuth portal to handle things. This is a standard
+OAuth that expects the backend to supply the following JSON data on success:</p>
+<p>~~~
+ {
+ "fullname": "The full name of the authed user",
+ "email": "The user's email address",
+ "uid": "(optional) The unique user ID of the logged in user (for instance, LDAP UID)",
+ "isMember": true/false (optional, specifies whether the person is a privileged user with access to all lists)
+ }
+~~~</p>
+<p>For private list browsing, Pony Mail supplies an example AAA library in
+<code>site/api/lib/aaa.lua</code> that does LDAP lookups to determine which groups a person
+belongs to, and thus which lists said person has access to. The AAA example is
+modelled on the Apache LDAP structure, so you may wish to change this to suit
+your need. We have <a href="../aaa_examples/">several simple AAA examples</a> in the
+<code>aaa_examples</code> directory.</p>
+<p>If you are looking for an OAuth portal to provide users access to private lists
+in the archive, you will need to add the OAuth domain to config.admin_oauth in
+config.lua:</p>
+<p>~~~
+ admin_oauth = { 'myoauth.foo.tld', '*.oauthprovider.com', 'etc' }
+~~~~</p>
+<p>If not specified in config.lua, OAuth will only provide users with a place to
+store settings and notifications, and - provided your mail server is set to accept
+this - a place to reply to emails in the archive.</p>
+<h4>Using GitHub OAuth and other client-secret providers</h4>
+<p>If your OAuth provider requires a client secret, you can specify this in <code>site/api/lib/config.lua</code>, as this GitHub example shows:</p>
+<p>~~~
+ oauth_fields = {
+ github = {
+ client_secret = "abcdef1",
+ client_id = "abcdef2",
+ oauth_token = "https://github.com/login/oauth/access_token"
+ }
+ }
+~~~</p>
+<p>This essentially overrides <code>config.js</code> but without showing the data to anyone outside the server.</p>
+<h3>Whitelisting replies via the Web UI</h3>
+<p>To have Pony Mail accept replies done via the Web UI, you must make sure
+that <code>site/api/lib/config.lua</code> contains the appropriate string (or array of strings) matching the domain(s) you wish to allow new email for. To allow replies to everything, set this to <code>*</code>(NOT RECOMMENDED).
+You can also allow based on GLOBs or an array of accepted domains and sub-domains:</p>
+<p>~~~
+ accepted_domains = "<em>" -- This would allow posts to any email address, baaaad choice.
+ accepted_domains = "foo.org" -- Allow only to </em>@foo.org
+ accepted_domains = "<em>.foo.org" -- Allow only posts to </em>@<em>.foo.org, but not </em>@foo.org
+ accepted_domains = { "foo.org", "<em>.foo.org" } -- Allow posts both to </em>.foo.org and foo.org
+~~~</p>
+<h3>Setting email footers</h3>
+<p>It is possible to set email footers in each email sent via the Web UI.
+This is done by configuring the <code>email_footer</code> variable in <code>site/api/lib/config.lua</code>.
+You may use the following variables in the footer:</p>
+<p>~~~
+ $list: The mailing list being sent to (foo@bar.tld)
+ $hostname: The hostname of the server
+ $port: The port of the server (80, 443 etc)
+ $msgid: The message ID of the email (for permalinks etc)
+~~~</p>
+<p>An example footer could be:</p>
+<p>~~~
+ --------
+ Sent via Pony Mail for $list.
+ To view this list online, visit: https://my.tld/list.html?$list
+ To view this email (and subsequent replies), visit:
+ https://my.tld/thread.html/$msgid
+ --------
+~~~</p>
+<h3>A note on email headers</h3>
+<p>By default, headers such as to/cc are not shown in the normal email view.
+To enable these headers, set <code>full_headers</code> to <code>true</code> in the <code>site/api/lib/config.lua</code> file.</p>
+<h2><a id="disclaimer"></a>Disclaimer</h2>
+<p style="font-size: 8pt; line-height: 12pt;">
+ <a href="https://incubator.apache.org"><img src="images/podling.svg" align="right" width="220px"/></a>
+ Apache Pony Mail (Incubating) is an effort undergoing incubation at
+ The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org">
+ Apache Incubator</a>. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+</p>
+<p style="font-size: 8pt; line-height: 12pt;">
+ Copyright 2016, the Apache Software Foundation.<br/>
+ Apache Pony Mail is a trademark of the Apache Software Foundation.
+ Apache and the Apache feather are registered trademarks of the
+ Apache Software Foundation.
+</p>
+</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/downloads.html
----------------------------------------------------------------------
diff --git a/content/downloads.html b/content/downloads.html
index 21c66b7..407d1ee 100644
--- a/content/downloads.html
+++ b/content/downloads.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/index.html
----------------------------------------------------------------------
diff --git a/content/index.html b/content/index.html
index 55859df..d66de38 100644
--- a/content/index.html
+++ b/content/index.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/source.html
----------------------------------------------------------------------
diff --git a/content/source.html b/content/source.html
index 9601560..4bd5c5e 100644
--- a/content/source.html
+++ b/content/source.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">
http://git-wip-us.apache.org/repos/asf/incubator-ponymail-site/blob/ff17dba0/content/support.html
----------------------------------------------------------------------
diff --git a/content/support.html b/content/support.html
index bb08ab8..233850b 100644
--- a/content/support.html
+++ b/content/support.html
@@ -1,6 +1,6 @@
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title>
-<link rel="stylesheet" type="text/css" href="css/default.css"/>
-<link rel="stylesheet" type="text/css" href="css/fa/fa.css"/>
+<link rel="stylesheet" type="text/css" href="/css/default.css"/>
+<link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/>
<link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png">