Skip to content

Commit 3416597

Browse files
chore: drop ext. sto. file enc. from troubleshooting chapter (moved)
Signed-off-by: Josh <[email protected]>
1 parent ed8ef90 commit 3416597

File tree

1 file changed

+0
-27
lines changed

1 file changed

+0
-27
lines changed

admin_manual/issues/general_troubleshooting.rst

Lines changed: 0 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -341,33 +341,6 @@ Users' Federated Cloud IDs not updated after a domain name change
341341
| ``occ dav:sync-system-addressbook``
342342
| ``occ federation:sync-addressbooks``
343343
344-
.. _trouble-file-encoding-ext-storages:
345-
346-
Troubleshooting file encoding on external storages
347-
--------------------------------------------------
348-
349-
When using external storage, it can happen that some files with special characters will not
350-
appear in the file listing, or they will appear and not be accessible.
351-
352-
When this happens, please run the :ref:`files scanner<occ_files_scan_label>`, for example with::
353-
354-
sudo -E -u www-data php occ files:scan --all
355-
356-
If the scanner tells about an encoding issue on the affected file, please enable Mac encoding compatibility in the :ref:`mount options<external_storage_mount_options_label>`
357-
and then :ref:`rescan the external storage<occ_files_scan_label>`.
358-
359-
.. note::
360-
This mode comes with a performance impact because Nextcloud will always try both encodings when detecting files
361-
on external storages.
362-
363-
Mac computers are using the NFD Unicode Normalization for file names which is different than NFC, the one used
364-
by other operating systems. Mac users might upload files directly to the external storage using NFD normalized
365-
file names. When uploading through Nextcloud, file names will always be normalized to the NFC standard for consistency.
366-
367-
It is recommended to let Nextcloud use external storages exclusively to avoid such issues.
368-
369-
See also `technical explanation about NFC vs NFD normalizations <https://www.win.tue.nl/~aeb/linux/uc/nfc_vs_nfd.html>`_.
370-
371344
Troubleshooting contacts & calendar
372345
-----------------------------------
373346

0 commit comments

Comments
 (0)