Remove unoconv and it's configuration options from the documentation
This commit is contained in:
@@ -77,26 +77,6 @@ Document sharing
|
|||||||
Document handling
|
Document handling
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
**How to store documents outside of **Mayan EDMS's** path**
|
|
||||||
|
|
||||||
* Sub class Django's ``FileSystemStorage`` class:
|
|
||||||
|
|
||||||
- Create a file called ``customstorage.py``::
|
|
||||||
|
|
||||||
from django.core.files.storage import FileSystemStorage
|
|
||||||
|
|
||||||
class CustomStorage(FileSystemStorage):
|
|
||||||
def __init__(self, *args, **kwargs):
|
|
||||||
super(CustomStorage, self).__init__(*args, **kwargs)
|
|
||||||
self.location='/new/path/to/documents/'
|
|
||||||
self.base_url='document_storage'
|
|
||||||
|
|
||||||
- In the ``settings.py`` add::
|
|
||||||
|
|
||||||
from customstorage import CustomStorage
|
|
||||||
DOCUMENTS_STORAGE_BACKEND = CustomStorage
|
|
||||||
|
|
||||||
|
|
||||||
**Q: How to enable the ``GridFS`` storage backend**
|
**Q: How to enable the ``GridFS`` storage backend**
|
||||||
|
|
||||||
* Solution:
|
* Solution:
|
||||||
@@ -148,23 +128,6 @@ Webserver
|
|||||||
XSendFileAllowAbove on
|
XSendFileAllowAbove on
|
||||||
|
|
||||||
|
|
||||||
OCR
|
|
||||||
---
|
|
||||||
|
|
||||||
**Q: The included version of ``unoconv`` in my distribution is too old**
|
|
||||||
|
|
||||||
* Only the file 'unoconv' file from https://github.com/dagwieers/unoconv is needed.
|
|
||||||
Put it in a user designated directory for binaries such as /usr/local/bin and
|
|
||||||
setup Mayan's configuration option in your settings_local.py file like this::
|
|
||||||
|
|
||||||
CONVERTER_UNOCONV_PATH = '/usr/local/bin/unoconv'
|
|
||||||
|
|
||||||
If you already have office or text documents uploaded into **Mayan EDMS**,
|
|
||||||
after setting up and testing ``unoconv`` by hand, go to 'Tools',
|
|
||||||
'Maintenance', 'Update office documents' page count', this will force a
|
|
||||||
re-detection and re-processing of any document found to be of office format.
|
|
||||||
|
|
||||||
|
|
||||||
Deployments
|
Deployments
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
|
|||||||
@@ -27,17 +27,11 @@ temporary files and other black magic needs to be invoked to get it
|
|||||||
properly integrated. **Mayan EDMS** treats documents as collections of pages
|
properly integrated. **Mayan EDMS** treats documents as collections of pages
|
||||||
or frames, and text extraction and OCR is done per page not per document,
|
or frames, and text extraction and OCR is done per page not per document,
|
||||||
thats why even text documents need to be rendered by LibreOffice_
|
thats why even text documents need to be rendered by LibreOffice_
|
||||||
before they can be previewed and text can be extracted.
|
before they can be previewed and text can be extracted. Just one
|
||||||
|
configuration option controls this conversion: :setting:`CONVERTER_LIBREOFFICE_PATH`
|
||||||
Version 0.12.1 introduced a new method of converting office documents, this
|
|
||||||
new method doesn't require the use of the command line utility ``UNOCONV``.
|
|
||||||
If this new method proves to continue working better than previous solutions the use
|
|
||||||
of ``UNOCONV`` may be deprecated in the future. The new conversion method
|
|
||||||
adds just one new configuration option: :setting:`CONVERTER_LIBREOFFICE_PATH`
|
|
||||||
which defaults to '/usr/bin/libreoffice'.
|
which defaults to '/usr/bin/libreoffice'.
|
||||||
|
|
||||||
|
|
||||||
.. _PDF: http://en.wikipedia.org/wiki/Portable_Document_Format
|
.. _PDF: http://en.wikipedia.org/wiki/Portable_Document_Format
|
||||||
.. _LibreOffice: http://www.libreoffice.org/
|
.. _LibreOffice: http://www.libreoffice.org/
|
||||||
.. _unoconv: https://github.com/dagwieers/unoconv/
|
|
||||||
.. _supervisor: http://supervisord.org/introduction.html
|
.. _supervisor: http://supervisord.org/introduction.html
|
||||||
|
|||||||
@@ -192,26 +192,6 @@ fine tune it's functionality as explained in the `GraphicsMagick documentation`_
|
|||||||
|
|
||||||
.. _GraphicsMagick documentation: http://www.graphicsmagick.org/convert.html#conv-opti
|
.. _GraphicsMagick documentation: http://www.graphicsmagick.org/convert.html#conv-opti
|
||||||
|
|
||||||
|
|
||||||
.. setting:: CONVERTER_UNOCONV_PATH
|
|
||||||
|
|
||||||
|
|
||||||
**CONVERTER_UNOCONV_PATH**
|
|
||||||
|
|
||||||
Default: ``/usr/bin/unoconv``
|
|
||||||
|
|
||||||
Path to the unoconv program used to call LibreOffice for office document conversion.
|
|
||||||
|
|
||||||
|
|
||||||
.. setting:: CONVERTER_UNOCONV_USE_PIPE
|
|
||||||
|
|
||||||
|
|
||||||
**CONVERTER_UNOCONV_USE_PIPE**
|
|
||||||
|
|
||||||
Default: ``True``
|
|
||||||
|
|
||||||
Use alternate method of connection to LibreOffice using a pipe, it is slower but less prone to segmentation faults.
|
|
||||||
|
|
||||||
|
|
||||||
.. setting:: CONVERTER_LIBREOFFICE_PATH
|
.. setting:: CONVERTER_LIBREOFFICE_PATH
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user