Merge pull request #12557 from nextcloud/bugfix/stable31

blizzz · web-flow · commit 5412d5a5b268 · 2025-01-31T16:03:50.000+01:00
fix: Adjust links to stay on the same Nextcloud version of the docs
diff --git a/admin_manual/apps_management.rst b/admin_manual/apps_management.rst
@@ -30,7 +30,7 @@ have an **Featured**-tag.
           and custom consulting for supported apps, contact our `sales team <https://nextcloud.com/enterprise/>`_.
 
 .. note:: If you would like to develop your own Nextcloud app, you can find out
-          more information in our `developer manual <https://docs.nextcloud.com/server/latest/go.php?to=developer-manual>`_.
+          more information in our `developer manual <https://docs.nextcloud.com/server/31/go.php?to=developer-manual>`_.
 .. TODO ON RELEASE: Update version number above on release
 
 All apps must be licensed under AGPLv3+ or any compatible license.
diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst
@@ -45,7 +45,7 @@ relevant php.ini files) ::
 
 The ``upload_max_filesize`` and ``post_max_size`` settings may not apply to file uploads
 through WebDAV single file PUT requests or `Chunked file uploads
-<https://docs.nextcloud.com/server/latest/developer_manual/client_apis/WebDAV/chunking.html>`_
+<https://docs.nextcloud.com/server/31/developer_manual/client_apis/WebDAV/chunking.html>`_
 For those, PHP and webserver timeouts are the limiting factor on the upload size.
 
 .. TODO ON RELEASE: Update version number above on release
@@ -170,19 +170,21 @@ Default is ``104857600`` (100 MiB).
 Large file upload on object storage
 -----------------------------------
 
-`Chunked file uploads <https://docs.nextcloud.com/server/latest/developer_manual/client_apis/WebDAV/chunking.html>`_
+`Chunked file uploads <https://docs.nextcloud.com/server/31/developer_manual/client_apis/WebDAV/chunking.html>`_
 do have a larger space consumption on the temporary folder when processing those uploads
 on object storage as the individual chunks get downloaded from the storage and will be assembled
 to the actual file on the Nextcloud servers temporary directory. It is recommended to increase
 the size of your temp directory accordingly and also ensure that request timeouts are high
 enough for PHP, webservers or any load balancers involved.
 
+.. TODO ON RELEASE: Update version number above on release
+
 .. tip:: In more recent versions of Nextcloud Server, when uploading to S3 in *Primary Storage* mode, we use S3 `MultipartUpload`. This allows chunked upload streaming of the chunks directly to S3 so that the final MOVE request no longer needs to assemble the final file on the Nextcloud server. This requires your ``memcache.distributed`` to be set to use Redis (or Memcached), otherwise we fall back on the prior behavior which consumes space on the Nextcloud Server for file assembly (as described above).
 
 Federated Cloud Sharing
 -----------------------
 
-If you are using `Federated Cloud Sharing <https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_ and want to share large files, you can increase the timeout values for requests to the federated servers.
+If you are using `Federated Cloud Sharing <https://docs.nextcloud.com/server/31/admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_ and want to share large files, you can increase the timeout values for requests to the federated servers.
 Therefore, you can set ``davstorage.request_timeout`` in your ``config.php``. The default value is 30 seconds.
 
 .. TODO ON RELEASE: Update version number above on release
diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst
@@ -346,7 +346,7 @@ Sources
 -------
 
 - `encryption-recovery-tools repository on GitHub <https://github.com/nextcloud/encryption-recovery-tools>`_
-- `Nextcloud Encryption Configuration documentation <https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/encryption_configuration.html>`_
+- `Nextcloud Encryption Configuration documentation <https://docs.nextcloud.com/server/31/admin_manual/configuration_files/encryption_configuration.html>`_
 - `Nextcloud Help response concerning the usage of version information <https://help.nextcloud.com/t/allow-file-decryption-with-only-the-files-keys-and-passwords/436/12>`_
 - `Sourcecode: Creation of the Message Authentication Code <https://github.com/nextcloud/server/blob/a374d8837d6de459500e619cf608e0721ea14574/apps/encryption/lib/Crypto/Crypt.php#L504>`_
 - `Sourcecode: Derivation of the Encryption Key <https://github.com/nextcloud/server/blob/a374d8837d6de459500e619cf608e0721ea14574/apps/encryption/lib/Crypto/Crypt.php#L346>`_
diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst
@@ -98,7 +98,7 @@ forcing them.
    <https://github.com/owncloud/core/issues/7009>`_ for discussion of this.
 
 .. note:: There are more sharing options on config.php level available:
-   `Configuration Parameters <https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#sharing>`_
+   `Configuration Parameters <https://docs.nextcloud.com/server/31/admin_manual/configuration_server/config_sample_php_parameters.html#sharing>`_
 
 .. TODO ON RELEASE: Update version number above on release
 
@@ -176,7 +176,7 @@ Trashbin contents are not transferred::
 reference.)
 
 Users may also transfer files or folders selectively by themselves.
-See `user documentation <https://docs.nextcloud.com/server/latest/user_manual/en/files/transfer_ownership.html>`_ for details.
+See `user documentation <https://docs.nextcloud.com/server/31/user_manual/en/files/transfer_ownership.html>`_ for details.
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/admin_manual/configuration_user/two_factor-auth.rst b/admin_manual/configuration_user/two_factor-auth.rst
@@ -15,7 +15,7 @@ Several 2FA apps are already available including
 a Telegram/Signal/SMS gateway and `U2F <https://en.wikipedia.org/wiki/Universal_2nd_Factor>`_. 
 
 
-Developers can `build new two-factor provider apps <https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/two-factor-provider.html>`_.
+Developers can `build new two-factor provider apps <https://docs.nextcloud.com/server/31/developer_manual/digging_deeper/two-factor-provider.html>`_.
 
 .. TODO ON RELEASE: Update version number above on release
 
@@ -29,7 +29,7 @@ you want, 2FA will be installed and enabled on your Nextcloud server.
 
 .. figure:: ../images/2fa-app-install.png
 
-Once 2FA has been enabled, users have to `activate it in their personal settings. <https://docs.nextcloud.com/server/latest/user_manual/en/user_2fa.html>`_
+Once 2FA has been enabled, users have to `activate it in their personal settings. <https://docs.nextcloud.com/server/31/user_manual/en/user_2fa.html>`_
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/admin_manual/index.rst b/admin_manual/index.rst
@@ -37,7 +37,7 @@ respective manuals:
 * `Nextcloud User Manual`_
 * `Nextcloud Desktop Client`_
 
-.. _`Nextcloud User Manual`: https://docs.nextcloud.com/server/latest/user_manual/en/
+.. _`Nextcloud User Manual`: https://docs.nextcloud.com/server/31/user_manual/en/
 .. _`Nextcloud Desktop Client`: https://docs.nextcloud.com/desktop/latest/
 
 .. TODO ON RELEASE: Update version number above on release
diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst
@@ -14,7 +14,7 @@ following commands in a terminal::
 
 * This installs the packages for the Nextcloud core system. 
   If you are planning on running additional apps, keep in mind that they might
-  require additional packages.  See `Prerequisites for manual installation <https://docs.nextcloud.com/server/latest/admin_manual/installation/source_installation.html#prerequisites-for-manual-installation>`_ for details.
+  require additional packages.  See `Prerequisites for manual installation <https://docs.nextcloud.com/server/31/admin_manual/installation/source_installation.html#prerequisites-for-manual-installation>`_ for details.
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/admin_manual/installation/harden_server.rst b/admin_manual/installation/harden_server.rst
@@ -287,9 +287,11 @@ Depending on your server setup, these are the possible connections:
 	- submitted data: statistical data. see here for the `detailed field list`_
 - Any remote Nextcloud server that is connected with federated sharing
 
-.. _optional (config): https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#has-internet-connection
+.. _optional (config): https://docs.nextcloud.com/server/31/admin_manual/configuration_server/config_sample_php_parameters.html#has-internet-connection
 .. _detailed field list : https://github.com/nextcloud/survey_client
 
+.. TODO ON RELEASE: Update version number above on release
+
 
 Setup fail2ban
 --------------
diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst
@@ -31,7 +31,7 @@ configuration report with the :ref:`occ config command
 
 .. _the Nextcloud Forums: https://help.nextcloud.com
 .. _FAQ page: https://help.nextcloud.com/t/how-to-faq-wiki
-.. _bugtracker: https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html
+.. _bugtracker: https://docs.nextcloud.com/server/31/developer_manual/prologue/bugtracker/index.html
 
 .. TODO ON RELEASE: Update version number above on release
 
@@ -431,7 +431,7 @@ does not match the actual data stored in the user's ``data/$userId/files`` direc
 .. note::
 
    Metadata, versions, trashbin and encryption keys are not counted in the used space above.
-   Please refer to the `quota documentation <https://docs.nextcloud.com/server/latest/user_manual/en/files/quota.html>`_ for details.
+   Please refer to the `quota documentation <https://docs.nextcloud.com/server/31/user_manual/en/files/quota.html>`_ for details.
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/admin_manual/occ_command.rst b/admin_manual/occ_command.rst
@@ -367,8 +367,9 @@ While setting a configuration value, multiple options are available:
 .. note::
 	See `Appconfig Concepts`_ to learn more about `typed value`, `lazy` and `sensitive` flag.
 
-.. _Appconfig Concepts: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/config/appconfig.html#concept-overview
+.. _Appconfig Concepts: https://docs.nextcloud.com/server/31/developer_manual/digging_deeper/config/appconfig.html#concept-overview
 
+.. TODO ON RELEASE: Update version number above on release
 
 You can list all configuration values with one command::
 
@@ -960,7 +961,7 @@ The command line option ``--transfer-incoming-shares`` overwrites the config.php
  sudo -u www-data php occ files:transfer-ownership --transfer-incoming-shares=0 <source-user> <destination-user>
 
 Users may also transfer files or folders selectively by themselves.
-See `user documentation <https://docs.nextcloud.com/server/latest/user_manual/en/files/transfer_ownership.html>`_ for details.
+See `user documentation <https://docs.nextcloud.com/server/31/user_manual/en/files/transfer_ownership.html>`_ for details.
 
 .. TODO ON RELEASE: Update version number above on release
 
@@ -1037,7 +1038,7 @@ Verify your app::
   sudo -u www-data php occ integrity:check-app --path=/pathto/app appname
 
 When it returns nothing, your app is signed correctly. When it returns a message then there is an error. See `Code Signing
-<https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/code_signing.html#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information.
+<https://docs.nextcloud.com/server/31/developer_manual/app_publishing_maintenance/code_signing.html#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information.
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/admin_manual/webhook_listeners/index.rst b/admin_manual/webhook_listeners/index.rst
@@ -18,7 +18,9 @@ Installation
 Listening to events
 -------------------
 
-You can use the OCS API to add webhooks for specific events: https://docs.nextcloud.com/server/latest/developer_manual/_static/openapi.html#/operations/webhook_listeners-webhooks-index
+You can use the OCS API to add webhooks for specific events: https://docs.nextcloud.com/31/latest/developer_manual/_static/openapi.html#/operations/webhook_listeners-webhooks-index
+
+.. TODO ON RELEASE: Update version number above on release
 
 Note: When authenticating with the OCS API to register webhooks the account you authenticate as must have administrator rights or delegated administrator rights.
 
diff --git a/admin_manual/windmill_workflows/index.rst b/admin_manual/windmill_workflows/index.rst
@@ -50,7 +50,9 @@ Each workflow in Windmill is a listener to a Nextcloud Webhook Event.
 If you are using the ExApp-packaged Windmill, it will automatically register webhooks for the workflows you build using the following mechanism.
 If you are not using the ExApp-packaged windmill install then you will have to register
 webhooks for your workflows manually via the webhook_listeners API:
-see https://docs.nextcloud.com/server/latest/developer_manual/_static/openapi.html#/operations/webhook_listeners-webhooks-index
+see https://docs.nextcloud.com/server/31/developer_manual/_static/openapi.html#/operations/webhook_listeners-webhooks-index
+
+.. TODO ON RELEASE: Update version number above on release
 
 The magic listener script
 ~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst
@@ -47,7 +47,7 @@ Admin audit logging
 
 If you want to log things less for system administration but for compliance reasons, e.g. who accessed which file,
 who changed the password of an item or made it public, the
-`admin audit log <https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/logging_configuration.html#admin-audit-log>`_
+`admin audit log <https://docs.nextcloud.com/server/31/admin_manual/configuration_server/logging_configuration.html#admin-audit-log>`_
 is the correct place.
 
 .. TODO ON RELEASE: Update version number above on release
