updated source docs for web pages

Author: Ewan Klein

web/Makefile

@@ -23,6 +23,9 @@ web: clean_api
 	@echo
 	@echo "Build finished. The HTML pages are in $(WEB)."
 
+without_api: clean_api
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(WEB)
+
 clean_api:
 	rm -f api/modules.rst api/nltk.*.rst
 

web/conf.py

@@ -44,16 +44,16 @@
 
 # General information about the project.
 project = u'NLTK'
-copyright = u'2012, NLTK Project'
+copyright = u'2013, NLTK Project'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '2.0'
+version = '3.0'
 # The full version, including alpha/beta/rc tags.
-release = '2.0'
+release = '3.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -67,7 +67,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ['_build', 'api/modules.rst', 'dev/*.rst']
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 #default_role = None
@@ -129,11 +129,11 @@
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
+html_last_updated_fmt = '%b %d, %Y'
 
 # If true, SmartyPants will be used to convert quotes and dashes to
 # typographically correct entities.
-#html_use_smartypants = True
+html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
 #html_sidebars = {}

web/index.rst

@@ -2,7 +2,8 @@ Natural Language Toolkit
 ========================
 
 NLTK is a leading platform for building Python programs to work with human language data.
-It provides easy-to-use interfaces to over 50 corpora and lexical resources such as WordNet,
+It provides easy-to-use interfaces to `over 50 corpora and lexical
+resources <http://nltk.org/nltk_data/>`_ such as WordNet,
 along with a suite of text processing libraries for classification, tokenization, stemming, tagging, parsing, and semantic reasoning.
 
 Thanks to a hands-on guide introducing programming fundamentals alongside topics in computational linguistics,
@@ -17,7 +18,7 @@ introduction to programming for language processing.
 Written by the creators of NLTK, it guides the reader through the fundamentals
 of writing Python programs, working with corpora, categorizing text, analyzing linguistic structure,
 and more.
-A `new version <http://nltk.org/book3>` with updates for Python 3 and NLTK 3 is in preparation.
+A `new version <http://nltk.org/book3>`_ with updates for Python 3 and NLTK 3 is in preparation.
 
 Some simple things you can do with NLTK
 ---------------------------------------
@@ -48,41 +49,40 @@ Identify named entities:
 
 Display a parse tree:
 
-.. doctest::
-    :options: +SKIP
-
     >>> from nltk.corpus import treebank
     >>> t = treebank.parsed_sents('wsj_0001.mrg')[0]
     >>> t.draw()
 
 .. image:: images/tree.gif
 
-NB. If you publish work that uses NLTK, please cite the NLTK book as follows:
-Bird, Steven, Edward Loper and Ewan Klein (2009).
-Natural Language Processing with Python.  O'Reilly Media Inc.
+NB. If you publish work that uses NLTK, please cite the NLTK book as
+follows:
+
+	Bird, Steven, Edward Loper and Ewan Klein (2009), *Natural Language Processing with Python*.  O'Reilly Media Inc.
 
-Links
------
+Community
+---------
+
+* `NLTK mailing list <http://groups.google.com/group/nltk>`_ -- release announcements only, very low volume
+* `NLTK-Users mailing list <http://groups.google.com/group/nltk-users>`_ -- user discussions
+* `NLTK-Dev mailing list <http://groups.google.com/group/nltk-dev>`_ -- developers only
+* `NLTK-Translation mailing list <http://groups.google.com/group/nltk-translation>`_ -- discussions about translating the NLTK book
 
-* `NLTK mailing list <http://groups.google.com/group/nltk>`_ - release announcements only, very low volume
-* `NLTK-Users mailing list <http://groups.google.com/group/nltk-users>`_ - user discussions
-* `NLTK-Dev mailing list <http://groups.google.com/group/nltk-dev>`_ - developers only
-* `NLTK-Translation mailing list <http://groups.google.com/group/nltk-translation>`_ - discussions about translating the NLTK book
-* `NLTK's previous website <https://sites.google.com/site/naturallanguagetoolkit>`_
-* `NLTK development at GitHub <https://github.com/nltk>`_
-* `Publications about NLTK <http://scholar.google.com.au/scholar?q=NLTK>`_
 
 Contents
 ========
 
+
 .. toctree::
    :maxdepth: 1
 
    news
    install
    data
-   howto
-   api/nltk
+   Wiki <https://github.com/nltk/nltk/wiki> 
+   API <api/nltk>
+   HOWTO <http://nltk.org/howto>
+   NLTK Development <https://github.com/nltk>
    team
 
 * :ref:`genindex`