From b1b92284f496800a4dfd2cea72cb9be07ba8661c Mon Sep 17 00:00:00 2001
From: Paul Everitt <paul@agendaless.com>
Date: Fri, 13 Sep 2013 16:52:14 -0400
Subject: First cut at import of quick tutorial.

---
 docs/quick_tutorial/scaffolds.rst | 84 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 docs/quick_tutorial/scaffolds.rst

(limited to 'docs/quick_tutorial/scaffolds.rst')

diff --git a/docs/quick_tutorial/scaffolds.rst b/docs/quick_tutorial/scaffolds.rst
new file mode 100644
index 000000000..cbd198414
--- /dev/null
+++ b/docs/quick_tutorial/scaffolds.rst
@@ -0,0 +1,84 @@
+=============================================
+Prelude: Quick Project Startup with Scaffolds
+=============================================
+
+To ease the process of getting started, Pyramid provides *scaffolds*
+that generate sample projects from templates in Pyramid and Pyramid
+add-ons.
+
+Background
+==========
+
+We're going to cover a lot in this tutorial, focusing on one topic at a
+time and writing everything from scratch. As a warmup, though,
+it sure would be nice to see some pixels on a screen.
+
+Like other web development frameworks, Pyramid provides a number of
+"scaffolds" that generate working Python, template, and CSS code for
+sample applications. In this step we'll use a built-in scaffold to let
+us preview a Pyramid application, before starting from scratch on Step 1.
+
+Objectives
+==========
+
+- Use Pyramid's ``pcreate`` command to list scaffolds and make a new
+  project
+
+- Start up a Pyramid application and visit it in a web browser
+
+Steps
+=====
+
+#. Pyramid's ``pcreate`` command can list the available scaffolds:
+
+    .. code-block:: bash
+
+        (env27)$ pcreate --list
+        Available scaffolds:
+          alchemy:                 Pyramid SQLAlchemy project using url dispatch
+          starter:                 Pyramid starter project
+          zodb:                    Pyramid ZODB project using traversal
+
+#. Tell ``pcreate`` to use the ``starter`` scaffold to make our project:
+
+    .. code-block:: bash
+
+        (env27)$ pcreate --scaffold starter scaffolds
+
+#. Use normal Python development to setup our project for development:
+
+    .. code-block:: bash
+
+        (env27)$ cd scaffolds
+        (env27)$ python setup.py develop
+
+#. Startup the application by pointing Pyramid's ``pserve`` command at
+   the project's (generated) configuration file:
+
+    .. code-block:: bash
+
+        (env27)$ pserve development.ini --reload
+
+   On startup, ``pserve`` logs some output:
+
+   .. code-block:: bash
+
+     Starting subprocess with file monitor
+     Starting server in PID 72213.
+     Starting HTTP server on http://0.0.0.0:6543
+
+#. Open ``http://localhost:6543/`` in your browser.
+
+Analysis
+========
+
+Rather than starting from scratch, ``pcreate`` can make getting a
+Python project containing a Pyramid application a quick matter.
+Pyramid ships with a few scaffolds. But installing a Pyramid add-on can
+give you new scaffolds from that add-on.
+
+``pserve`` is Pyramid's application runner, separating operational
+details from your code. When you install Pyramid, a small command
+program called ``pserve`` is written to your ``bin`` directory. This
+program is an executable Python module. It is passed a configuration
+file (in this case, ``development.ini``.)
-- 
cgit v1.2.3