cookiecutter-django/docs/project-generation-options.rst

133 lines
3.9 KiB
ReStructuredText
Raw Normal View History

Project Generation Options
==========================
2018-03-05 13:54:35 +03:00
project_name [My Awesome Project]:
Your project's human-readable name, capitals and spaces allowed.
2018-03-05 13:54:35 +03:00
project_slug [my_awesome_project]:
Your project's slug without dashes or spaces. Used to name your repo
and in other places where a Python-importable version of your project name
is needed.
2018-03-05 13:54:35 +03:00
description [Behold My Awesome Project!]
Describes your project and gets used in places like ``README.rst`` and such.
2018-03-05 13:54:35 +03:00
author_name [Daniel Roy Greenfeld]:
This is you! The value goes into places like ``LICENSE`` and such.
2018-03-05 13:54:35 +03:00
email [daniel-roy-greenfeld@example.com]:
The email address you want to identify yourself in the project.
domain_name [example.com]
The domain name you plan to use for your project once it goes live.
2018-03-05 13:54:35 +03:00
Note that it can be safely changed later on whenever you need to.
version [0.1.0]
2018-03-05 13:54:35 +03:00
The version of the project at its inception.
2018-03-05 13:54:35 +03:00
open_source_license [1]
A software license for the project. The choices are:
2018-03-05 13:54:35 +03:00
1. MIT_
2. BSD_
3. GPLv3_
4. `Apache Software License 2.0`_
5. Not open source
2018-03-05 13:54:35 +03:00
timezone [UTC]
The value to be used for the ``TIME_ZONE`` setting of the project.
2018-03-05 13:54:35 +03:00
windows [n]
Indicates whether the project should be configured for development on Windows.
use_pycharm [n]
2018-03-05 13:54:35 +03:00
Indicates whether the project should be configured for development with PyCharm_.
use_docker [y]
2018-03-05 13:54:35 +03:00
Indicates whether the project should be configured to use Docker_ and `Docker Compose`_.
2018-03-05 13:54:35 +03:00
postgresql_version [1]
Select a PostgreSQL_ version to use. The choices are:
2018-03-05 13:54:35 +03:00
1. 10.3
2. 10.2
3. 10.1
4. 9.6
5. 9.5
6. 9.4
7. 9.3
js_task_runner [1]
Select a JavaScript task runner. The choices are:
1. Gulp_
2. Grunt_
3. None
custom_bootstrap_compilation [n]
2018-03-05 13:54:35 +03:00
Indicates whether the project should support Bootstrap recompilation
via the selected JavaScript task runner's task. This can be useful
for real-time Bootstrap variable alteration.
2018-03-05 13:54:35 +03:00
use_compressor [n]
Indicates whether the project should be configured to use `Django Compressor`_.
2018-03-05 13:54:35 +03:00
use_celery [n]
Indicates whether the project should be configured to use Celery_.
use_mailhog [n]
Indicates whether the project should be configured to use MailHog_.
use_sentry_for_error_reporting [n]
Indicates whether the project should be configured to use Sentry_.
use_opbeat [n]
Indicates whether the project should be configured to use Opbeat_.
use_whitenoise [y]
Indicates whether the project should be configured to use WhiteNoise_.
use_heroku [n]
Indicates whether the project should be configured so as to be deployable
to Heroku_.
use_travisci [n]
2018-03-05 13:54:35 +03:00
Indicates whether the project should be configured to use `Travis CI`_.
keep_local_envs_in_vcs [y]
Indicates whether the project's ``.envs/.local/`` should be kept in VCS
(comes in handy when working in teams where local environment reproducibility
is strongly encouraged).
2018-03-05 13:54:35 +03:00
.. _MIT: https://opensource.org/licenses/MIT
.. _BSD: https://opensource.org/licenses/BSD-3-Clause
.. _GPLv3: https://www.gnu.org/licenses/gpl.html
.. _Apache Software License 2.0: http://www.apache.org/licenses/LICENSE-2.0
.. _PyCharm: https://www.jetbrains.com/pycharm/
.. _Docker: https://github.com/docker/docker
.. _Docker Compose: https://docs.docker.com/compose/
.. _PostgreSQL: https://www.postgresql.org/docs/
.. _Gulp: https://github.com/gulpjs/gulp
.. _Grunt: https://github.com/gruntjs/grunt
.. _Django Compressor: https://github.com/django-compressor/django-compressor
.. _Celery: https://github.com/celery/celery
2018-03-05 13:54:35 +03:00
2015-11-18 14:16:25 +03:00
.. _MailHog: https://github.com/mailhog/MailHog
2018-03-05 13:54:35 +03:00
.. _Sentry: https://github.com/getsentry/sentry
2018-03-05 13:54:35 +03:00
.. _Opbeat: https://github.com/opbeat/opbeat_python
2018-03-05 13:54:35 +03:00
.. _WhiteNoise: https://github.com/evansd/whitenoise
.. _Heroku: https://github.com/heroku/heroku-buildpack-python
2018-03-05 13:54:35 +03:00
.. _Travis CI: https://travis-ci.org/