| commit | author | age | ||
| 9974be | 1 | .. _index: |
| f70c23 | 2 | |
| a66e00 | 3 | ========================= |
| 83fefb | 4 | The Pyramid Web Framework |
| a66e00 | 5 | ========================= |
| f70c23 | 6 | |
| 8bb97b | 7 | :app:`Pyramid` is a small, fast, down-to-earth Python web framework. It is |
| 4216e1 | 8 | developed as part of the `Pylons Project <https://pylonsproject.org//>`_. |
| 8bb97b | 9 | It is licensed under a `BSD-like license <http://repoze.org/license.html>`_. |
| a3a27a | 10 | |
| d4bbb6 | 11 | Here is one of the simplest :app:`Pyramid` applications you can make: |
| d36b56 | 12 | |
| a98c01 | 13 | .. literalinclude:: narr/helloworld.py |
| d36b56 | 14 | |
| db9468 | 15 | After you install :app:`Pyramid` and run this application, when you visit |
| e241c7 | 16 | `<http://localhost:8080/hello/world>`_ in a browser, you will see the text |
| 8bb97b | 17 | ``Hello, world!`` See :ref:`firstapp_chapter` for a full explanation of how |
| SP | 18 | this application works. |
| e17da6 | 19 | |
| 0797f0 | 20 | |
| 933773 | 21 | .. _getting_started: |
| 47eaa1 | 22 | |
| PE | 23 | Getting Started |
| 24 | =============== | |
| 25 | ||
| 8bb97b | 26 | If you are new to Pyramid, we have a few resources that can help you get up to |
| SP | 27 | speed right away. |
| 71b83e | 28 | |
| 47eaa1 | 29 | .. toctree:: |
| 5b47ba | 30 | :hidden: |
| 47eaa1 | 31 | |
| ae9014 | 32 | quick_tour |
| b1b922 | 33 | quick_tutorial/index |
| ae9014 | 34 | |
| 8bb97b | 35 | * :doc:`quick_tour` gives an overview of the major features in Pyramid, |
| SP | 36 | covering a little about a lot. |
| ae9014 | 37 | |
| 8bb97b | 38 | * :doc:`quick_tutorial/index` is similar to the Quick Tour, but in a tutorial |
| SP | 39 | format, with somewhat deeper treatment of each topic and with working code. |
| b1b922 | 40 | |
| 8bb97b | 41 | * Like learning by example? Visit the official :ref:`html_tutorials` as well as |
| 8a80b1 | 42 | the community-contributed :ref:`Pyramid Tutorials |
| 34515f | 43 | <tutorials:pyramid-tutorials>` and :ref:`Pyramid Community Cookbook |
| 8a80b1 | 44 | <cookbook:pyramid-cookbook>`. |
| ae9014 | 45 | |
| 8bb97b | 46 | * For help getting Pyramid set up, try :ref:`installing_chapter`. |
| ae9014 | 47 | |
| 8bb97b | 48 | * Need help? See :ref:`Support and Development <support-and-development>`. |
| ae9014 | 49 | |
| 8bb97b | 50 | |
| SP | 51 | .. _html_tutorials: |
| 52 | ||
| 53 | Tutorials | |
| 54 | ========= | |
| 55 | ||
| 56 | Official tutorials explaining how to use :app:`Pyramid` to build various types | |
| 57 | of applications, and how to deploy :app:`Pyramid` applications to various | |
| 58 | platforms. | |
| 59 | ||
| 60 | .. toctree:: | |
| 61 | :maxdepth: 1 | |
| 62 | ||
| 933773 | 63 | tutorials/wiki2/index |
| SP | 64 | tutorials/wiki/index |
| 65 | tutorials/modwsgi/index | |
| 8bb97b | 66 | |
| SP | 67 | |
| 68 | .. _support-and-development: | |
| 69 | ||
| 70 | Support and Development | |
| 71 | ======================= | |
| 72 | ||
| 88030f | 73 | The `Pyramid website <https://trypyramid.com/resources.html>`_ is the main |
| dcb5d6 | 74 | entry point to :app:`Pyramid` web framework resources for support and |
| SP | 75 | development information. |
| 8bb97b | 76 | |
| SP | 77 | To report bugs, use the `issue tracker |
| 78 | <https://github.com/Pylons/pyramid/issues>`_. | |
| 79 | ||
| 80 | If you've got questions that aren't answered by this documentation, contact the | |
| 1cb30e | 81 | `Pylons-discuss maillist |
| SP | 82 | <https://groups.google.com/forum/#!forum/pylons-discuss>`_ or join the |
| 83 | `#pyramid IRC channel | |
| a1aa71 | 84 | <https://webchat.freenode.net/?channels=pyramid>`_. |
| 8bb97b | 85 | |
| SP | 86 | Browse and check out tagged and trunk versions of :app:`Pyramid` via the |
| 87 | `Pyramid GitHub repository <https://github.com/Pylons/pyramid/>`_. To check out | |
| 28bfdf | 88 | the trunk via ``git``, use either command: |
| 8bb97b | 89 | |
| SP | 90 | .. code-block:: text |
| 91 | ||
| 28bfdf | 92 | # If you have SSH keys configured on GitHub: |
| 8bb97b | 93 | git clone git@github.com:Pylons/pyramid.git |
| 28bfdf | 94 | |
| SP | 95 | # Otherwise, HTTPS will work, using your GitHub login: |
| 96 | git clone https://github.com/Pylons/pyramid.git | |
| 8bb97b | 97 | |
| SP | 98 | To find out how to become a contributor to :app:`Pyramid`, please see the |
| 99 | `contributor's section of the documentation | |
| 100 | <http://docs.pylonsproject.org/en/latest/#contributing>`_. | |
| ae9014 | 101 | |
| 47eaa1 | 102 | |
| 55860e | 103 | .. _html_narrative_documentation: |
| d36b56 | 104 | |
| a70d54 | 105 | Narrative Documentation |
| e99f7a | 106 | ======================= |
| 9e3bdb | 107 | |
| 8bb97b | 108 | Narrative documentation in chapter form explaining how to use :app:`Pyramid`. |
| f70c23 | 109 | |
| CM | 110 | .. toctree:: |
| 9e3bdb | 111 | :maxdepth: 2 |
| f70c23 | 112 | |
| 9e3bdb | 113 | narr/introduction |
| 102d19 | 114 | narr/install |
| 9ec2d6 | 115 | narr/firstapp |
| e17da6 | 116 | narr/configuration |
| 54f2bb | 117 | narr/project |
| c6e58b | 118 | narr/startup |
| c4503b | 119 | narr/router |
| c5f24b | 120 | narr/urldispatch |
| d6798e | 121 | narr/views |
| a59c78 | 122 | narr/renderers |
| 8271f7 | 123 | narr/templates |
| 8a1b50 | 124 | narr/viewconfig |
| 88b9ee | 125 | narr/assets |
| 888d65 | 126 | narr/webob |
| 04ebd5 | 127 | narr/sessions |
| e17c8d | 128 | narr/events |
| 47b4d3 | 129 | narr/environment |
| 1ae7af | 130 | narr/logging |
| 3d338e | 131 | narr/paste |
| ae4c57 | 132 | narr/commandline |
| 8cb682 | 133 | narr/i18n |
| CM | 134 | narr/vhosting |
| 6ee49a | 135 | narr/testing |
| 8cb682 | 136 | narr/resources |
| 97b64d | 137 | narr/hellotraversal |
| 8cb682 | 138 | narr/muchadoabouttraversal |
| CM | 139 | narr/traversal |
| 140 | narr/security | |
| 141 | narr/hybrid | |
| 37d2c2 | 142 | narr/subrequest |
| c8cf22 | 143 | narr/hooks |
| 9d97b6 | 144 | narr/introspector |
| e6855b | 145 | narr/extending |
| c4503b | 146 | narr/advconfig |
| CM | 147 | narr/extconfig |
| 6261ae | 148 | narr/cookiecutters |
| bfd4b3 | 149 | narr/scaffolding |
| b72ba1 | 150 | narr/upgrading |
| 538344 | 151 | narr/threadlocals |
| 37bcb7 | 152 | narr/zca |
| 8fd58c | 153 | |
| e2c34f | 154 | |
| aebd2f | 155 | API Documentation |
| a70d54 | 156 | ================= |
| 04bee5 | 157 | |
| 8bb97b | 158 | Comprehensive reference material for every public API exposed by |
| SP | 159 | :app:`Pyramid`: |
| 04bee5 | 160 | |
| CM | 161 | .. toctree:: |
| 9279d7 | 162 | :maxdepth: 1 |
| TL | 163 | :glob: |
| 04bee5 | 164 | |
| cac212 | 165 | api/index |
| 9279d7 | 166 | api/* |
| 8bb97b | 167 | |
| 04bee5 | 168 | |
| 5ff3d2 | 169 | ``p*`` Scripts Documentation |
| SP | 170 | ============================ |
| 171 | ||
| 3a3250 | 172 | ``p*`` scripts included with :app:`Pyramid`. |
| 5ff3d2 | 173 | |
| SP | 174 | .. toctree:: |
| 175 | :maxdepth: 1 | |
| 176 | :glob: | |
| 177 | ||
| 178 | pscripts/index | |
| 179 | pscripts/* | |
| 180 | ||
| 181 | ||
| aebd2f | 182 | Change History |
| CM | 183 | ============== |
| 9d68f9 | 184 | |
| CM | 185 | .. toctree:: |
| 841dcf | 186 | :maxdepth: 1 |
| 9d68f9 | 187 | |
| 2b9b6c | 188 | whatsnew-1.9 |
| 9edad5 | 189 | whatsnew-1.8 |
| 311482 | 190 | whatsnew-1.7 |
| bfe000 | 191 | whatsnew-1.6 |
| a66e00 | 192 | whatsnew-1.5 |
| 49d634 | 193 | whatsnew-1.4 |
| PE | 194 | whatsnew-1.3 |
| 195 | whatsnew-1.2 | |
| 196 | whatsnew-1.1 | |
| 197 | whatsnew-1.0 | |
| 9d68f9 | 198 | changes |
| CM | 199 | |
| 8bb97b | 200 | |
| aebd2f | 201 | Design Documents |
| CM | 202 | ================ |
| fbfea7 | 203 | |
| CM | 204 | .. toctree:: |
| 6b0315 | 205 | :maxdepth: 1 |
| fbfea7 | 206 | |
| CM | 207 | designdefense |
| a864bd | 208 | |
| 71b83e | 209 | |
| 8bb97b | 210 | Copyright, Trademarks, and Attributions |
| SP | 211 | ======================================= |
| 0797f0 | 212 | |
| 8bb97b | 213 | .. toctree:: |
| SP | 214 | :maxdepth: 1 |
| 1dad96 | 215 | |
| 8bb97b | 216 | copyright |
| 0797f0 | 217 | |
| CM | 218 | |
| b99ada | 219 | Typographical Conventions and Style Guide |
| SP | 220 | ========================================= |
| 8c8697 | 221 | |
| 8bb97b | 222 | .. toctree:: |
| SP | 223 | :maxdepth: 1 |
| 0797f0 | 224 | |
| b99ada | 225 | typographical-conventions |
| 0797f0 | 226 | |
| CM | 227 | |
| 878328 | 228 | Index and Glossary |
| f70c23 | 229 | ================== |
| CM | 230 | |
| 1b8f7a | 231 | * :ref:`glossary` |
| 878328 | 232 | * :ref:`genindex` |
| CM | 233 | * :ref:`search` |
| 012b97 | 234 | |
| M | 235 | |
| 236 | .. toctree:: | |
| 237 | :hidden: | |
| 238 | ||
| 239 | glossary | |
| 240 | ||
