scrapy/docs
hsiao yi cd9d8e28cd
unify the quote style
2018-12-11 19:21:07 +08:00
..
_ext fix docs building with recent sphinx: don't use deprecated sphinx options and imports 2018-02-13 19:47:41 +05:00
_static
…
_templates
…
intro unify the quote style 2018-12-11 19:21:07 +08:00
topics Correct the unclear comments by adding <# < processing code not shown > 2018-10-02 19:48:48 +02:00
utils
…
Makefile
…
README.rst
…
conf.py Doc: update copyright notice 2018-07-20 14:46:57 +03:00
contributing.rst make amendments to grammer 2018-07-25 14:38:37 +08:00
faq.rst
…
index.rst Added general guide for developer tools instead of Firefox and Firebug-sections 2018-08-22 14:15:53 +02:00
news.rst 1.5.1 release notes 2018-07-12 02:17:08 +05:00
requirements.txt fix docs building with recent sphinx: don't use deprecated sphinx options and imports 2018-02-13 19:47:41 +05:00
versioning.rst
…

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>