diff options
author | Ian Bicking <ian@ianbicking.org> | 2005-07-16 21:02:03 +0000 |
---|---|---|
committer | Ian Bicking <ian@ianbicking.org> | 2005-07-16 21:02:03 +0000 |
commit | 01afc0192a69c38e33c378121abceb6bc8f39d2a (patch) | |
tree | d813009ea9c75ca34d7ad96cc4b6b6aa3c527e23 | |
parent | bec73972570bb4fdde2d42cc92e81cf839a551e6 (diff) | |
download | paste-git-01afc0192a69c38e33c378121abceb6bc8f39d2a.tar.gz |
Added new pages to fill out site nav
-rw-r--r-- | docs/doc.conf | 2 | ||||
-rw-r--r-- | docs/index.txt | 34 | ||||
-rwxr-xr-x | docs/rebuild | 8 | ||||
-rw-r--r-- | docs/web/community/index.txt | 15 | ||||
-rw-r--r-- | docs/web/community/mailing-list.txt | 36 | ||||
-rw-r--r-- | docs/web/community/repository.txt | 13 | ||||
-rw-r--r-- | docs/web/download/index.txt | 5 | ||||
-rw-r--r-- | docs/web/index.txt | 77 |
8 files changed, 111 insertions, 79 deletions
diff --git a/docs/doc.conf b/docs/doc.conf index e60d8ce..2107087 100644 --- a/docs/doc.conf +++ b/docs/doc.conf @@ -4,4 +4,6 @@ base = os.path.dirname(__file__) dest = os.path.join(os.path.dirname(os.path.dirname(base)), 'htdocs') dirs[base] = os.path.join(dest, 'docs') dirs[os.path.join(base, 'web')] = dest +dirs[os.path.join(base, 'web', 'community')] = os.path.join(dest, 'community') +dirs[os.path.join(base, 'web', 'download')] = os.path.join(dest, 'download') template = os.path.join(base, 'template.tmpl') diff --git a/docs/index.txt b/docs/index.txt new file mode 100644 index 0000000..d88bfa0 --- /dev/null +++ b/docs/index.txt @@ -0,0 +1,34 @@ +Documentation +============= + +Reference +--------- + +* `Paste Reference Documentation + <http://pythonpaste.org/docs/reference.html>`_ +* `Configuration <configuration.html>`_ +* `Integrating Frameworks Info Paste <integration.html>`_ +* `Roadmap for Paste <roadmap.html>`_ +* `Testing Applications With Paste <testing-applications.html>`_ +* `URL Parsing with WSGI and Paste <url-parsing-with-wsgi.html>`_ + +Tutorials and Introduction +-------------------------- + +* `To-Do Tutorial <TodoTutorial.html>`_ +* `What Is Paste? <what-is-paste.html>`_; older related documents: + + * `What is WSGIKit <http://blog.ianbicking.org/what-is-wsgikit.html>`_ + * `What can WSGIKit do for you? + <http://blog.ianbicking.org/what-can-wsgikit-do-for-you.html>`_ + * Ian Bicking presented at `PyCon 2005 <http://pycon.org/dc2005>`_ on + `WSGI Middleware and WSGIKit + <http://www.imagescape.com/software/docs/wsgikit-pycon2005/>`_: + *Using WSGI Middleware to build a foundation for Python web + programming* + +Developers +---------- + +* `Developer Guidelines <DeveloperGuidelines.html>`_ +* `Style Guide <StyleGuide.html>`_ diff --git a/docs/rebuild b/docs/rebuild index f9f14e5..968b0e7 100755 --- a/docs/rebuild +++ b/docs/rebuild @@ -5,9 +5,11 @@ parent=`dirname $here` echo "Adding $parent to \$PYTHONPATH" export PYTHONPATH=$parent:$PYTHONPATH -NORMAL="DeveloperGuidelines Paste servers StyleGuide web/index \ +NORMAL="DeveloperGuidelines Paste servers StyleGuide index web/index \ what-is-paste testing-applications url-parsing-with-wsgi \ - roadmap configuration integration" + roadmap configuration integration web/community/mailing-list + web/community/repository web/community/index + web/download/index" DOCTEST_BUILD="blog-tutorial TodoTutorial" for NAME in $NORMAL ; do @@ -35,3 +37,5 @@ echo ":extracted: `date`" >> reference.txt echo >> reference.txt python ../paste/docsupport/extract.py paste >> reference.txt rst2html.py reference.txt > reference.html +python ../paste/docsupport/gensite.py +chmod +x ~paste/htdocs/index.html diff --git a/docs/web/community/index.txt b/docs/web/community/index.txt new file mode 100644 index 0000000..e5e2360 --- /dev/null +++ b/docs/web/community/index.txt @@ -0,0 +1,15 @@ +Community +========= + +Much of the communication goes on in the `mailing lists +<mailing-list.html>`_; see that page for information on the lists. + +For live IRC discussion, try the ``#webware`` channel on `Freenode +<http://freenode.net/>`_. + +If you find bugs in the code or documentation, please `submit a ticket +<http://pythonpaste.org/trac/report>`_. You can also `view tickets +<http://pythonpaste.org/trac/report>`_. + + + diff --git a/docs/web/community/mailing-list.txt b/docs/web/community/mailing-list.txt new file mode 100644 index 0000000..eb4ee98 --- /dev/null +++ b/docs/web/community/mailing-list.txt @@ -0,0 +1,36 @@ +Mailing Lists +============= + +General discussion and questions should go to: + +`paste-users@pythonpaste.org <http://pythonpaste.org/mailman/listinfo/paste-users>`_: + `Subscribe <http://pythonpaste.org/mailman/listinfo/paste-users>`__, + `Archives <http://pythonpaste.org/archives/list/paste-users.en.html>`__ + +To receive announcements: + +`paste-news@pythonpaste.org <http://pythonpaste.org/mailman/listinfo/paste-news>`_: + `Subscribe <http://pythonpaste.org/mailman/listinfo/paste-news>`__, + `Archives <http://pythonpaste.org/archives/list/paste-news.en.html>`__, + `Atom feed <http://pythonpaste.org/news/atom.xml>`_ + +To receive notification of new checkins: + +`paste-checkins@pythonpaste.org <http://pythonpaste.org/mailman/listinfo/paste-checkins>`_: + `Subscribe <http://pythonpaste.org/mailman/listinfo/paste-checkins>`__, + `RSS feed <http://pythonpaste.org/trac/timeline/?daysback=90&max=50&wiki=on&ticket=on&changeset=on&milestone=on&format=rss>`_ + +Bug reports should be added to the tracker, but you can be notified of +new bugs on the list: + +`paste-bugs@pythonpaste.org <http://pythonpaste.org/mailman/listinfo/paste-bugs>`_: + `Subscribe <http://pythonpaste.org/mailman/listinfo/paste-bugs>`__, + `View bug reports <http://pythonpaste.org/trac/report>`__, + `Submit bug report <http://pythonpaste.org/trac/newticket>`_ + +More abstract discussion of Python web programming should go to: + +`web-sig@python.org <http://mail.python.org/mailman/listinfo/web-sig>`_: + `Subscribe <http://mail.python.org/mailman/listinfo/web-sig>`__, + `Archives <http://www.python.org/pipermail/web-sig/>`__ + diff --git a/docs/web/community/repository.txt b/docs/web/community/repository.txt new file mode 100644 index 0000000..344b017 --- /dev/null +++ b/docs/web/community/repository.txt @@ -0,0 +1,13 @@ +Repository +========== + +Paste is kept in a `Subversion <http://subversion.tigris.org/>`_ +repository at http://svn.pythonpaste.org/Paste + +If you are using a command-line Subversion client, you can check +it out like:: + + svn co http://svn.pythonpaste.org/Paste/trunk Paste + +If you are on Windows you may want to use `TortoiseSVN +<http://tortoisesvn.tigris.org/>`_. diff --git a/docs/web/download/index.txt b/docs/web/download/index.txt new file mode 100644 index 0000000..b1fbaa1 --- /dev/null +++ b/docs/web/download/index.txt @@ -0,0 +1,5 @@ +Downloads +========= + +Right now Paste is only available through the `repository +</community/repository.html>`_. diff --git a/docs/web/index.txt b/docs/web/index.txt index 9932ef5..6786327 100644 --- a/docs/web/index.txt +++ b/docs/web/index.txt @@ -29,80 +29,3 @@ To check out Paste:: Note that it includes a script ``build-pkg`` which fetches a bunch of packages that make Paste more useful. A big tarball of all the requirements stuffed together will probably be forthcoming. - -Get Involved -============ - -Discussion: - paste-users@pythonpaste.org (`subscribe - <http://pythonpaste.org/mailman/listinfo/paste-users>`__, - `archives <http://pythonpaste.org/archives/list/paste-users.en.html>`__) - -Announcements: - paste-news@pythonpaste.org (`subscribe - <http://pythonpaste.org/mailman/listinfo/paste-news>`__, - `archives <http://pythonpaste.org/archives/list/paste-news.en.html>`__, - `atom feed <http://pythonpaste.org/news/atom.xml>`_) - -Checkins: - paste-checkins@pythonpaste.org (`subscribe - <http://pythonpaste.org/mailman/listinfo/paste-checkins>`__, - `rss feed <http://pythonpaste.org/trac/timeline/?daysback=90&max=50&wiki=on&ticket=on&changeset=on&milestone=on&format=rss>`_) - -IRC: - ``#webware`` on `freenode <http://freenode.net>`_ - -Bug reports: - Via `Trac <http://pythonpaste.org/trac/>`_: `view bug reports - <http://pythonpaste.org/trac/report>`_, `submit bug - <http://pythonpaste.org/trac/newticket>`_. Notification goes - to paste-bugs@pythonpaste.org (`subscribe - <http://pythonpaste.org/mailman/listinfo/paste-bugs>`__) - -More abstract discussion about Python web programming in general: - web-sig@python.org (`subscribe - <http://mail.python.org/mailman/listinfo/web-sig>`__, `archives - <http://www.python.org/pipermail/web-sig/>`__) - -Resources -========= - -* `Configuration <docs/configuration.html>`_. - -* `Integrating Frameworks Into Paste <docs/integration.html>`_. - -* `Roadmap <docs/roadmap.html>`_, a list of concrete goals and ideas. Not - much of a roadmap yet, as there's no fixed milestones. - -* `Paste Reference Document <docs/reference.html>`_ - -* `Testing Applications with Paste <docs/testing-applications.html>`_, - a document on Paste's application testing facilities. - -* `To-do tutorial`_, an introduction to Paste installation and application - design - -* `URL Parsing with WSGI and Paste - <docs/url-parsing-with-wsgi.html>`_, an introduction into the - architecture of Paste's URL parsing, and the ways you can bring WSGI - deeper into your framework. - -* `What is Paste? <./docs/what-is-paste.html>`_: a description of the - project scope (see also the older documents `What is WSGIKit? - <http://blog.ianbicking.org/what-is-wsgikit.html>`_ and `What can - WSGIKit do for you? - <http://blog.ianbicking.org/what-can-wsgikit-do-for-you.html>`_) - -* Ian Bicking presented at `PyCon 2005`_ on `WSGI Middleware and - WSGIKit`_: *Using WSGI Middleware to build a foundation for Python web - programming* - -* The Webware API portion of Paste should be discussed on - webware-devel@lists.sf.net - -* The WSGI aspect of Paste should be discussed on web-sig@python.org - -.. _To-do tutorial: ./docs/TodoTutorial.html -.. _PyCon 2005: http://pycon.org/dc2005 -.. _WSGI Middleware and WSGIKit: http://www.imagescape.com/software/docs/wsgikit-pycon2005/ - |