scrapy/docs
Adrián Chaves 36c3c9713e
Run tests with Python 3.5.0 (#4518)
* Run tests with Python 3.5.0

* Use Ubuntu Trusty 14.04 to test Python 3.5.0

* Use mitmproxy<3.0.0 on Python 3.5.0

* Skip tests requiring mitmproxy in Python 3.5.0

* Change the minimum Python version from 3.5 to 3.5.1

* Do not prevent Scrapy from working with Python 3.5.0

* Force system Python 3.5.1

* Do not install a non-system Python in Python 3.5.1 jobs

* Switch to Trusty to be able to test Xenial’s Python version ¯\_(ツ)_/¯

* Add missing trusty

* Stop breaking old PyPy

* Allow installing Scrapy on Python 3.5.0
2020-05-15 22:37:56 +05: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 DOC remove css file which isno longer needed 2015-04-15 03:44:49 +05:00
_templates Add Segment Analytics to Documentation 2016-09-02 14:51:07 -03:00
_tests Make developer-tools doctests pass 2019-11-25 12:32:35 +01:00
intro Run tests with Python 3.5.0 (#4518) 2020-05-15 22:37:56 +05:00
topics Cover chompjs in documentation (#4562) 2020-05-12 20:42:28 +02:00
utils Use pylint 2019-10-22 19:44:11 +02:00
Makefile Add a Sphinx extension to generate documentation coverage information 2019-06-04 15:03:25 +02:00
README.rst Clarify docs readme 2017-03-20 22:36:09 +05:30
conf.py Remove Python 2 encoding header from files (#4553) 2020-05-08 15:45:19 +02:00
conftest.py Make tutorial doctests pass 2019-11-12 08:08:50 +01:00
contributing.rst DOC linkcheck run; https and 301 link updates. 2020-02-25 16:51:33 +00:00
faq.rst Run tests with Python 3.5.0 (#4518) 2020-05-15 22:37:56 +05:00
index.rst Write release notes for Scrapy 2.0.0 (#4329) 2020-03-03 09:11:11 +01:00
news.rst Cover Scrapy 2.1 in the release notes (#4499) 2020-04-24 11:44:36 +02:00
requirements.txt Loose restrictions for docs requirements 2020-04-14 14:57:20 -03:00
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>