130 lines
5.5 KiB
HTML
130 lines
5.5 KiB
HTML
<!DOCTYPE html PUBLIC
|
|
"-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN"
|
|
"http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<script type="text/javascript" src="docs.js"></script>
|
|
<link rel="stylesheet" type="text/css" href="docs.css"/>
|
|
<title>Venus Installation</title>
|
|
</head>
|
|
<body>
|
|
<h2>Installation</h2>
|
|
<p>Venus has been tested on Linux, and Mac OSX, and Windows.</p>
|
|
|
|
<p>You'll need at least Python 2.2 installed on your system, we recommend
|
|
Python 2.4 though as there may be bugs with the earlier libraries.</p>
|
|
|
|
<p>Everything Pythonesque Planet needs to provide basic operation should be
|
|
included in the distribution. Some optional features may require
|
|
additional libraries, for example:</p>
|
|
<ul>
|
|
<li>Usage of XSLT requires either
|
|
<a href="http://xmlsoft.org/XSLT/xsltproc2.html">xsltproc</a>
|
|
or <a href="http://xmlsoft.org/XSLT/python.html">python-libxslt</a>.</li>
|
|
<li>The current interface to filters written in non-templating languages
|
|
(e.g., python) uses the
|
|
<a href="http://docs.python.org/lib/module-subprocess.html">subprocess</a>
|
|
module which was introduced in Python 2.4.</li>
|
|
<li>Usage of FOAF as a reading list requires
|
|
<a href="http://librdf.org/">librdf</a>.</li>
|
|
</ul>
|
|
|
|
<h3>General Instructions</h3>
|
|
|
|
<p>
|
|
These instructions apply to any platform. Check the instructions
|
|
below for more specific instructions for your platform.
|
|
</p>
|
|
|
|
<ol>
|
|
<li><p>If you are reading this online, you will need to
|
|
<a href="../index.html">download</a> and extract the files into a folder somewhere.
|
|
You can place this wherever you like, <code>~/planet</code>
|
|
and <code>~/venus</code> are good
|
|
choices, but so's anywhere else you prefer.</p></li>
|
|
<li><p>This is very important: from within that directory, type the following
|
|
command:</p>
|
|
<blockquote><code>python runtests.py</code></blockquote>
|
|
<p>This should take anywhere from a one to ten seconds to execute. No network
|
|
connection is required, and the script cleans up after itself. If the
|
|
script completes with an "OK", you are good to go. Otherwise stopping here
|
|
and inquiring on the
|
|
<a href="http://lists.planetplanet.org/mailman/listinfo/devel">mailing list</a>
|
|
is a good idea as it can save you lots of frustration down the road.</p></li>
|
|
<li><p>Make a copy of one of the <code>ini</code> the files in the
|
|
<a href="../examples">examples</a> subdirectory,
|
|
and put it wherever you like; I like to use the Planet's name (so
|
|
<code>~/planet/debian</code>), but it's really up to you.</p></li>
|
|
<li><p>Edit the <code>config.ini</code> file in this directory to taste,
|
|
it's pretty well documented so you shouldn't have any problems here. Pay
|
|
particular attention to the <code>output_dir</code> option, which should be
|
|
readable by your web server. If the directory you specify in your
|
|
<code>cache_dir</code> exists; make sure that it is empty.</p></li>
|
|
<li><p>Run it: <code>python planet.py pathto/config.ini</code></p>
|
|
<p>You'll want to add this to cron, make sure you run it from the
|
|
right directory.</p></li>
|
|
<li><p>(Optional)</p>
|
|
<p>Tell us about it! We'd love to link to you on planetplanet.org :-)</p></li>
|
|
<li><p>(Optional)</p>
|
|
<p>Build your own themes, templates, or filters! And share!</p></li>
|
|
</ol>
|
|
|
|
<h3 id="macosx">Mac OS X and Fink Instructions</h3>
|
|
|
|
<p>
|
|
The <a href="http://fink.sourceforge.net/">Fink Project</a> packages
|
|
various open source software for MacOS. This makes it a little easier
|
|
to get started with projects like Planet Venus.
|
|
</p>
|
|
|
|
<p>
|
|
Note: in the following, we recommend explicitly
|
|
using <code>python2.4</code>. As of this writing, Fink is starting to
|
|
support <code>python2.5</code> but the XML libraries, for example, are
|
|
not yet ported to the newer python so Venus will be less featureful.
|
|
</p>
|
|
|
|
<ol>
|
|
<li><p>Install the XCode development tools from your Mac OS X install
|
|
disks</p></li>
|
|
<li><p><a href="http://fink.sourceforge.net/download/">Download</a>
|
|
and install Fink</p></li>
|
|
<li><p>Tell fink to install the Planet Venus prerequisites:<br />
|
|
<code>fink install python24 celementtree-py24 bzr-py24 libxslt-py24
|
|
libxml2-py24</code></p></li>
|
|
<li><p><a href="../index.html">Download</a> and extract the Venus files into a
|
|
folder somewhere</p></li>
|
|
<li><p>Run the tests: <code>python2.4 runtests.py</code><br /> This
|
|
will warn you that the RDF library is missing, but that's
|
|
OK.</p></li>
|
|
<li><p>Continue with the general steps above, starting with Step 3. You
|
|
may want to explicitly specify <code>python2.4</code>.</p></li>
|
|
</ol>
|
|
|
|
<h3 id="ubuntu">Ubuntu Linux (Edgy Eft) instructions</h3>
|
|
|
|
<p>Before starting, issue the following command:</p>
|
|
|
|
<blockquote><pre>sudo apt-get install bzr python2.4-librdf</pre></blockquote>
|
|
|
|
<h3 id="windows">Windows instructions</h3>
|
|
|
|
<p>
|
|
htmltmpl templates (and Django too, since it currently piggybacks on
|
|
the htmltmpl implementation) on Windows require
|
|
the <a href="http://sourceforge.net/projects/pywin32/">pywin32</a>
|
|
module.
|
|
</p>
|
|
|
|
<h3 id="python22">Python 2.2 instructions</h3>
|
|
|
|
<p>If you are running Python 2.2, you may also need to install <a href="http://pyxml.sourceforge.net/">pyxml</a>. If the
|
|
following runs without error, you do <b>not</b> have the problem.</p>
|
|
<blockquote><pre>python -c "__import__('xml.dom.minidom').dom.minidom.parseString('<entry xml:lang=\"en\"/>')"</pre></blockquote>
|
|
<p>Installation of pyxml varies by platform. For Ubuntu Linux (Dapper Drake), issue the following command:</p>
|
|
|
|
<blockquote><pre>sudo apt-get install python2.2-xml</pre></blockquote>
|
|
|
|
</body>
|
|
</html>
|