summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIan Bicking <ian@ianbicking.org>2005-07-16 21:02:03 +0000
committerIan Bicking <ian@ianbicking.org>2005-07-16 21:02:03 +0000
commit01afc0192a69c38e33c378121abceb6bc8f39d2a (patch)
treed813009ea9c75ca34d7ad96cc4b6b6aa3c527e23
parentbec73972570bb4fdde2d42cc92e81cf839a551e6 (diff)
downloadpaste-git-01afc0192a69c38e33c378121abceb6bc8f39d2a.tar.gz
Added new pages to fill out site nav
-rw-r--r--docs/doc.conf2
-rw-r--r--docs/index.txt34
-rwxr-xr-xdocs/rebuild8
-rw-r--r--docs/web/community/index.txt15
-rw-r--r--docs/web/community/mailing-list.txt36
-rw-r--r--docs/web/community/repository.txt13
-rw-r--r--docs/web/download/index.txt5
-rw-r--r--docs/web/index.txt77
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/
-