Remove settings topic

This commit is contained in:
Roberto Rosario
2015-01-29 13:53:58 -04:00
parent 4cfd88f834
commit 38a6b4e250
3 changed files with 0 additions and 417 deletions

View File

@@ -58,11 +58,6 @@ Release notes
=============
:doc:`Release notes and upgrading instructions <releases/index>`
Customization and fine tunning
==============================
:doc:`Settings <topics/settings>`
For developers
==============

View File

@@ -19,7 +19,6 @@ Introductions to all the key parts of Mayan EDMS you'll need to know:
ocr
overview
permissions
settings
signatures
smart_links
tags

View File

@@ -1,411 +0,0 @@
========
Settings
========
**Mayan EDMS** has many configuration options that make it very adaptable to
different server configurations.
Documents
=========
.. setting:: DOCUMENTS_STORAGE_BACKEND
**DOCUMENTS_STORAGE_BACKEND**
Default: ``storages.backends.filebasedstorage.FileBasedStorage``
The full path to the storage backend class that will be used to store every document and document signatures.
.. setting:: DOCUMENTS_PREVIEW_SIZE
**DOCUMENTS_PREVIEW_SIZE**
Default: ``640x480``
Size of the document list and recent document list previews.
.. setting:: DOCUMENTS_PRINT_SIZE
**DOCUMENTS_PRINT_SIZE**
Default: ``1400``
.. setting:: DOCUMENTS_THUMBNAIL_SIZE
**DOCUMENTS_THUMBNAIL_SIZE**
Default: ``50x50``
.. setting:: DOCUMENTS_DISPLAY_SIZE
**DOCUMENTS_DISPLAY_SIZE**
Default: ``1200``
.. setting:: DOCUMENTS_RECENT_COUNT
**DOCUMENTS_RECENT_COUNT**
Default: ``40``
Maximum number of recent (created, edited, viewed) documents to
remember per user.
.. setting:: DOCUMENTS_ZOOM_PERCENT_STEP
**DOCUMENTS_ZOOM_PERCENT_STEP**
Default: ``50``
Amount in percent zoom in or out a document page per user interaction.
.. setting:: DOCUMENTS_ZOOM_MAX_LEVEL
**DOCUMENTS_ZOOM_MAX_LEVEL**
Default: ``200``
Maximum amount in percent (%) to allow user to zoom in a document page interactively.
.. setting:: DOCUMENTS_ZOOM_MIN_LEVEL
**DOCUMENTS_ZOOM_MIN_LEVEL**
Default: ``50``
Minimum amount in percent (%) to allow user to zoom out a document page interactively.
.. setting:: DOCUMENTS_ROTATION_STEP
**DOCUMENTS_ROTATION_STEP**
Default: ``90``
Amount in degrees to rotate a document page per user interaction.
.. setting:: DOCUMENTS_CACHE_PATH
**DOCUMENTS_CACHE_PATH**
Default: ``image_cache`` (inside the `media` folder)
The path where the visual representations of the documents are stored for fast display.
.. setting:: DOCUMENTS_LANGUAGE
**DOCUMENTS_LANGUAGE**
Default: ``eng``
Default language selection when creating a document.
Converter
=========
.. setting:: CONVERTER_GRAPHICS_BACKEND
**CONVERTER_GRAPHICS_BACKEND**
Default: ``converter.backends.python.Python``
Graphics conversion backend to use. Options are:
* ``converter.backends.imagemagick.ImageMagick`` - Wrapper for ImageMagick
* Use the :setting:`CONVERTER_IM_CONVERT_PATH` and :setting:`CONVERTER_IM_IDENTIFY_PATH` to specify the binary files locations.
* ``converter.backends.graphicsmagick.GraphicsMagick`` - Wrapper for GraphicsMagick
* Use the :setting:`CONVERTER_GM_PATH` and :setting:`CONVERTER_GM_SETTINGS` to specify the binary file location and customized settings.
* ``converter.backends.python.Python`` - Wrapper for Pillow_ and Ghostscript_
.. _Pillow: http://pypi.python.org/pypi/Pillow
.. _Ghostscript: http://www.ghostscript.com/
.. setting:: CONVERTER_IM_CONVERT_PATH
**CONVERTER_IM_CONVERT_PATH**
Default: ``/usr/bin/convert``
File path to imagemagick's convert program.
.. setting:: CONVERTER_IM_IDENTIFY_PATH
**CONVERTER_IM_IDENTIFY_PATH**
Default: ``/usr/bin/identify``
File path to imagemagick's identify program.
.. setting:: CONVERTER_GM_PATH
**CONVERTER_GM_PATH**
Default: ``/usr/bin/gm``
File path to graphicsmagick's program.
.. setting:: CONVERTER_GM_SETTINGS
**CONVERTER_GM_SETTINGS**
Default: None
Suggested options: ``-limit files 1 -limit memory 1GB -limit map 2GB -density 200``
Set of configuration options to pass to the GraphicsMagick executable to
fine tune it's functionality as explained in the `GraphicsMagick documentation`_
.. _GraphicsMagick documentation: http://www.graphicsmagick.org/convert.html#conv-opti
.. setting:: CONVERTER_LIBREOFFICE_PATH
**CONVERTER_LIBREOFFICE_PATH**
Default: ``/usr/bin/libreoffice``
Path to the libreoffice binary used to call LibreOffice for office document conversion.
**CONVERTER_PDFTOPPM_PATH**
Default: ``/usr/bin/pdftoppm``
Path to the Popple program pdftoppm.
Storage
=======
.. setting:: STORAGE_FILESTORAGE_LOCATION
**STORAGE_FILESTORAGE_LOCATION**
Default: ``document_storage``
Document indexing
=================
.. setting:: DOCUMENT_INDEXING_AVAILABLE_INDEXING_FUNCTIONS
**DOCUMENT_INDEXING_AVAILABLE_INDEXING_FUNCTIONS**
Default: ``proper_name``
.. setting:: DOCUMENT_INDEXING_SUFFIX_SEPARATOR
**DOCUMENT_INDEXING_SUFFIX_SEPARATOR**
Default: ``_`` (underscore)
.. setting:: DOCUMENT_INDEXING_FILESYSTEM_SLUGIFY_PATHS
**DOCUMENT_INDEXING_FILESYSTEM_SLUGIFY_PATHS**
Default: ``False``
.. setting:: DOCUMENT_INDEXING_FILESYSTEM_MAX_SUFFIX_COUNT
**DOCUMENT_INDEXING_FILESYSTEM_MAX_SUFFIX_COUNT**
Default: ``1000``
.. setting:: DOCUMENT_INDEXING_FILESYSTEM_SERVING
**DOCUMENT_INDEXING_FILESYSTEM_SERVING**
Default: ``{}``
A dictionary that maps the index name and where on the filesystem that index will be mirrored.
OCR
===
.. setting:: OCR_TESSERACT_PATH
**OCR_TESSERACT_PATH**
Default: ``/bin/tesseract``
File path to the ``tesseract`` executable, used to perform OCR on document
page's images.
.. setting:: OCR_UNPAPER_PATH
**OCR_UNPAPER_PATH**
Default: ``/usr/bin/unpaper``
File path to the ``unpaper`` executable, used to clean up images before
doing OCR.
.. setting:: OCR_PDFTOTEXT_PATH
**OCR_PDFTOTEXT_PATH**
Default: ``/usr/bin/pdftotext``
File path to ``poppler's`` ``pdftotext`` program used to extract text
from PDF files.
Metadata
========
.. setting:: METADATA_AVAILABLE_FUNCTIONS
**METADATA_AVAILABLE_FUNCTIONS**
Default: ``current_date``
.. setting:: METADATA_AVAILABLE_MODELS
**METADATA_AVAILABLE_MODELS**
Default: ``User``
Common
======
.. setting:: COMMON_TEMPORARY_DIRECTORY
**COMMON_TEMPORARY_DIRECTORY**
Default: ``/tmp``
Temporary directory used site wide to store thumbnails, previews
and temporary files. If none is specified, one will be created
using tempfile.mkdtemp()
.. setting:: COMMON_AUTO_CREATE_ADMIN
**COMMON_AUTO_CREATE_ADMIN**
Default: ``True``
Automatically creates an administrator superuser with the username
specified by COMMON_AUTO_ADMIN_USERNAME and with the default password
specified by COMMON_AUTO_ADMIN_PASSWORD
.. setting:: COMMON_AUTO_ADMIN_USERNAME
**COMMON_AUTO_ADMIN_USERNAME**
Default: ``admin``
Username of the automatically created superuser
.. setting:: COMMON_AUTO_ADMIN_PASSWORD
**COMMON_AUTO_ADMIN_PASSWORD**
Default: Random generated password
The password of the automatically created superuser
.. setting:: COMMON_LOGIN_METHOD
**COMMON_LOGIN_METHOD**
Default: ``username``
Controls the mechanism used to authenticated user. Options are: ``username``, ``email``
If using the ``email`` login method a proper email authentication backend must used
such as AUTHENTICATION_BACKENDS = ('common.auth.email_auth_backend.EmailAuthBackend',)
.. setting:: COMMON_ALLOW_ANONYMOUS_ACCESS
**COMMON_ALLOW_ANONYMOUS_ACCESS**
Default: ``False``
Allow non authenticated users, access to all views.
Search
======
.. setting:: SEARCH_LIMIT
**SEARCH_LIMIT**
Default: ``100``
Maximum amount search hits to fetch and display.
.. setting:: SEARCH_RECENT_COUNT
**SEARCH_RECENT_COUNT**
Default: ``5``
Maximum number of search queries to remember per user.
User management
===============
.. setting:: ROLES_DEFAULT_ROLES
**ROLES_DEFAULT_ROLES**
Default: ``[]``
A list of existing roles that are automatically assigned to newly created users
Signatures
==========
.. setting:: SIGNATURES_KEYSERVERS
**SIGNATURES_KEYSERVERS**
Default: ``['pool.sks-keyservers.net']``
List of keyservers to be queried for unknown keys.
.. setting:: SIGNATURES_GPG_HOME
**SIGNATURES_GPG_HOME**
Default: ``gpg_home``
Home directory used to store keys as well as configuration files.