scrapy/docs
Adrián Chaves d346b8cb0f
Merge pull request #3626 from Gallaecio/middlewares-from-crawler
[MRG+1] Document that the main entry point of downloader and spider middlewar…
2019-03-15 08:58:35 +01:00
..
_ext
…
_static
…
_templates
…
intro
…
topics Merge pull request #3626 from Gallaecio/middlewares-from-crawler 2019-03-15 08:58:35 +01:00
utils
…
Makefile
…
README.rst
…
conf.py
…
contributing.rst Switch from ` to `` where inline code formatting is desired 2019-03-01 16:56:58 +01:00
faq.rst
…
index.rst Use the description from README.rst on index.rst 2019-03-08 17:22:49 +01:00
news.rst Merge branch 'master' into backward 2019-03-14 22:21:09 +05:00
requirements.txt
…
versioning.rst backwards → backward (adj.) 2019-03-01 16:10:23 +01:00

README.rst

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> </head>
orphan:

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 Sphinx Python library. To install it and all its dependencies run the following command from this dir

pip install -r requirements.txt

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.

Recreating documentation on the fly

There is a way to recreate the doc automatically when you make changes, you need to install watchdog (pip install watchdog) and then use:

make watch
</html>