[doc] add html file to ease package building

This file is generated from doc/email.txt, but for now the generation process depends on logilab's mkdoc and private xsl files.

[doc] add html file to ease package building
This file is generated from doc/email.txt, but for now the generation process depends on logilab's mkdoc and private xsl files.
34e0fb02 · David Douard · 6778682cc638 · e71a87a2 · e71a87a2
Commit 34e0fb02 authored Nov 17, 2012 by David Douard
--- a/debian/control
+++ b/debian/control
@@ -2,8 +2,8 @@ Source: cubicweb-email
 Section: web
 Priority: optional
 Maintainer: Logilab Packaging Team <contact@logilab.fr>
-Uploaders: Sylvain Thenault <sylvain.thenault@logilab.fr>, Laure Bourgois <laure.bourgois@logilab.fr>
-Build-Depends: debhelper (>= 5.0.37.1), python (>=2.4), python-dev (>=2.4)
+Uploaders: Sylvain Thenault <sylvain.thenault@logilab.fr>, David Douard <david.douard@logilab.fr>
+Build-Depends: debhelper (>= 5.0.37.1), python (>=2.5), python-dev (>=2.5)
 Standards-Version: 3.8.0
 Homepage: http://www.cubicweb.org/project/cubicweb-email


--- a/doc/email.html
+++ b/doc/email.html
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta name="language" content="fr">
+<meta name="author" content="Logilab">
+<meta name="organization" content="Logilab S.A.">
+<meta name="generator" content="Logilab Powerful Stylesheets (v3)">
+<title>Utilisation du script d'import d'emails dans une instance CubicWeb</title>
+<meta name="keywords" content="logilab">
+<link rel="stylesheet" href="http://www.logilab.fr/lglb-publi-content.css" type="text/css">
+<link rel="stylesheet" href="http://www.logilab.fr/lglb-publi-structure.css" type="text/css">
+</head>
+<body>
+<table class="header" cellspacing="0"><tbody><tr>
+<td class="logo"><a href="http://www.logilab.fr/"><img src="http://www.logilab.fr/images/logilab.png" alt="Logilab" height="75"></a></td>
+<td class="text"><div class="header-title">Utilisation du script d'import d'emails dans une instance CubicWeb</div></td>
+</tr></tbody></table>
+<div class="header-sep"></div>
+<table class="main" cellspacing="0"><tbody><tr>
+<td class="left-margin"></td>
+<td class="body">
+<div class="component-title-block"><div class="component-title">Utilisation du script d'import d'emails dans une instance CubicWeb</div></div>
+
+
+<div class="sect1-title">
+<a name="conditions"></a>1. Conditions</div>
+
+<ul class="list">
+<li class="listitem">
+<div class="para">Le composant cubicweb-email doit être installés pour cette instance</div>
+</li>
+<li class="listitem">
+<div class="para">Pyro doit être activé pour cette instance</div>
+</li>
+</ul>
+
+<div class="sect1-title">
+<a name="utilisation-en-ligne-de-commande"></a>2. Utilisation en ligne de commande</div>
+
+<div class="para">La commande <span class="emphasis">mboximport</span> de <span class="emphasis">cubicweb-ctl</span> permet d'importer un fichier au format
+Unix Mailbox.  Il suffit de l'appeler en lui donnant en argument l'identifiant
+de l'application et le fichier à importer. Par défaut votre nom d'utilisateur
+sera utilisé pour se connecter à l'application, mais vous pouvez en spécifier un
+autre avec l'option <span class="emphasis">-u</span>.</div>
+
+<div class="sect1-title">
+<a name="configuration-mutt"></a>3. Configuration mutt</div>
+
+<div class="para">Dans le fichier <span class="emphasis">.muttrc</span>, ajouter par exemple la ligne :</div>
+<div class="programlisting">
+macro index "\ez" "&lt;pipe-message&gt;cubicweb-ctl mboximport -u toto -p toto monappli -&lt;enter&gt;"
+</div>
+<div class="para">et à partir de là vous pouvez faire "Alt-z" dans la vue d'index pour importer l'email
+séléctionné dans l'instance. L'exemple ci-dessus suppose que :</div>
+<ol class="list">
+<li class="listitem">
+<div class="para">l'identifiant pyro de l'application est "monappli"</div>
+</li>
+<li class="listitem">
+<div class="para">Vous utilisez un compte toto / toto</div>
+</li>
+</ol>
+<div class="para">Donner le mot de passe en ligne de commande est nécessaire car on ne sait pas le lire
+correctement de manière interactive quand mutt lance la commande.</div>
+
+</td>
+</tr></tbody></table>
+<div class="footer">Tous droits réservés à la société Logilab
+S.A. - 104 bld Auguste Blanqui - F-75013 PARIS.</div>
+</body>
+</html>