diff --git a/developer_manual/basics/setting.rst b/developer_manual/basics/setting.rst
@@ -110,7 +110,7 @@ The last missing part is to register both classes inside **<myapp>/appinfo/info.
    `<personal>` instead.
 
 Additionally since Nextcloud 23, groups can be granted authorization to access individual
-admin settings (`see admin docs <https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/admin_delegation_configuration.html>`_).
+admin settings (`see admin docs <https://docs.nextcloud.com/server/31/admin_manual/configuration_server/admin_delegation_configuration.html>`_).
 This is a feature that needs to be enabled for each admin setting class.
 To do so, the setting class needs to implement `IDelegatedSettings` instead of `ISettings`
 and implement two additional methods.
diff --git a/developer_manual/client_apis/OCS/ocs-share-api.rst b/developer_manual/client_apis/OCS/ocs-share-api.rst
@@ -227,7 +227,7 @@ Federated Cloud Shares
 ----------------------
 
 Both the sending and the receiving instance need to have federated cloud sharing
-enabled and configured. See `Configuring Federated Cloud Sharing <https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_.
+enabled and configured. See `Configuring Federated Cloud Sharing <https://docs.nextcloud.com/server/31/admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_.
 
 .. TODO ON RELEASE: Update version number above on release
 
diff --git a/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst b/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst
@@ -8,4 +8,6 @@ OCS TaskProcessing API
 
 The OCS Task processing API allows you to run task processing tasks, like prompting large language models implemented by apps using  :ref:`the backend Task Processing API<task_processing>`.
 
-See the relevant `OpenAPI docs <https://docs.nextcloud.com/server/latest/developer_manual/_static/openapi.html#/operations/core-task_processing_api-schedule>`_.
+See the relevant `OpenAPI docs <https://docs.nextcloud.com/server/31/developer_manual/_static/openapi.html#/operations/core-task_processing_api-schedule>`_.
+
+.. TODO ON RELEASE: Update version number above on release
diff --git a/developer_manual/exapp_development/faq/DockerSocketProxy.rst b/developer_manual/exapp_development/faq/DockerSocketProxy.rst
@@ -28,7 +28,9 @@ Nextcloud AIO implements its own `Docker Socket Proxy container <https://github.
 you just need to tick the checkbox in the AIO configuration interface to enable it.
 AppAPI automatically creates the default Deploy daemon configuration for Nextcloud AIO.
 
-See `Nextcloud in Docker AIO (all-in-one) <https://docs.nextcloud.com/server/latest/admin_manual/exapps_management/DeployConfigurations.html#nextcloud-in-docker-aio-all-in-one>`_ for more details.
+See `Nextcloud in Docker AIO (all-in-one) <https://docs.nextcloud.com/server/31/admin_manual/exapps_management/DeployConfigurations.html#nextcloud-in-docker-aio-all-in-one>`_ for more details.
+
+.. TODO ON RELEASE: Update version number above on release
 
 .. note::
 
diff --git a/developer_manual/exapp_development/faq/Troubleshooting.rst b/developer_manual/exapp_development/faq/Troubleshooting.rst
@@ -27,9 +27,11 @@ Here are some common steps to verify the network configuration:
 ExApp deployment issues
 -----------------------
 
-The deployment issues questions are covered in the `Test Deploy <https://docs.nextcloud.com/server/latest/admin_manual/exapps_management/TestDeploy.html>`_ section of the administration guide.
+The deployment issues questions are covered in the `Test Deploy <https://docs.nextcloud.com/server/31/admin_manual/exapps_management/TestDeploy.html>`_ section of the administration guide.
 Generally speaking, there are three steps to find the proper error message to understand the problem:
 
