Combine mimetype pages into one

Signed-off-by: Morris Jobke <hey@morrisjobke.de>
This commit is contained in:
Morris Jobke 2017-09-26 12:05:21 +02:00
parent 1c07587417
commit ea7aa8b63b
No known key found for this signature in database
GPG Key ID: FE03C3A163FEDE68
3 changed files with 59 additions and 66 deletions

View File

@ -2,12 +2,66 @@
Mimetypes Management
====================
Mimetype Aliases
----------------
.. toctree::
:maxdepth: 2
mimetype_aliases
mimetype_mapping
Nextcloud allows you to create aliases for mimetypes, so that you can display
custom icons for files. For example, you might want a nice audio icon for audio
files instead of the default file icon.
By default Nextcloud is distributed with
``nextcloud/resources/config/mimetypealiases.dist.json``.
Do not modify this file, as it will be replaced when Nextcloud is updated.
Instead, create your own ``nextcloud/config/mimetypealiases.json``
file with your custom aliases. Use the same syntax as in
``nextcloud/resources/config/mimetypealiases.dist.json``.
Once you have made changes to your ``mimetypealiases.json``, use the ``occ``
command to propagate the changes through the system. This example is for
Ubuntu Linux::
$ sudo -u www-data php occ maintenance:mimetype:update-js
See :doc:`../configuration_server/occ_command` to learn more about ``occ``.
Some common mimetypes that may be useful in creating aliases are:
image
Generic image
image/vector
Vector image
audio
Generic audio file
x-office/document
Word processed document
x-office/spreadsheet
Spreadsheet
x-office/presentation
Presentation
text
Generic text document
text/code
Source code
Mimetype mapping
----------------
Nextcloud allows administrators to specify the mapping of a file extension to a
mimetype. For example files ending in ``mp3`` map to ``audio/mpeg``. Which
then in turn allows Nextcloud to show the audio icon.
By default Nextcloud comes with ``mimetypemapping.dist.json``. This is a
simple json array.
Administrators should not update this file as it will get replaced on upgrades
of Nextcloud. Instead the file ``mimetypemapping.json`` should be created and
modified, this file has precedence over the shipped file.
Icon retrieval
--------------

View File

@ -1,48 +0,0 @@
================
Mimetype Aliases
================
Nextcloud allows you to create aliases for mimetypes, so that you can display
custom icons for files. For example, you might want a nice audio icon for audio
files instead of the default file icon.
By default Nextcloud is distributed with
``nextcloud/resources/config/mimetypealiases.dist.json``.
Do not modify this file, as it will be replaced when Nextcloud is updated.
Instead, create your own ``nextcloud/config/mimetypealiases.json``
file with your custom aliases. Use the same syntax as in
``nextcloud/resources/config/mimetypealiases.dist.json``.
Once you have made changes to your ``mimetypealiases.json``, use the ``occ``
command to propagate the changes through the system. This example is for
Ubuntu Linux::
$ sudo -u www-data php occ maintenance:mimetype:update-js
See :doc:`../configuration_server/occ_command` to learn more about ``occ``.
Some common mimetypes that may be useful in creating aliases are:
image
Generic image
image/vector
Vector image
audio
Generic audio file
x-office/document
Word processed document
x-office/spreadsheet
Spreadsheet
x-office/presentation
Presentation
text
Generic text document
text/code
Source code

View File

@ -1,13 +0,0 @@
Mimetype mapping
================
Nextcloud allows administrators to specify the mapping of a file extension to a
mimetype. For example files ending in ``mp3`` map to ``audio/mpeg``. Which
then in turn allows Nextcloud to show the audio icon.
By default Nextcloud comes with ``mimetypemapping.dist.json``. This is a
simple json array.
Administrators should not update this file as it will get replaced on upgrades
of Nextcloud. Instead the file ``mimetypemapping.json`` should be created and
modified, this file has precedence over the shipped file.