scrapy/docs
Pablo Hoffman fa644f7a5e Some simplifications to Scrapyd architecture and internals:
- launcher no longer knows about egg storage
- removed get_spider_list_from_eggifile() file and replaced by simpler
  get_spider_list() which doesn't receive en egg file as argument
- changed "egg runner" name to just "runner" to reflect the fact that it
  doesn't necesarilly run eggs (though it does in the default case)

--HG--
rename : scrapyd/eggrunner.py => scrapyd/runner.py
2010-12-27 16:22:32 -02:00
..
_ext Added dont_redirect request.meta key to make RedirectMiddleware ignore requests. Closes #233 2010-09-09 21:37:35 -03:00
_static Added notice to documentation, pointing dev to stable versions and viceversa 2010-12-23 13:03:40 -02:00
_templates minor indentation improvement 2010-12-23 13:04:49 -02:00
experimental removed scheduler middleware doc, as scheduler middleware will be removed soon 2010-08-10 16:59:49 -03:00
intro docs/intro/install.rst: added -U flag to easy_install command 2010-11-22 13:50:19 -02:00
topics Some simplifications to Scrapyd architecture and internals: 2010-12-27 16:22:32 -02:00
Makefile Removed unneeded code (since autodoc is not used in Sphinx doc) 2010-09-22 10:52:02 -03:00
README mv scrapy/trunk to root as part of svn2hg migration 2009-05-06 15:55:17 -03:00
api-stability.rst fixed typo 2009-11-06 16:49:48 -02:00
conf.py Added notice to documentation, pointing dev to stable versions and viceversa 2010-12-23 13:03:40 -02:00
contributing.rst Added verbose option to 'version' command. Closes #298 2010-12-13 00:32:44 -02:00
faq.rst Simplified installation guide, including lxml as alternative dependency to libxml2. Closes #280 2010-11-17 21:32:23 -02:00
index.rst Added new Scrapy service with support for: 2010-09-03 15:54:42 -03:00

README

======================================
Scrapy documentation quick start guide
======================================

This file provides a quick guide on how to compile the Scrapy documentation.


Setup the environment
---------------------

To compile the documentation you need the following Python libraries:

 * Sphinx
 * docutils
 * jinja

If you have setuptools available the following command will install all of them
(since Sphinx requires both docutils and jinja)::

    easy_install Sphinx


Compile the documentation
-------------------------

To compile the documentation (to classic HTML output) run the following command
from this dir::

    make html

Documentation will be generated (in HTML format) inside the ``build/html`` dir.


View the documentation
----------------------

To view the documentation run the following command::

    make htmlview

This command will fire up your default browser and open the main page of your
(previously generated) HTML documentation.


Start over
----------

To cleanup all generated documentation files and start from scratch run::

    make clean

Keep in mind that this command won't touch any documentation source files.