From 14697b5fbac5888f9e9f2552e799fb5a13484b8b Mon Sep 17 00:00:00 2001 From: Pablo Hoffman Date: Sat, 3 Jan 2009 01:24:18 +0000 Subject: [PATCH] added FAQ to docs --HG-- extra : convert_revision : svn%3Ab85faa78-f9eb-468e-a121-7cced6da292c%40623 --- scrapy/trunk/docs/faq.rst | 31 +++++++++++++++++++++++++++++++ scrapy/trunk/docs/index.rst | 6 ++++++ 2 files changed, 37 insertions(+) create mode 100644 scrapy/trunk/docs/faq.rst diff --git a/scrapy/trunk/docs/faq.rst b/scrapy/trunk/docs/faq.rst new file mode 100644 index 000000000..ff36987cb --- /dev/null +++ b/scrapy/trunk/docs/faq.rst @@ -0,0 +1,31 @@ +.. _faq: + +Frequently Asked Questions +========================== + +How does Scrapy compare to BeatifulSoul or lxml? +------------------------------------------------ + +`BeautifulSoup`_ and `lxml`_ are libraries for parsing HTML and XML. Scrapy is +an application framework for writing web spiders that crawl web sites and +extract data from it. Scrapy provides some mechanisms for extracting data +(called selectors) but you can easily use `BeautifulSoup`_ or `lxml`_ if you +feel more comfortable with them. After all, they're just parsing libraries +which can be imported and used from any Python code. + +To illustrate from another point of view, comparing `BeautifulSoup`_ or `lxml`_ +to Scrapy is like comparing `urllib`_ or `urlparse`_ to `Django`_ (a popular +Python web framework). + +.. _BeautifulSoup: http://www.crummy.com/software/BeautifulSoup/ +.. _lxml: http://codespeak.net/lxml/ +.. _urllib: http://docs.python.org/library/urllib.html +.. _urlparse: http://docs.python.org/library/urlparse.html +.. _Django: http://www.djangoproject.com + +Does Scrapy work in Python 3.0? +------------------------------- + +No, and there are no ongoing plans to port Scrapy to Python 3.0 yet. At the +moment Scrapy requires Python 2.5 or 2.6 to work. + diff --git a/scrapy/trunk/docs/index.rst b/scrapy/trunk/docs/index.rst index 13955e6f6..25c915521 100644 --- a/scrapy/trunk/docs/index.rst +++ b/scrapy/trunk/docs/index.rst @@ -13,3 +13,9 @@ Contents: intro/index topics/index ref/index + +.. toctree:: + :maxdepth: 1 + + faq +