Scrapy, a fast high-level web crawling & scraping framework for Python.
tutorial: updating extracting data section to introduce CSS and XPath equally
Elias Dorneles31545a9f8478
diff --git a/docs/intro/tutorial.rst b/docs/intro/tutorial.rstindex a3a0ab390..34d33a9b3 100644--- a/docs/intro/tutorial.rst+++ b/docs/intro/tutorial.rst@@ -177,8 +177,8 @@ Scrapy to do so. This happens because :meth:`~scrapy.spiders.Spider.parse`is Scrapy's default callback method.-Extracting Items-----------------+Extracting data+---------------Introduction to Selectors^^^^^^^^^^^^^^^^^^^^^^^^^@@ -191,25 +191,31 @@ mechanisms see the :ref:`Selectors documentation <topics-selectors>`... _XPath: https://www.w3.org/TR/xpath.. _CSS: https://www.w3.org/TR/selectors-Here are some examples of XPath expressions and their meanings:+Here are some examples of XPath expressions, their meanings and CSS+equivalents:* ``/html/head/title``: selects the ``<title>`` element, inside the ``<head>``- element of an HTML document. Equivalent CSS selector: ``html > head > title``.+ element of an HTML document. Using CSS, the equivalent would be: ``html >+ head > title``.* ``/html/head/title/text()``: selects the text inside the aforementioned- ``<title>`` element. Equivalent CSS selector: ``html > head > title ::text``.+ ``<title>`` element. In Scrapy, you can do the same with CSS using ``html >+ head > title::text``. The ``::text`` bit isn't really CSS, but is supported+ by Scrapy for extracting purposes.* ``//td``: selects all the ``<td>`` elements from the whole document.- Equivalent CSS selector: ``td``.--* ``//div[@class="mine"]``: selects all ``div`` elements which contain an- attribute ``class="mine"``. Equivalent CSS selector: ``div.mine``.--These are just a couple of simple examples of what you can do with XPath, but-XPath expressions are indeed much more powerful. To learn more about XPath, we-recommend `this tutorial to learn XPath through examples-<http://zvon.org/comp/r/tut-XPath_1.html>`_, and `this tutorial to learn "how-to think in XPath" <http://plasmasturm.org/log/xpath101/>`_.+ The equivalent CSS selector: ``td``.++* ``//div[@id="mine"]``: selects all ``div`` elements which contain an+ attribute ``id="mine"``. The equivalent CSS selector would be: ``div#mine``.++These are just a couple of simple examples of what you can do with XPath and+CSS. XPath expressions are very powerful, they're the foundation of Scrapy+selectors. In fact, CSS selectors are converted to XPath expressions+under-the-hood. To learn more about XPath, we recommend `this tutorial to learn+XPath through examples <http://zvon.org/comp/r/tut-XPath_1.html>`_, and `this+tutorial to learn "how to think in XPath"+<http://plasmasturm.org/log/xpath101/>`_... note:: **CSS vs XPath:** you can go a long way extracting data from web pagesusing only CSS selectors. However, XPath offers more power because besides