Skip to content
679 changes: 475 additions & 204 deletions .github/workflows/sphinxbuild.yml

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -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>`_
<../../developer_manual/client_apis/WebDAV/chunking.rst>`_
For those, PHP and webserver timeouts are the limiting factor on the upload size.

.. TODO ON RELEASE: Update version number above on release
Expand Down Expand Up @@ -164,7 +164,7 @@ 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 <../../developer_manual/client_apis/WebDAV/chunking.rst>`_
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
Expand All @@ -178,7 +178,7 @@ enough for PHP, webservers or any load balancers involved.
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 <../../admin_manual/configuration_files/federated_cloud_sharing_configuration.rst>`_ 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
2 changes: 1 addition & 1 deletion admin_manual/configuration_files/encryption_details.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/configuration_files/encryption_configuration.rst>`_
- `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>`_
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/configuration_server/config_sample_php_parameters.rst#sharing>`_

.. TODO ON RELEASE: Update version number above on release

Expand Down Expand Up @@ -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 <../../user_manual/en/files/transfer_ownership.rst>`_ for details.

.. TODO ON RELEASE: Update version number above on release

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1074,7 +1074,7 @@ Enable SMTP class debugging.
.. note::

``loglevel`` will likely need to be adjusted too. See docs:
https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/email_configuration.html#enabling-debug-mode
../../admin_manual/configuration_server/email_configuration.rst#enabling-debug-mode

Defaults to ``false``

Expand Down
4 changes: 2 additions & 2 deletions admin_manual/configuration_user/two_factor-auth.rst
Original file line number Diff line number Diff line change
Expand Up @@ -48,15 +48,15 @@ Other 2FA providers may be found in the App Store.
.. figure:: ../images/2fa-app-install.png

Developers can also `implement new two-factor provider
apps <https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/two-factor-provider.html>`_.
apps <../../developer_manual/digging_deeper/two-factor-provider.rst>`_.

.. TODO ON RELEASE: Update version number above on release

Enforcing two-factor authentication
-----------------------------------

By default 2FA is *optional*, hence users are given the choice whether to enable
it for their account `under their personal settings <https://docs.nextcloud.com/server/latest/user_manual/en/user_2fa.html>`_.
it for their account `under their personal settings <../../user_manual/en/user_2fa.rst>`_.
Admins may, however, enforce the use of 2FA.

Enforcement is possible system-wide (all users) or for selected groups only. Select groups
Expand Down
4 changes: 2 additions & 2 deletions admin_manual/desktop/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,5 +27,5 @@ You can find additional information here:
* `User manual`_
* `Developer manual`_

.. _`User manual`: https://docs.nextcloud.com/server/latest/user_manual/en/desktop/index.html
.. _`Developer manual`: https://docs.nextcloud.com/server/latest/developer_manual/desktop/index.html
.. _`User manual`: ../../user_manual/en/desktop/index.rst
.. _`Developer manual`: ../../developer_manual/desktop/index.rst
4 changes: 2 additions & 2 deletions admin_manual/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,13 +25,13 @@ For documentation on Nextcloud web, desktop, or mobile clients, see:
- `Nextcloud User Manual`_
- `Nextcloud Desktop Client`_

.. _`Nextcloud User Manual`: https://docs.nextcloud.com/server/latest/user_manual/en/
.. _`Nextcloud User Manual`: ../user_manual/en
.. _`Nextcloud Desktop Client`: https://docs.nextcloud.com/desktop/latest/

For documentation on development topics, see:

- The individual repositories on GitHub within `the @nextcloud organization <https://github.com/nextcloud/>`_
- `Nextcloud Development Manual <https://docs.nextcloud.com/server/latest/developer_manual/>`_
- `Nextcloud Development Manual <../developer_manual>`_

.. TODO ON RELEASE: Update version number above on release

Expand Down
2 changes: 1 addition & 1 deletion admin_manual/installation/example_ubuntu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/installation/source_installation.rst#prerequisites-for-manual-installation>`_ for details.

.. TODO ON RELEASE: Update version number above on release

