<commit_before>.. _ref-customization:

Customization
=============

As more sites are built using Pinax, more best practices will emerge, but for
now what we recommend is:

- Choose which :ref:`project <ref-project>` you would like to use as a starting 
  point.
- Copy that project into a directory outside of the subversion checkout.
- Make necessary changes to the ``settings.py`` and ``urls.py`` files in your
  copied directory.
- Ensure ``PINAX_ROOT`` is setup correctly in your settings. It should point
  to where Pinax lives on your filesystem.
- Change the domain and display name of the Site in the admin interface. 
- Develop your custom apps under your new project or anywhere on Python path.
- Develop your own templates under your new project.

.. _ref-project:


Choosing a Project
------------------

By default, Pinax provides two projects to use as a starting point for 
customization.  Depending on your development style, you may prefer one project 
over the other.

basic_project
    This project comes with the bare minimum set of applications and templates
    to get you started.  It includes no extra tabs--only the profile and notices 
    tabs are included by default. From here you can add any extra functionality 
    and applications that you would like.

complete_project
    This project comes fully-featured, with everything that Pinax provides
    enabled by default.  It provides all tabs available, etc.  From here you can
    remove applications that you do not want to use, and add your own 
    applications as well.


Settings You Will (Probably) Want To Override
---------------------------------------------

- ``PINAX_ROOT``
- ``DEBUG``
- ``TEMPLATE_DEBUG``
- ``LOGGING_OUTPUT_ENABLED``
- ``ADMINS``
- ``MANAGERS``
- ``DATABASE_ENGINE``
- ``DATABASE_NAME``
- ``DATABASE_USER``
- ``DATABASE_PASSWORD``
- ``DATABASE_HOST``
- ``DATABASE_PORT``<commit_msg>Yet another empty dir squashed, yaaay<commit_after>.. _ref-customization:

Customization
=============

As more sites are built using Pinax, more best practices will emerge, but for
now what we recommend is:

- Choose which :ref:`project <ref-project>` you would like to use as a starting 
  point.
- Copy that project into a directory outside of the subversion checkout.
- Make necessary changes to the ``settings.py`` and ``urls.py`` files in your
  copied directory.
- Ensure ``PINAX_ROOT`` is setup correctly in your settings. It should point
  to where Pinax lives on your filesystem.
- Change the domain and display name of the Site in the admin interface. 
- Develop your custom apps under your new project or anywhere on Python path.
- Develop your own templates under your new project.

.. _ref-project:


Choosing a Project
------------------

By default, Pinax provides two projects to use as a starting point for 
customization.  Depending on your development style, you may prefer one project 
over the other.

basic_project
    This project comes with the bare minimum set of applications and templates
    to get you started.  It includes no extra tabs--only the profile and notices 
    tabs are included by default. From here you can add any extra functionality 
    and applications that you would like.

complete_project
    This project comes fully-featured, with everything that Pinax provides
    enabled by default.  It provides all tabs available, etc.  From here you can
    remove applications that you do not want to use, and add your own 
    applications as well.


Settings You Will (Probably) Want To Override
---------------------------------------------

- ``PINAX_ROOT``
- ``PINAX_THEME``
- ``DEBUG``
- ``TEMPLATE_DEBUG``
- ``LOGGING_OUTPUT_ENABLED``
- ``ADMINS``
- ``MANAGERS``
- ``DATABASE_ENGINE``
- ``DATABASE_NAME``
- ``DATABASE_USER``
- ``DATABASE_PASSWORD``
- ``DATABASE_HOST``
- ``DATABASE_PORT``
{'fraction_non_alphanumeric': 0.107981220657277, 'fraction_numerical': 0.0, 'mean_word_length': 3.3333333333333335, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1964834', 'n_tokens_mistral': 1032, 'n_tokens_neox': 1010, 'n_words': 495}