.. _settings:

=================
Birdland Settings
=================


Here is a list of available Birdland settings, their uses and their defaults.

BIRDLAND_BACKLINKS_ENABLED
==========================

Default: ``True`` if `django-backlinks`_ is available and in ``INSTALLED_APPS``

A Boolean value denoting whether or not to add a ``backlinks_enabled`` field
to the ``Entry`` model.


BIRDLAND_BLOG_NAME
==================

Default: The current site name according to the Sites_ app. (string)

A string used to generate titles in the default feeds configuration.


BIRDLAND_DEFAULT_MARKUP_LANG
============================

Default: ``'rawhtml'``

A string identifier denoting the default markup language to use for ``Entry``
body text and summary text.


BIRDLAND_EXTRA_MARKUP_LANGS
===========================

Default: ``[]`` (empty)

An iterable of 3-tuples used to extend the markup language choices for post
fields. These tuples are of the form:

    (normalized name, display name, markup processor callback path)


BIRDLAND_NUM_ENTRIES_IN_FEEDS
=============================

Default: ``20`` (int)

The number of posts to include in the default feeds.


BIRDLAND_PAGINATE_BY
====================

Default: ``20`` (int)

The number of posts per page in the default list view url patterns.


BIRDLAND_TAGGING_ENABLED
========================

Default: ``True`` if `django-tagging`_ is installed and found in ``INSTALLED_APPS``

A Boolean value denoting whether or not to enable the tagging model field, views,
and feeds.


.. _django-backlinks: http://bitbucket.org/jeffkistler/django-backlinks/
.. _Sites: http://docs.djangoproject.com/en/dev/ref/contrib/sites/#ref-contrib-sites
.. _django-tagging: http://code.google.com/p/django-tagging/
