readthedocs.org/docs/settings.rst

70 lines
1.9 KiB
ReStructuredText
Raw Normal View History

Interesting Settings
====================
2014-01-09 01:49:59 +00:00
SLUMBER_USERNAME
----------------
Default: `test`
The username to use when connecting to the Read the Docs API. Used for hitting the API while building the docs.
SLUMBER_PASSWORD
----------------
Default: `test`
The password to use when connecting to the Read the Docs API. Used for hitting the API while building the docs.
2013-01-10 00:00:44 +00:00
USE_SUBDOMAIN
---------------
Default: `False`
Whether to use subdomains in URLs on the site, or the Django-served content.
2014-01-09 01:49:59 +00:00
When used in production, this should be ``True``, as Nginx will serve this content.
During development and other possible deployments, this might be ``False``.
PRODUCTION_DOMAIN
2012-10-28 06:29:50 +00:00
------------------
Default: `readthedocs.org`
This is the domain that gets linked to throughout the site when used in production.
2013-01-10 00:00:44 +00:00
It depends on `USE_SUBDOMAIN`, otherwise it isn't used.
MULTIPLE_APP_SERVERS
--------------------
Default: `undefined`
This is a list of application servers that built documentation is copied to. This allows you to run an independent build server, and then have it rsync your built documentation across multiple front end documentation/app servers.
2012-10-21 07:40:16 +00:00
2014-08-31 00:02:36 +00:00
DEFAULT_PRIVACY_LEVEL
---------------------
Default: `public`
What privacy projects default to having. Generally set to `public`. Also acts as a proxy setting for blocking certain historically insecure options, like serving generated artifacts directly from the media server.
INDEX_ONLY_LATEST
-----------------
2012-11-23 23:32:07 +00:00
Default: `False`
In search, only index the `latest` version of a Project.
2012-11-23 23:32:07 +00:00
DOCUMENT_PYQUERY_PATH
---------------------
Default: `div.document`
The Pyquery path to an HTML element that is the root of your document.
This is used for making sure we are only searching the main content of a document.
USE_PIP_INSTALL
---------------
Default: `False`
Whether to use `pip install .` or `python setup.py install` when installing packages into the Virtualenv. Default is to use `python setup.py install`.