+.. TODO ON RELEASE: Update version number above on release
+
 1. Check Nextcloud logs
 2. Check ExApp container logs (available only if ExApp container is created and/or running)
 3. Check Deploy daemon host logs (``journalctl -u docker.service``)
diff --git a/developer_manual/exapp_development/tech_details/Translations.rst b/developer_manual/exapp_development/tech_details/Translations.rst
@@ -26,10 +26,12 @@ There is an example repository with translations: `UI example with translations
 Manual install
 **************
 
-For the ``manual-install`` type, an administrator will have to manually extract to the server's `writable apps directory <https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#apps-paths>`_ ``l10n`` folder of the ExApp
+For the ``manual-install`` type, an administrator will have to manually extract to the server's `writable apps directory <https://docs.nextcloud.com/server/31/admin_manual/configuration_server/config_sample_php_parameters.html#apps-paths>`_ ``l10n`` folder of the ExApp
 (e.g. ``/path/to/apps-writable/<appid>/l10n/*.(js|json)``).
 This will allow the server to access the ExApp's strings with translations.
 
+.. TODO ON RELEASE: Update version number above on release
+
 .. note::
 
 	Only the ``l10n`` folder must be present on the server side; ``appinfo/info.xml`` could lead to misdetection by the server as a PHP app folder.
diff --git a/developer_manual/exapp_development/tech_details/api/logging.rst b/developer_manual/exapp_development/tech_details/api/logging.rst
@@ -25,7 +25,9 @@ Request data
 	}
 
 
-The possible values of ``log_lvl`` are described here: `Nextcloud Log level <https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/logging_configuration.html#log-level>`_
+The possible values of ``log_lvl`` are described here: `Nextcloud Log level <https://docs.nextcloud.com/server/31/admin_manual/configuration_server/logging_configuration.html#log-level>`_
+
+.. TODO ON RELEASE: Update version number above on release
 
 Response data
 *************
diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst
@@ -16,7 +16,7 @@ Please follow the steps on this page to set up your development environment manu
 Set up Web server and database
 ------------------------------
 
-First `set up your Web server and database <https://docs.nextcloud.com/server/latest/admin_manual/installation/index.html>`_ (**Section**: Manual Installation - Prerequisites).
+First `set up your Web server and database <https://docs.nextcloud.com/server/31/admin_manual/installation/index.html>`_ (**Section**: Manual Installation - Prerequisites).
 
 .. TODO ON RELEASE: Update version number above on release
 
@@ -25,7 +25,7 @@ Get the source
 
 There are two ways to obtain Nextcloud sources:
 
-* Using the `stable version <https://docs.nextcloud.com/server/latest/admin_manual/installation/index.html>`_
+* Using the `stable version <https://docs.nextcloud.com/server/31/admin_manual/installation/index.html>`_
 * Using the development version from `GitHub`_ which will be explained below.
 
 .. TODO ON RELEASE: Update version number above on release
diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst
@@ -6,7 +6,7 @@ The External Storage application allows you to mount external storage services,
 such as Amazon S3, SMB/CIFS file servers and FTP servers…
 in Nextcloud. Your Nextcloud server administrator controls which of these are 
 available to you. Please see `Configuring External Storage (GUI) 
-<https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/external_storage_configuration_gui.html>`_ in the Nextcloud Administrator's 
+<https://docs.nextcloud.com/server/31/admin_manual/configuration_files/external_storage_configuration_gui.html>`_ in the Nextcloud Administrator's
 manual for configuration how-tos and examples.
 
 .. TODO ON RELEASE: Update version number above on release
diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst
diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst
diff --git a/user_manual/files/encrypting_files.rst b/user_manual/files/encrypting_files.rst
diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst
diff --git a/user_manual/files/quota.rst b/user_manual/files/quota.rst
diff --git a/user_manual/files/sharing.rst b/user_manual/files/sharing.rst
diff --git a/user_manual/files/transfer_ownership.rst b/user_manual/files/transfer_ownership.rst
diff --git a/user_manual/groupware/sync_gnome.rst b/user_manual/groupware/sync_gnome.rst
diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst
diff --git a/user_manual/groupware/sync_kde.rst b/user_manual/groupware/sync_kde.rst
