From f5ffffa5ed4aa45e46855eba5de11074c333e977 Mon Sep 17 00:00:00 2001 From: ianb Date: Sat, 16 Jul 2005 21:02:03 +0000 Subject: Added new pages to fill out site nav --- docs/doc.conf | 2 + docs/index.txt | 34 ++++++++++++++++ docs/rebuild | 8 +++- docs/web/community/index.txt | 15 ++++++++ docs/web/community/mailing-list.txt | 36 +++++++++++++++++ docs/web/community/repository.txt | 13 +++++++ docs/web/download/index.txt | 5 +++ docs/web/index.txt | 77 ------------------------------------- 8 files changed, 111 insertions(+), 79 deletions(-) create mode 100644 docs/index.txt create mode 100644 docs/web/community/index.txt create mode 100644 docs/web/community/mailing-list.txt create mode 100644 docs/web/community/repository.txt create mode 100644 docs/web/download/index.txt 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 + `_ +* `Configuration `_ +* `Integrating Frameworks Info Paste `_ +* `Roadmap for Paste `_ +* `Testing Applications With Paste `_ +* `URL Parsing with WSGI and Paste `_ + +Tutorials and Introduction +-------------------------- + +* `To-Do Tutorial `_ +* `What Is Paste? `_; older related documents: + + * `What is WSGIKit `_ + * `What can WSGIKit do for you? + `_ + * Ian Bicking presented at `PyCon 2005 `_ on + `WSGI Middleware and WSGIKit + `_: + *Using WSGI Middleware to build a foundation for Python web + programming* + +Developers +---------- + +* `Developer Guidelines `_ +* `Style Guide `_ 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 +`_; see that page for information on the lists. + +For live IRC discussion, try the ``#webware`` channel on `Freenode +`_. + +If you find bugs in the code or documentation, please `submit a ticket +`_. You can also `view tickets +`_. + + + 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 `_: + `Subscribe `__, + `Archives `__ + +To receive announcements: + +`paste-news@pythonpaste.org `_: + `Subscribe `__, + `Archives `__, + `Atom feed `_ + +To receive notification of new checkins: + +`paste-checkins@pythonpaste.org `_: + `Subscribe `__, + `RSS feed `_ + +Bug reports should be added to the tracker, but you can be notified of +new bugs on the list: + +`paste-bugs@pythonpaste.org `_: + `Subscribe `__, + `View bug reports `__, + `Submit bug report `_ + +More abstract discussion of Python web programming should go to: + +`web-sig@python.org `_: + `Subscribe `__, + `Archives `__ + 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 `_ +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 +`_. 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 +`_. 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 - `__, - `archives `__) - -Announcements: - paste-news@pythonpaste.org (`subscribe - `__, - `archives `__, - `atom feed `_) - -Checkins: - paste-checkins@pythonpaste.org (`subscribe - `__, - `rss feed `_) - -IRC: - ``#webware`` on `freenode `_ - -Bug reports: - Via `Trac `_: `view bug reports - `_, `submit bug - `_. Notification goes - to paste-bugs@pythonpaste.org (`subscribe - `__) - -More abstract discussion about Python web programming in general: - web-sig@python.org (`subscribe - `__, `archives - `__) - -Resources -========= - -* `Configuration `_. - -* `Integrating Frameworks Into Paste `_. - -* `Roadmap `_, a list of concrete goals and ideas. Not - much of a roadmap yet, as there's no fixed milestones. - -* `Paste Reference Document `_ - -* `Testing Applications with Paste `_, - 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 - `_, 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? - `_ and `What can - WSGIKit do for you? - `_) - -* 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/ - -- cgit v1.2.1