Expand Down
2 changes: 1 addition & 1 deletion admin_manual/installation/harden_server.rst
Original file line number Diff line number Diff line change
Expand Up @@ -302,7 +302,7 @@ Depending on your server setup, these are the possible connections:
- Any remote Nextcloud server that is connected with federated sharing
- When downloading apps from the App store other domains might be accessed, based on the choice of the app developers where they host the releases. For all official Nextcloud apps this is not the case though, because they are hosted on Github.

.. _optional (config): https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#has-internet-connection
.. _optional (config): ../../admin_manual/configuration_server/config_sample_php_parameters.rst#has-internet-connection
.. _detailed field list: https://github.com/nextcloud/survey_client

.. TODO ON RELEASE: Update version number above on release
Expand Down
4 changes: 2 additions & 2 deletions admin_manual/issues/general_troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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: ../../developer_manual/prologue/bugtracker/index.rst

.. TODO ON RELEASE: Update version number above on release

Expand Down Expand Up @@ -413,7 +413,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 <../../user_manual/en/files/quota.rst>`_ for details.

.. TODO ON RELEASE: Update version number above on release

Expand Down
6 changes: 3 additions & 3 deletions admin_manual/occ_command.rst
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ 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: ../developer_manual/digging_deeper/config/appconfig.rst#concept-overview

.. TODO ON RELEASE: Update version number above on release

Expand Down Expand Up @@ -1148,7 +1148,7 @@ The command line option ``--transfer-incoming-shares`` overwrites the config.php
sudo -E -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 <../user_manual/en/files/transfer_ownership.rst>`_ for details.

.. TODO ON RELEASE: Update version number above on release

Expand Down Expand Up @@ -1241,7 +1241,7 @@ Verify your app::
sudo -E -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.
<../developer_manual/app_publishing_maintenance/code_signing.rst#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information.

.. TODO ON RELEASE: Update version number above on release

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ Added APIs
- ``OCP\Console\ReservedOptions`` was added and contains constants for options reserved for occ core features. ``--debug-log`` and ``--debug-log-level`` are now reserved by occ as they allow to show debug information to the output on any occ command.
- ``OCP\Security\IHasher::validate()`` should return true if the passed string is a valid hash generated by ``OCP\Security\IHasher::hash()``
- ``OCP\AppFramework\Http\JSONResponse()`` constructor now supports passing additional ``json_encode`` flags, see https://www.php.net/manual/en/function.json-encode.php for details
- ``OCP\EventDispatcher\IWebhookCompatibleEvent`` is a new interface for events compatible with webhooks (`see webhook_listeners documentation <https://docs.nextcloud.com/server/latest/admin_manual/webhook_listeners/index.html>`_).
- ``OCP\EventDispatcher\IWebhookCompatibleEvent`` is a new interface for events compatible with webhooks (`see webhook_listeners documentation <../../../admin_manual/webhook_listeners/index.rst>`_).
- ``OCP\EventDispatcher\JsonSerializer`` is a new public helper for serializing users and fileinfos to json (ie for webhook events)

Changed APIs
Expand Down Expand Up @@ -222,7 +222,7 @@ Changed APIs
- ``OCP\IUserManager::getDisabledUsers`` now has a third parameter for a search string.
- ``OCP\User\Backend\IProvideEnabledStateBackend::getDisabledUserList`` now has a third parameter for a search string.
- Legacy class ``OC_EventSource`` was moved to ``OC`` namespace with the ``OC_`` prefix. It should not change anything if you already correctly use the ``OCP\IEventSourceFactory`` to create these objects.
- ``OCP\Files\Events\Node\AbstractNodeEvent`` and ``OCP\Files\Events\Node\AbstractNodesEvent`` now implements ``OCP\EventDispatcher\IWebhookCompatibleEvent`` so that all file/folder related events are available for webhooks (`see webhook_listeners documentation <https://docs.nextcloud.com/server/latest/admin_manual/webhook_listeners/index.html>`_).
- ``OCP\Files\Events\Node\AbstractNodeEvent`` and ``OCP\Files\Events\Node\AbstractNodesEvent`` now implements ``OCP\EventDispatcher\IWebhookCompatibleEvent`` so that all file/folder related events are available for webhooks (`see webhook_listeners documentation <../../../admin_manual/webhook_listeners/index.rst>`_).

Deprecated APIs
^^^^^^^^^^^^^^^
Expand Down
2 changes: 1 addition & 1 deletion developer_manual/basics/logging.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/configuration_server/logging_configuration.rst#admin-audit-log>`_
is the correct place.

