scrapy/docs
Adrián Chaves d29bec60d7
Upgrade PyPy for CI, and test both 3.5 (oldest) and 3.6 (newest) (#4504)
* Upgrade PyPy for CI, and test both 3.5 (oldest) and 3.6 (newest)

* Log a detailed error message to discover why MockServer is not working

* Go for all lines!

* Disable tests based on mitmproxy while running on PyPy

* Fix test_get_func_args for PyPy 3.6+

* Make testPayloadDefaultCiphers work regardless of OpenSSL default ciphers

* Crossing fingers…

* Rename: testPayloadDefaultCiphers → testPayloadDisabledCipher

* Test the PyPy version currently documented as the minimum required version

* Fix the PYPY_VERSION tag

* Update the documentation about supported PyPy versions

* Also test the latest 3.5 Python version with PyPy

* Fix the PYPY_VERSION value for the latest 3.5 version

* Use pinned dependencies for asyncio and PyPy tests against oldest supported Python versions

* Fix PyPy installation for the pypy3-pinned Tox environment

* Try installing Cython

* Maybe PyPy requires lxml 3.6.0?

* install.rst: minor clarification

* lxml 4.0.0 is required on PyPy

* Require setuptools 18.5+

* Revert "Require setuptools 18.5+"

This reverts commit 017ec33ac2.

* Maintain lxml as a dependency if setuptools < 18.5 is used
2020-07-17 02:19:24 +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 Upgrade PyPy for CI, and test both 3.5 (oldest) and 3.6 (newest) (#4504) 2020-07-17 02:19:24 +05:00
topics Merge pull request #3608 from ejulio/feat-685 2020-07-16 18:11:19 +05: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 Update docs README with build instructions using tox 2020-05-26 19:09:23 +01:00
conf.py Use the itemlaoders library (#4516) 2020-07-15 12:08:36 +02:00
conftest.py Make tutorial doctests pass 2019-11-12 08:08:50 +01:00
contributing.rst Cover Scrapy 2.2.0 in the release notes (#4630) 2020-06-24 12:26:38 +02:00
faq.rst Upgrade PyPy for CI, and test both 3.5 (oldest) and 3.6 (newest) (#4504) 2020-07-17 02:19:24 +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.2.0 in the release notes (#4630) 2020-06-24 12:26:38 +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

Alternative method using tox

To compile the documentation to HTML run the following command:

tox -e docs

Documentation will be generated (in HTML format) inside the .tox/docs/tmp/html dir.

</html>