The Pyramid Web Framework
Here is one of the simplest :app:`Pyramid` applications you can make:
.. literalinclude:: narr/helloworld.py
After you install :app:`Pyramid` and run this application, when you visit
http://localhost:8080/hello/world in a browser, you will see the text
Hello, world! See :ref:`firstapp_chapter` for a full explanation of how
this application works.
If you are new to Pyramid, we have a few resources that can help you get up to speed right away.
.. toctree:: :hidden: quick_tour quick_tutorial/index
- :doc:`quick_tour` gives an overview of the major features in Pyramid, covering a little about a lot.
- Like learning by example? Visit the official :ref:`html_tutorials` as well as the community-contributed :ref:`Pyramid Tutorials <tutorials:pyramid-tutorials>` and :ref:`Pyramid Community Cookbook <cookbook:pyramid-cookbook>`.
- For help getting Pyramid set up, try :ref:`installing_chapter`.
- Need help? See :ref:`Support and Development <support-and-development>`.
Official tutorials provide a quick overview of :app:`Pyramid`'s features in more depth than the Quick Tour and with working code, explain how to use :app:`Pyramid` to build various types of applications, and how to deploy :app:`Pyramid` applications to various platforms.
.. toctree:: :maxdepth: 1 quick_tutorial/index tutorials/wiki2/index tutorials/wiki/index tutorials/modwsgi/index
Support and Development
To report bugs, use the issue tracker.
# If you have SSH keys configured on GitHub: git clone email@example.com:Pylons/pyramid.git # Otherwise, HTTPS will work, using your GitHub login: git clone https://github.com/Pylons/pyramid.git
Narrative documentation in chapter form explaining how to use :app:`Pyramid`.
.. toctree:: :maxdepth: 2 narr/introduction narr/install narr/firstapp narr/configuration narr/project narr/startup narr/router narr/urldispatch narr/views narr/renderers narr/templates narr/viewconfig narr/assets narr/webob narr/sessions narr/events narr/environment narr/logging narr/paste narr/commandline narr/i18n narr/vhosting narr/testing narr/resources narr/hellotraversal narr/muchadoabouttraversal narr/traversal narr/security narr/hybrid narr/subrequest narr/hooks narr/introspector narr/extending narr/advconfig narr/extconfig narr/cookiecutters narr/scaffolding narr/upgrading narr/threadlocals narr/zca
Comprehensive reference material for every public API exposed by :app:`Pyramid`:
.. toctree:: :maxdepth: 1 :glob: api/index api/*
p* Scripts Documentation
p* scripts included with :app:`Pyramid`.
.. toctree:: :maxdepth: 1 :glob: pscripts/index pscripts/*
.. toctree:: :maxdepth: 1 whatsnew-1.9 whatsnew-1.8 whatsnew-1.7 whatsnew-1.6 whatsnew-1.5 whatsnew-1.4 whatsnew-1.3 whatsnew-1.2 whatsnew-1.1 whatsnew-1.0 changes
.. toctree:: :maxdepth: 1 designdefense
Copyright, Trademarks, and Attributions
.. toctree:: :maxdepth: 1 copyright
Typographical Conventions and Style Guide
.. toctree:: :maxdepth: 1 typographical-conventions
Index and Glossary
.. toctree:: :hidden: glossary