.. TODO ON RELEASE: Update version number above on release
Expand Down
2 changes: 1 addition & 1 deletion developer_manual/basics/setting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/configuration_server/admin_delegation_configuration.rst>`_).
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.
Expand Down
2 changes: 1 addition & 1 deletion developer_manual/client_apis/OCS/ocs-share-api.rst
Original file line number Diff line number Diff line change
Expand Up @@ -225,7 +225,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 <../../../admin_manual/configuration_files/federated_cloud_sharing_configuration.rst>`_.

.. TODO ON RELEASE: Update version number above on release

Expand Down
4 changes: 2 additions & 2 deletions developer_manual/desktop/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,5 +21,5 @@ You can find additional information here:
* `User manual`_
* `Admin manual`_

.. _`User manual`: https://docs.nextcloud.com/server/latest/user_manual/en/desktop/index.html
.. _`Admin manual`: https://docs.nextcloud.com/server/latest/admin_manual/desktop/index.html
.. _`User manual`: ../../user_manual/en/desktop/index.rst
.. _`Admin manual`: ../../admin_manual/desktop/index.rst
2 changes: 1 addition & 1 deletion developer_manual/digging_deeper/config/appconfig.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ In addition to simple read/write operations, ``IAppConfig`` supports:
.. note::
See `Lexicon Concepts`_ to learn more about **Lexicon**, a way to define configuration keys and avoid conflicts in your code.

.. _Lexicon Concepts: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/config/lexicon.html#concept-overview
.. _Lexicon Concepts: ../../../developer_manual/digging_deeper/config/lexicon.rst#concept-overview


AppFramework
Expand Down
2 changes: 1 addition & 1 deletion developer_manual/digging_deeper/config/userconfig.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ On top of storing and accessing your configuration values, ``IUserConfig`` comes
.. note::
See `Lexicon Concepts`_ to learn more about **Lexicon**, a way to fully define your configuration keys and avoid conflict when using it in your code.

.. _Lexicon Concepts: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/config/lexicon.html#concept-overview
.. _Lexicon Concepts: ../../../developer_manual/digging_deeper/config/lexicon.rst#concept-overview


Typed Config Values
Expand Down
4 changes: 2 additions & 2 deletions developer_manual/digging_deeper/context_chat.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ Context Chat
.. versionadded:: 32.0.0

Nextcloud offers a **Context Chat** API which allows apps like files to submit data
to the `Nextcloud Assistant Context Chat <https://docs.nextcloud.com/server/latest/admin_manual/ai/app_context_chat.html>`_,
thereby enabling `Nextcloud Assistant <https://docs.nextcloud.com/server/latest/admin_manual/ai/app_assistant.html>`_
to the `Nextcloud Assistant Context Chat <../../admin_manual/ai/app_context_chat.rst>`_,
thereby enabling `Nextcloud Assistant <../../admin_manual/ai/app_assistant.rst>`_
to answer questions, provide insights and search results based on the submitted data and natural language queries.

Implementing a content provider for Context Chat
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ 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) <../../../admin_manual/exapps_management/DeployConfigurations.rst#nextcloud-in-docker-aio-all-in-one>`_ for more details.

.. TODO ON RELEASE: Update version number above on release

Expand Down
2 changes: 1 addition & 1 deletion developer_manual/exapp_development/faq/Troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ 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 <../../../admin_manual/exapps_management/TestDeploy.rst>`_ 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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ You can then compile them to ``.mo`` files using `ui_example's <https://github.c
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 <../../../admin_manual/configuration_server/config_sample_php_parameters.rst#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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ 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 <../../../../admin_manual/configuration_server/logging_configuration.rst#log-level>`_

.. TODO ON RELEASE: Update version number above on release

Expand Down
4 changes: 2 additions & 2 deletions developer_manual/getting_started/devenv.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <../../admin_manual/installation/index.rst>`_ (**Section**: Manual Installation - Prerequisites).

.. TODO ON RELEASE: Update version number above on release

Expand All @@ -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 <../../admin_manual/installation/index.rst>`_
* Using the development version from `GitHub`_ which will be explained below.

.. TODO ON RELEASE: Update version number above on release
Expand Down
Loading
Loading