Added documentation for Ubuntu packages. Refs #211

docs/index.rst

@@ -124,6 +124,7 @@ Solving specific problems
    topics/firebug
    topics/leaks
    topics/images
+   topics/ubuntu
 
 :doc:`faq`
     Get answers to most frequently asked questions.
@@ -140,6 +141,9 @@ Solving specific problems
 :doc:`topics/images`
     Download static images associated with your scraped items.
 
+:doc:`topics/ubuntu`
+    Install latest Scrapy packages easily on Ubuntu
+
 .. _extending-scrapy:
 
 Extending Scrapy

docs/intro/install.rst

@@ -11,6 +11,10 @@ systems and it consists of the following 3 steps:
 * :ref:`intro-install-step2`
 * :ref:`intro-install-step3`
 
+If you use Ubuntu (9.10 or above), you can use the :ref:`Ubuntu packages
+<topics-ubuntu>` to install Scrapy more easily, skipping these steps. The
+Ubuntu packages are also kept updated with latest bug fixes.
+
 .. _intro-install-requirements:
 
 Requirements

docs/topics/ubuntu.rst

@@ -0,0 +1,29 @@
+.. _topics-ubuntu:
+
+===============
+Ubuntu packages
+===============
+
+`Insophia`_ publishes apt-gettable packages which are generally fresher than
+those in Ubuntu, and more stable too since they're built periodically from
+`Scrapy Mercurial repositories`_ (stable & development) and so they contain the
+latest bug fixes.
+
+To use the packages, add a line to your ``/etc/apt/sources.list``, then run
+``aptitude update`` and ``aptitude install scrapy``.
+
+.. warning:: Please note that these packages are updated frequently, and so if
+   you find you can't download the packages, try updating your apt package
+   lists first, e.g., with ``apt-get update`` or ``aptitude update``.
+
+For Ubuntu Lucid (10.04) and Ubuntu Karmic (9.10)::
+
+    deb http://archive.scrapy.org/ubuntu 0.10 main
+
+The public GPG key used to sign these packages can be imported into you APT
+keyring as follows::
+
+    curl -s http://archive.scrapy.org/debian/archive.key | sudo apt-key add -
+
+.. _Insophia: http://insophia.com/
+.. _Scrapy Mercurial repositories: http://hg.scrapy.org/