[13] | 1 |
|
---|
| 2 |
|
---|
| 3 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
---|
| 4 | "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
---|
| 5 |
|
---|
| 6 |
|
---|
| 7 | <html xmlns="http://www.w3.org/1999/xhtml">
|
---|
| 8 | <head>
|
---|
| 9 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
---|
| 10 |
|
---|
[16] | 11 | <title>Installation instructions — Mailjam 0.1.0 documentation</title>
|
---|
[13] | 12 |
|
---|
| 13 | <link rel="stylesheet" href="_static/default.css" type="text/css" />
|
---|
| 14 | <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
---|
| 15 |
|
---|
| 16 | <script type="text/javascript">
|
---|
| 17 | var DOCUMENTATION_OPTIONS = {
|
---|
| 18 | URL_ROOT: '',
|
---|
| 19 | VERSION: '0.1.0',
|
---|
| 20 | COLLAPSE_INDEX: false,
|
---|
| 21 | FILE_SUFFIX: '.html',
|
---|
| 22 | HAS_SOURCE: true
|
---|
| 23 | };
|
---|
| 24 | </script>
|
---|
| 25 | <script type="text/javascript" src="_static/jquery.js"></script>
|
---|
| 26 | <script type="text/javascript" src="_static/underscore.js"></script>
|
---|
| 27 | <script type="text/javascript" src="_static/doctools.js"></script>
|
---|
[16] | 28 | <link rel="top" title="Mailjam 0.1.0 documentation" href="index.html" />
|
---|
[13] | 29 | <link rel="next" title="Configuration" href="configuration.html" />
|
---|
[16] | 30 | <link rel="prev" title="Overview of mailjam’s architecture" href="overview.html" />
|
---|
[13] | 31 | </head>
|
---|
| 32 | <body>
|
---|
| 33 | <div class="related">
|
---|
| 34 | <h3>Navigation</h3>
|
---|
| 35 | <ul>
|
---|
| 36 | <li class="right" style="margin-right: 10px">
|
---|
| 37 | <a href="genindex.html" title="General Index"
|
---|
| 38 | accesskey="I">index</a></li>
|
---|
| 39 | <li class="right" >
|
---|
| 40 | <a href="configuration.html" title="Configuration"
|
---|
| 41 | accesskey="N">next</a> |</li>
|
---|
| 42 | <li class="right" >
|
---|
[16] | 43 | <a href="overview.html" title="Overview of mailjam’s architecture"
|
---|
[13] | 44 | accesskey="P">previous</a> |</li>
|
---|
[16] | 45 | <li><a href="index.html">Mailjam 0.1.0 documentation</a> »</li>
|
---|
[13] | 46 | </ul>
|
---|
| 47 | </div>
|
---|
| 48 |
|
---|
| 49 | <div class="document">
|
---|
| 50 | <div class="documentwrapper">
|
---|
| 51 | <div class="bodywrapper">
|
---|
| 52 | <div class="body">
|
---|
| 53 |
|
---|
| 54 | <div class="section" id="installation-instructions">
|
---|
| 55 | <h1><a class="toc-backref" href="#id3">Installation instructions</a><a class="headerlink" href="#installation-instructions" title="Permalink to this headline">¶</a></h1>
|
---|
| 56 | <div class="contents topic" id="contents">
|
---|
| 57 | <p class="topic-title first">Contents</p>
|
---|
| 58 | <ul class="simple">
|
---|
| 59 | <li><a class="reference internal" href="#installation-instructions" id="id3">Installation instructions</a><ul>
|
---|
| 60 | <li><a class="reference internal" href="#first-install-dependencies" id="id4">First, install dependencies</a></li>
|
---|
[16] | 61 | <li><a class="reference internal" href="#second-install-mailjam" id="id5">Second, install Mailjam</a><ul>
|
---|
[13] | 62 | <li><a class="reference internal" href="#installing-using-pip" id="id6">Installing using pip</a></li>
|
---|
| 63 | <li><a class="reference internal" href="#installing-using-easy-install" id="id7">Installing using easy_install</a></li>
|
---|
| 64 | <li><a class="reference internal" href="#installing-inside-a-virtualenv" id="id8">Installing inside a virtualenv</a></li>
|
---|
| 65 | <li><a class="reference internal" href="#installing-from-sources" id="id9">Installing from sources</a><ul>
|
---|
| 66 | <li><a class="reference internal" href="#releases" id="id10">Releases</a></li>
|
---|
| 67 | <li><a class="reference internal" href="#from-repository" id="id11">From repository</a></li>
|
---|
| 68 | </ul>
|
---|
| 69 | </li>
|
---|
| 70 | </ul>
|
---|
| 71 | </li>
|
---|
[16] | 72 | <li><a class="reference internal" href="#setting-up-mailjam" id="id12">Setting up Mailjam</a></li>
|
---|
| 73 | <li><a class="reference internal" href="#running-mailjam" id="id13">Running Mailjam</a></li>
|
---|
[13] | 74 | <li><a class="reference internal" href="#running-tests-developers-only" id="id14">Running tests (developers only)</a></li>
|
---|
| 75 | </ul>
|
---|
| 76 | </li>
|
---|
| 77 | </ul>
|
---|
| 78 | </div>
|
---|
| 79 | <div class="section" id="first-install-dependencies">
|
---|
| 80 | <span id="install-dependencies"></span><h2><a class="toc-backref" href="#id4">First, install dependencies</a><a class="headerlink" href="#first-install-dependencies" title="Permalink to this headline">¶</a></h2>
|
---|
[16] | 81 | <p>So far, the only dependency you will need in order to run mailjam is <a class="reference external" href="http://python.org">Python</a></p>
|
---|
| 82 | <p>Mailjam has been tested with python <em>2.7.x</em>, but it should work with versions
|
---|
[13] | 83 | <em>2.6.x</em> too.</p>
|
---|
| 84 | <p>Please, refer to your operating system package system documentation to learn
|
---|
| 85 | more about how to install python.</p>
|
---|
| 86 | </div>
|
---|
[16] | 87 | <div class="section" id="second-install-mailjam">
|
---|
| 88 | <span id="install-mailjam"></span><h2><a class="toc-backref" href="#id5">Second, install Mailjam</a><a class="headerlink" href="#second-install-mailjam" title="Permalink to this headline">¶</a></h2>
|
---|
[13] | 89 | <div class="section" id="installing-using-pip">
|
---|
| 90 | <span id="install-with-pip"></span><h3><a class="toc-backref" href="#id6">Installing using pip</a><a class="headerlink" href="#installing-using-pip" title="Permalink to this headline">¶</a></h3>
|
---|
[16] | 91 | <p>You can install Mailjam using <a class="reference external" href="http://www.pip-installer.org/en/latest/index.html">pip</a>:</p>
|
---|
| 92 | <div class="highlight-python"><pre>pip install -e https://bitbucket.org/codigo23/mailjam#egg=mailjam</pre>
|
---|
[13] | 93 | </div>
|
---|
| 94 | <div class="admonition note">
|
---|
| 95 | <p class="first admonition-title">Note</p>
|
---|
[16] | 96 | <p class="last">Mailjam has not been recorded/uploaded to <a class="reference external" href="http://pypi.python.org/pypi">pypi</a> yet, so, in order to install
|
---|
| 97 | it using pip you will have to provide the URL for the public Mailjam repo.</p>
|
---|
[13] | 98 | </div>
|
---|
| 99 | </div>
|
---|
| 100 | <div class="section" id="installing-using-easy-install">
|
---|
| 101 | <span id="install-with-easy-install"></span><h3><a class="toc-backref" href="#id7">Installing using easy_install</a><a class="headerlink" href="#installing-using-easy-install" title="Permalink to this headline">¶</a></h3>
|
---|
[16] | 102 | <p>You can not install Mailjam using <a class="reference external" href="http://peak.telecommunity.com/DevCenter/EasyInstall">easy_install</a> yet (until we do record/upload
|
---|
[13] | 103 | it to pypi)</p>
|
---|
| 104 | </div>
|
---|
| 105 | <div class="section" id="installing-inside-a-virtualenv">
|
---|
| 106 | <span id="install-inside-virtualenv"></span><h3><a class="toc-backref" href="#id8">Installing inside a virtualenv</a><a class="headerlink" href="#installing-inside-a-virtualenv" title="Permalink to this headline">¶</a></h3>
|
---|
[16] | 107 | <p>You can install Mailjam inside a <a class="reference external" href="http://www.virtualenv.org/en/latest/index.html">virtualenv</a>. Just create a virtualenv:</p>
|
---|
[13] | 108 | <div class="highlight-python"><div class="highlight"><pre><span class="n">virtualenv</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">your</span><span class="o">/</span><span class="n">env</span>
|
---|
| 109 | </pre></div>
|
---|
| 110 | </div>
|
---|
| 111 | <p>Then activate it:</p>
|
---|
| 112 | <div class="highlight-python"><div class="highlight"><pre><span class="n">source</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">your</span><span class="o">/</span><span class="n">env</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">activate</span>
|
---|
| 113 | </pre></div>
|
---|
| 114 | </div>
|
---|
| 115 | <div class="admonition note">
|
---|
| 116 | <p class="first admonition-title">Note</p>
|
---|
| 117 | <p>If your shell is <strong>csh</strong>/<strong>tcsh</strong> remember you have to activate the
|
---|
| 118 | environment this way:</p>
|
---|
| 119 | <div class="last highlight-python"><div class="highlight"><pre><span class="n">source</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">your</span><span class="o">/</span><span class="n">env</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">activate</span><span class="o">.</span><span class="n">csh</span>
|
---|
| 120 | </pre></div>
|
---|
| 121 | </div>
|
---|
| 122 | </div>
|
---|
[16] | 123 | <p>And, once the environment has been activated, use pip to install Mailjam:</p>
|
---|
| 124 | <div class="highlight-python"><pre>env$ pip install -e https://bitbucket.org/codigo23/mailjam#egg=mailjam</pre>
|
---|
[13] | 125 | </div>
|
---|
| 126 | </div>
|
---|
| 127 | <div class="section" id="installing-from-sources">
|
---|
| 128 | <span id="install-from-sources"></span><h3><a class="toc-backref" href="#id9">Installing from sources</a><a class="headerlink" href="#installing-from-sources" title="Permalink to this headline">¶</a></h3>
|
---|
| 129 | <p>When installing from sources, you can download one of the official releases
|
---|
| 130 | or you can go with the <em>bleeding edge</em> and get a copy of the official source
|
---|
| 131 | code repository.</p>
|
---|
| 132 | <div class="section" id="releases">
|
---|
| 133 | <span id="install-from-release"></span><h4><a class="toc-backref" href="#id10">Releases</a><a class="headerlink" href="#releases" title="Permalink to this headline">¶</a></h4>
|
---|
| 134 | <p><strong>There are no releases yet</strong>. You will have to install it from the repository.</p>
|
---|
| 135 | </div>
|
---|
| 136 | <div class="section" id="from-repository">
|
---|
| 137 | <span id="install-from-repository"></span><h4><a class="toc-backref" href="#id11">From repository</a><a class="headerlink" href="#from-repository" title="Permalink to this headline">¶</a></h4>
|
---|
[16] | 138 | <p>The source code of Mailjam is hosted in <a class="reference external" href="https://bitbucket.org">bitbucket</a> <a class="footnote-reference" href="#id2" id="id1">[1]</a>. In order to grab
|
---|
[13] | 139 | the latest sources you need <a class="reference external" href="http://mercurial.selenic.com">Mercurial</a>.</p>
|
---|
| 140 | <p>To get a copy of the sources, just <em>clone</em> the repository:</p>
|
---|
[16] | 141 | <div class="highlight-python"><pre>hg clone https://bitbucket.org/codigo23/mailjam mailjam-repo</pre>
|
---|
[13] | 142 | </div>
|
---|
[16] | 143 | <p>Then, go inside the <em>mailjam-repo</em> directory and run:</p>
|
---|
[13] | 144 | <div class="highlight-python"><pre>python setup.py install</pre>
|
---|
| 145 | </div>
|
---|
| 146 | <div class="admonition warning">
|
---|
| 147 | <p class="first admonition-title">Warning</p>
|
---|
| 148 | <p class="last">If you want to install it <em>system-wide</em>, probably you will need <em>root</em>
|
---|
| 149 | privileges (check your OS documentation to learn more about how to get
|
---|
| 150 | <em>root</em> privileges - for example using <a class="reference external" href="http://sudo.ws">sudo</a>)</p>
|
---|
| 151 | </div>
|
---|
| 152 | <div class="admonition note">
|
---|
| 153 | <p class="first admonition-title">Note</p>
|
---|
| 154 | <p class="last">This process will work inside a <a class="reference external" href="http://www.virtualenv.org/en/latest/index.html">virtualenv</a> too.</p>
|
---|
| 155 | </div>
|
---|
| 156 | </div>
|
---|
| 157 | </div>
|
---|
| 158 | </div>
|
---|
[16] | 159 | <div class="section" id="setting-up-mailjam">
|
---|
| 160 | <span id="install-setting-up-mailjam"></span><h2><a class="toc-backref" href="#id12">Setting up Mailjam</a><a class="headerlink" href="#setting-up-mailjam" title="Permalink to this headline">¶</a></h2>
|
---|
[13] | 161 | <p>TBW</p>
|
---|
| 162 | </div>
|
---|
[16] | 163 | <div class="section" id="running-mailjam">
|
---|
| 164 | <span id="install-running-mailjam"></span><h2><a class="toc-backref" href="#id13">Running Mailjam</a><a class="headerlink" href="#running-mailjam" title="Permalink to this headline">¶</a></h2>
|
---|
[13] | 165 | <p>TBW</p>
|
---|
| 166 | </div>
|
---|
| 167 | <div class="section" id="running-tests-developers-only">
|
---|
| 168 | <span id="install-running-tests"></span><h2><a class="toc-backref" href="#id14">Running tests (developers only)</a><a class="headerlink" href="#running-tests-developers-only" title="Permalink to this headline">¶</a></h2>
|
---|
| 169 | <p>TBW</p>
|
---|
| 170 | <table class="docutils footnote" frame="void" id="id2" rules="none">
|
---|
| 171 | <colgroup><col class="label" /><col /></colgroup>
|
---|
| 172 | <tbody valign="top">
|
---|
[16] | 173 | <tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><a class="reference external" href="https://bitbucket.org/codigo23/mailjam">https://bitbucket.org/codigo23/mailjam</a></td></tr>
|
---|
[13] | 174 | </tbody>
|
---|
| 175 | </table>
|
---|
| 176 | </div>
|
---|
| 177 | </div>
|
---|
| 178 |
|
---|
| 179 |
|
---|
| 180 | </div>
|
---|
| 181 | </div>
|
---|
| 182 | </div>
|
---|
| 183 | <div class="sphinxsidebar">
|
---|
| 184 | <div class="sphinxsidebarwrapper">
|
---|
| 185 | <h3><a href="index.html">Table Of Contents</a></h3>
|
---|
| 186 | <ul>
|
---|
| 187 | <li><a class="reference internal" href="#">Installation instructions</a><ul>
|
---|
| 188 | <li><a class="reference internal" href="#first-install-dependencies">First, install dependencies</a></li>
|
---|
[16] | 189 | <li><a class="reference internal" href="#second-install-mailjam">Second, install Mailjam</a><ul>
|
---|
[13] | 190 | <li><a class="reference internal" href="#installing-using-pip">Installing using pip</a></li>
|
---|
| 191 | <li><a class="reference internal" href="#installing-using-easy-install">Installing using easy_install</a></li>
|
---|
| 192 | <li><a class="reference internal" href="#installing-inside-a-virtualenv">Installing inside a virtualenv</a></li>
|
---|
| 193 | <li><a class="reference internal" href="#installing-from-sources">Installing from sources</a><ul>
|
---|
| 194 | <li><a class="reference internal" href="#releases">Releases</a></li>
|
---|
| 195 | <li><a class="reference internal" href="#from-repository">From repository</a></li>
|
---|
| 196 | </ul>
|
---|
| 197 | </li>
|
---|
| 198 | </ul>
|
---|
| 199 | </li>
|
---|
[16] | 200 | <li><a class="reference internal" href="#setting-up-mailjam">Setting up Mailjam</a></li>
|
---|
| 201 | <li><a class="reference internal" href="#running-mailjam">Running Mailjam</a></li>
|
---|
[13] | 202 | <li><a class="reference internal" href="#running-tests-developers-only">Running tests (developers only)</a></li>
|
---|
| 203 | </ul>
|
---|
| 204 | </li>
|
---|
| 205 | </ul>
|
---|
| 206 |
|
---|
| 207 | <h4>Previous topic</h4>
|
---|
| 208 | <p class="topless"><a href="overview.html"
|
---|
[16] | 209 | title="previous chapter">Overview of mailjam’s architecture</a></p>
|
---|
[13] | 210 | <h4>Next topic</h4>
|
---|
| 211 | <p class="topless"><a href="configuration.html"
|
---|
| 212 | title="next chapter">Configuration</a></p>
|
---|
| 213 | <h3>This Page</h3>
|
---|
| 214 | <ul class="this-page-menu">
|
---|
| 215 | <li><a href="_sources/install.txt"
|
---|
| 216 | rel="nofollow">Show Source</a></li>
|
---|
| 217 | </ul>
|
---|
| 218 | <div id="searchbox" style="display: none">
|
---|
| 219 | <h3>Quick search</h3>
|
---|
| 220 | <form class="search" action="search.html" method="get">
|
---|
| 221 | <input type="text" name="q" />
|
---|
| 222 | <input type="submit" value="Go" />
|
---|
| 223 | <input type="hidden" name="check_keywords" value="yes" />
|
---|
| 224 | <input type="hidden" name="area" value="default" />
|
---|
| 225 | </form>
|
---|
| 226 | <p class="searchtip" style="font-size: 90%">
|
---|
| 227 | Enter search terms or a module, class or function name.
|
---|
| 228 | </p>
|
---|
| 229 | </div>
|
---|
| 230 | <script type="text/javascript">$('#searchbox').show(0);</script>
|
---|
| 231 | </div>
|
---|
| 232 | </div>
|
---|
| 233 | <div class="clearer"></div>
|
---|
| 234 | </div>
|
---|
| 235 | <div class="related">
|
---|
| 236 | <h3>Navigation</h3>
|
---|
| 237 | <ul>
|
---|
| 238 | <li class="right" style="margin-right: 10px">
|
---|
| 239 | <a href="genindex.html" title="General Index"
|
---|
| 240 | >index</a></li>
|
---|
| 241 | <li class="right" >
|
---|
| 242 | <a href="configuration.html" title="Configuration"
|
---|
| 243 | >next</a> |</li>
|
---|
| 244 | <li class="right" >
|
---|
[16] | 245 | <a href="overview.html" title="Overview of mailjam’s architecture"
|
---|
[13] | 246 | >previous</a> |</li>
|
---|
[16] | 247 | <li><a href="index.html">Mailjam 0.1.0 documentation</a> »</li>
|
---|
[13] | 248 | </ul>
|
---|
| 249 | </div>
|
---|
| 250 | <div class="footer">
|
---|
| 251 | © Copyright 2012, Soluciones Informaticas Codigo23 S.L.U..
|
---|
| 252 | Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.2.
|
---|
| 253 | </div>
|
---|
| 254 | </body>
|
---|
| 255 | </html>
|
---|