diff options
| author | Michael Merickel <michael@merickel.org> | 2019-12-27 17:58:41 -0600 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-12-27 17:58:41 -0600 |
| commit | ce48c934046f470f8c32ec98666f484f482f32f0 (patch) | |
| tree | 1ca5f20bf8307ccea2a8ec53ef09d6dcf1f1befd /docs | |
| parent | c71001eb97ad6fb1520411d15f7625a4897dd332 (diff) | |
| parent | 41ce5820b01c6e7d14654bb5fbd837611aad5853 (diff) | |
| download | pyramid-ce48c934046f470f8c32ec98666f484f482f32f0.tar.gz pyramid-ce48c934046f470f8c32ec98666f484f482f32f0.tar.bz2 pyramid-ce48c934046f470f8c32ec98666f484f482f32f0.zip | |
Merge pull request #3552 from stevepiercy/docs-cookiecutter-merge-scaffold
Expand cookiecutters doc to include more references, using the old sc…
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/cookiecutters.rst | 25 |
1 files changed, 22 insertions, 3 deletions
diff --git a/docs/narr/cookiecutters.rst b/docs/narr/cookiecutters.rst index 066d6c2e5..bb60c2226 100644 --- a/docs/narr/cookiecutters.rst +++ b/docs/narr/cookiecutters.rst @@ -1,3 +1,6 @@ +.. index:: + single: cookiecutter + .. _cookiecutters: Pyramid cookiecutters @@ -5,7 +8,13 @@ Pyramid cookiecutters A :term:`cookiecutter` is a command-line utility that creates projects from `cookiecutters <https://cookiecutter.readthedocs.io/en/latest/>`__ (project templates). -`pyramid-cookiecutter-starter <https://github.com/Pylons/pyramid-cookiecutter-starter>`_ +The Pylons Project supports one official Pyramid cookiecutter `pyramid-cookiecutter-starter <https://github.com/Pylons/pyramid-cookiecutter-starter>`_. + +Cookiecutters that use Pyramid can be found using a `search of the GitHub topic "cookiecutter-template" for "Pyramid" <https://github.com/topics/cookiecutter-template?q=pyramid&unscoped_q=pyramid>`_. + +You can extend Pyramid by creating a :term:`cookiecutter` project template. +This is useful if you would like to distribute a customizable configuration of Pyramid to other users. +Once you have created a cookiecutter, other people can use it to create a custom version of your Pyramid application. .. versionadded:: 1.8 Added cookiecutter support. @@ -17,6 +26,16 @@ A :term:`cookiecutter` is a command-line utility that creates projects from `coo ``pyramid-cookiecutter-alchemy`` and ``pyramid-cookiecutter-zodb`` are no longer supported. Use ``pyramid-cookiecutter-starter`` going forward. -.. seealso:: - See also `Cookiecutter Installation <https://cookiecutter.readthedocs.io/en/latest/installation.html>`_ and `Cookiecutter Features <https://cookiecutter.readthedocs.io/en/latest/readme.html#features>`_. Development of cookiecutters is documented under `Learn the Basics of Cookiecutter by Creating a Cookiecutter <https://cookiecutter.readthedocs.io/en/latest/first_steps.html>`_. +.. _cookiecutter-basics: + +Basics +------ + +See `Cookiecutter Installation <https://cookiecutter.readthedocs.io/en/latest/installation.html>`_ to get started. + +Then see the `README <https://github.com/Pylons/pyramid-cookiecutter-starter#pyramid-cookiecutter-starter>`_ of ``pyramid-cookiecutter-starter`` for its usage to generate a starter project. + +The ``pyramid-cookiecutter-starter`` on its ``master`` branch is a good starting point to develop your own cookiecutter. +Development of cookiecutters is documented under `Learn the Basics of Cookiecutter by Creating a Cookiecutter <https://cookiecutter.readthedocs.io/en/latest/first_steps.html>`_. +See `Cookiecutter Features <https://cookiecutter.readthedocs.io/en/latest/README.html#features>`_ for details of what is possible. |