From 42971688680a37ff95f430d51a30560b1efcabb9 Mon Sep 17 00:00:00 2001 From: skjnldsv Date: Wed, 8 Apr 2026 13:51:44 +0200 Subject: [PATCH 1/6] feat(ci): add lychee broken link checker and stage-and-check job Signed-off-by: skjnldsv Co-authored-by: skjnldsv <14975046+skjnldsv@users.noreply.github.com> Signed-off-by: skjnldsv --- .github/workflows/sphinxbuild.yml | 75 +++++++++++++++++++++---------- 1 file changed, 52 insertions(+), 23 deletions(-) diff --git a/.github/workflows/sphinxbuild.yml b/.github/workflows/sphinxbuild.yml index 110c3415c33..2ffe6f2e12a 100644 --- a/.github/workflows/sphinxbuild.yml +++ b/.github/workflows/sphinxbuild.yml @@ -185,22 +185,6 @@ jobs: with: path: artifacts/ - # ======================================================================== - # PREPARE FOR LINK VALIDATION: BUILD FULL PAGE CONTEXT - # ======================================================================== - # We need to validate links in the new documentation, but some links may - # point to other versions or branches that are already deployed. So we: - # 1. Fetch the existing gh-pages content (old versions) - # 2. Merge in the new artifacts (what we're about to deploy) - # 3. Run link checks only on the NEW content, but with full context - # ======================================================================== - - name: Checkout gh-pages branch for validation context - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 - with: - ref: gh-pages - fetch-depth: 1 - path: validation-context - # ======================================================================== # DETERMINE DEPLOYMENT TARGETS (branch_name and version_name) # ======================================================================== @@ -307,8 +291,7 @@ jobs: # ======================================================================== # UPLOAD STAGING ARTIFACTS # ======================================================================== - # Upload the staging folder for use in deploy job. - # This makes the content visible in the UI for debugging and inspection. + # Upload the staging folder for use in both the deploy and link-check jobs. # ======================================================================== - name: Upload staged artifacts uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 @@ -317,6 +300,53 @@ jobs: path: stage/ retention-days: 1 + # ============================================================================ + # LINK CHECK + # ============================================================================ + # Runs in parallel with deploy. Downloads the staged artifacts, strips + # canonical links, then runs lychee against the new content only. + # ============================================================================ + link-check: + name: Check for broken links + needs: stage-and-check + runs-on: ubuntu-latest + + steps: + - name: Download staged artifacts + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: staged-docs + path: stage/ + + - name: Strip canonical links from validation HTML + run: | + find "stage/${{ needs.stage-and-check.outputs.branch_name }}" -name '*.html' -print0 | while IFS= read -r -d '' f; do + perl -0pi -e 's{^\s*\n}{}m' "$f" + done + ls -la stage/* + + # We need to exclude certain links from the check: + # - go.php: This is a special redirect page + # - mailto: links: These are not valid URLs and will always fail + # - 404.html: This is not necessary + # - latest/stable/xx links from the version selector + - name: Check for broken links with lychee + uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411 # v2.8.0 + with: + fail: true + token: ${{ secrets.GITHUB_TOKEN }} + jobSummary: true + args: | + --root-dir "$(pwd)/stage" + --offline --no-progress + --remap "https://docs.nextcloud.com/server/ file://$(pwd)/stage/" + --exclude 'go\.php' --exclude 'mailto:' --exclude-path '.*/404\.html' + --exclude "/user_manual/" --include "/user_manual/en/" + --exclude '^file://.*/stage/(latest|stable|[0-9]+)/(developer_manual|admin_manual|user_manual)/?$' + 'stage/${{ needs.stage-and-check.outputs.branch_name }}/user_manual/en/**/*.html' + 'stage/${{ needs.stage-and-check.outputs.branch_name }}/admin_manual/**/*.html' + 'stage/${{ needs.stage-and-check.outputs.branch_name }}/developer_manual/**/*.html' + # ============================================================================ # DEPLOY # ============================================================================ @@ -460,7 +490,7 @@ jobs: GH_TOKEN: ${{ secrets.COMMAND_BOT_PAT }} summary: - needs: [build-html, build-pdf, stage-and-check, deploy] + needs: [stage-and-check, link-check, deploy] runs-on: ubuntu-latest-low if: always() @@ -474,10 +504,9 @@ jobs: run: | if ${{ github.event_name == 'pull_request' }} then - echo "This workflow ran for a pull request. We need build-html, build-pdf and stage-and-check to succeed, but deploy will be skipped" - if ${{ needs.build-html.result != 'success' || needs.build-pdf.result != 'success' || needs.stage-and-check.result != 'success' || needs.deploy.result != 'skipped' }}; then exit 1; fi + echo "This workflow ran for a pull request. We need stage-and-check and link-check to succeed, but deploy will be skipped" + if ${{ needs.stage-and-check.result != 'success' || needs.link-check.result != 'success' || needs.deploy.result != 'skipped' }}; then exit 1; fi else echo "This workflow ran for a push. We need all jobs to succeed, including deploy" - if ${{ needs.build-html.result != 'success' || needs.build-pdf.result != 'success' || needs.stage-and-check.result != 'success' || needs.deploy.result != 'success' }}; then exit 1; fi + if ${{ needs.stage-and-check.result != 'success' || needs.link-check.result != 'success' || needs.deploy.result != 'success' }}; then exit 1; fi fi - From acea686299b5dbec01213d8943f552d2623ef25f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6=20=28skjnldsv=29?= Date: Thu, 23 Apr 2026 21:39:11 +0200 Subject: [PATCH 2/6] docs: convert absolute documentation URLs to relative paths MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: John Molakvoæ (skjnldsv) Signed-off-by: skjnldsv --- admin_manual/ai/overview.rst | 2 +- .../configuration_database/mysql_4byte_support.rst | 2 +- .../configuration_files/big_file_upload_configuration.rst | 6 +++--- admin_manual/configuration_files/encryption_details.rst | 2 +- .../configuration_files/file_sharing_configuration.rst | 4 ++-- .../configuration_server/config_sample_php_parameters.rst | 2 +- admin_manual/configuration_user/profile_configuration.rst | 2 +- admin_manual/configuration_user/two_factor-auth.rst | 4 ++-- admin_manual/desktop/index.rst | 4 ++-- admin_manual/index.rst | 4 ++-- admin_manual/installation/example_ubuntu.rst | 2 +- admin_manual/installation/harden_server.rst | 2 +- admin_manual/issues/general_troubleshooting.rst | 4 ++-- admin_manual/occ_apps.rst | 2 +- admin_manual/occ_files.rst | 4 ++-- .../app_upgrade_guide/upgrade_to_30.rst | 4 ++-- developer_manual/basics/logging.rst | 2 +- developer_manual/basics/setting.rst | 2 +- developer_manual/client_apis/OCS/ocs-share-api.rst | 2 +- developer_manual/desktop/index.rst | 4 ++-- developer_manual/digging_deeper/config/appconfig.rst | 2 +- developer_manual/digging_deeper/config/userconfig.rst | 2 +- developer_manual/digging_deeper/context_chat.rst | 4 ++-- .../exapp_development/faq/DockerSocketProxy.rst | 2 +- .../exapp_development/faq/Troubleshooting.rst | 2 +- .../exapp_development/tech_details/Translations.rst | 2 +- .../exapp_development/tech_details/api/logging.rst | 2 +- developer_manual/getting_started/devenv.rst | 4 ++-- user_manual/desktop/index.rst | 4 ++-- user_manual/external_storage/external_storage.rst | 2 +- user_manual/files/access_webdav.rst | 2 +- user_manual/files/deleted_file_management.rst | 2 +- user_manual/files/encrypting_files.rst | 8 ++++---- user_manual/files/large_file_upload.rst | 2 +- user_manual/files/quota.rst | 2 +- user_manual/files/sharing.rst | 2 +- user_manual/files/transfer_ownership.rst | 2 +- user_manual/groupware/sync_gnome.rst | 2 +- user_manual/groupware/sync_ios.rst | 4 ++-- user_manual/groupware/sync_kde.rst | 2 +- 40 files changed, 57 insertions(+), 57 deletions(-) diff --git a/admin_manual/ai/overview.rst b/admin_manual/ai/overview.rst index f275d91ec38..00ebce4f611 100644 --- a/admin_manual/ai/overview.rst +++ b/admin_manual/ai/overview.rst @@ -118,7 +118,7 @@ Frontend apps * `Whiteboard `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Deck `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Nextcloud Office `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks in documents -* `Desktop Clients `_ for simple "Chat with AI" +* `Desktop Clients <../../user_manual/desktop/index.rst>`_ for simple "Chat with AI" Backend apps ~~~~~~~~~~~~ diff --git a/admin_manual/configuration_database/mysql_4byte_support.rst b/admin_manual/configuration_database/mysql_4byte_support.rst index 02c7cd0d2d0..6196e611148 100644 --- a/admin_manual/configuration_database/mysql_4byte_support.rst +++ b/admin_manual/configuration_database/mysql_4byte_support.rst @@ -13,7 +13,7 @@ installation needs to be tweaked a bit. This manual only covers MySQL 8 or newer and MariaDB 10.2 or newer. If you use MariaDB 10.2, please check - `this older version `_ + `this older version `_ of the documentation. If you use an older version of MySQL or MariaDB, please note that they are no longer supported by the current Nextcloud version. diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst index d3e69106564..1e0b8ae70fb 100644 --- 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 -`_ +<../../developer_manual/client_apis/WebDAV/chunking.rst>`_ For those, PHP and webserver timeouts are the limiting factor on the upload size. Adjust these values for your needs. If you see PHP timeouts in your logfiles, @@ -160,7 +160,7 @@ Default is ``104857600`` (100 MiB). Large file upload on object storage ----------------------------------- -`Chunked file uploads `_ +`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 @@ -172,5 +172,5 @@ enough for PHP, webservers or any load balancers involved. Federated Cloud Sharing ----------------------- -If you are using `Federated Cloud Sharing `_ 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 `_ 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. diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst index deb6babc4cd..dcf5eaa676d 100644 --- 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 `_ -- `Nextcloud Encryption Configuration documentation `_ +- `Nextcloud Encryption Configuration documentation `_ - `Nextcloud Help response concerning the usage of version information `_ - `Sourcecode: Creation of the Message Authentication Code `_ - `Sourcecode: Derivation of the Encryption Key `_ diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index 550a7a78558..fce2760a255 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -98,7 +98,7 @@ forcing them. `_ for discussion of this. .. note:: There are more sharing options on config.php level available: - `Configuration Parameters `_ + `Configuration Parameters <../configuration_server/config_sample_php_parameters.rst#sharing>`_ .. _transfer_userfiles_label: @@ -174,7 +174,7 @@ Trashbin contents are not transferred:: reference.) Users may also transfer files or folders selectively by themselves. -See `user documentation `_ for details. +See `user documentation <../../user_manual/files/transfer_ownership.rst>`_ for details. Creating persistent file Shares diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 08745aeb84a..00f8800fadf 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -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 + email_configuration.rst#enabling-debug-mode Defaults to ``false`` diff --git a/admin_manual/configuration_user/profile_configuration.rst b/admin_manual/configuration_user/profile_configuration.rst index 00ba8a1d409..45acc192d87 100644 --- a/admin_manual/configuration_user/profile_configuration.rst +++ b/admin_manual/configuration_user/profile_configuration.rst @@ -420,5 +420,5 @@ See also -------- - :doc:`../configuration_files/file_sharing_configuration` — sharing and autocomplete settings that interact with profile visibility -- `User manual: Personal settings `_ — user-facing profile and personal info settings +- `User manual: Personal settings <../../user_manual/userpreferences.rst>`_ — user-facing profile and personal info settings diff --git a/admin_manual/configuration_user/two_factor-auth.rst b/admin_manual/configuration_user/two_factor-auth.rst index 7312f1a00a3..eb9cec073bd 100644 --- a/admin_manual/configuration_user/two_factor-auth.rst +++ b/admin_manual/configuration_user/two_factor-auth.rst @@ -46,13 +46,13 @@ 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 `_. +apps <../../developer_manual/digging_deeper/two-factor-provider.rst>`_. 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 `_. +it for their account `under their personal settings <../../user_manual/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 diff --git a/admin_manual/desktop/index.rst b/admin_manual/desktop/index.rst index 370995513bd..70c07600f99 100644 --- a/admin_manual/desktop/index.rst +++ b/admin_manual/desktop/index.rst @@ -22,5 +22,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/desktop/index.rst +.. _`Developer manual`: ../../developer_manual/desktop/index.rst diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 8cb2e40c416..aeed5c75e46 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -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/index.rst .. _`Nextcloud Desktop Client`: https://docs.nextcloud.com/desktop/latest/ For documentation on development topics, see: - The individual repositories on GitHub within `the @nextcloud organization `_ -- `Nextcloud Development Manual `_ +- `Nextcloud Development Manual <../developer_manual/index.rst>`_ Core Components --------------- diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst index 543b890b5d5..02f214f5849 100644 --- 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 `_ for details. + require additional packages. See `Prerequisites for manual installation `_ for details. Now you need to create a database user and the database itself by using the MySQL command line interface. The database tables will be created by Nextcloud diff --git a/admin_manual/installation/harden_server.rst b/admin_manual/installation/harden_server.rst index d884534e70a..edab8d2e644 100644 --- a/admin_manual/installation/harden_server.rst +++ b/admin_manual/installation/harden_server.rst @@ -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): ../configuration_server/config_sample_php_parameters.rst#has-internet-connection .. _detailed field list: https://github.com/nextcloud/survey_client diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index bb71b685ec1..8c46f58346d 100644 --- 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: ../../developer_manual/prologue/bugtracker/index.rst General troubleshooting ----------------------- @@ -411,7 +411,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 `_ for details. + Please refer to the `quota documentation <../../user_manual/files/quota.rst>`_ for details. Running the following command can help fix the sizes and quota for a given user:: diff --git a/admin_manual/occ_apps.rst b/admin_manual/occ_apps.rst index 553b6573efe..9307bd9894b 100644 --- a/admin_manual/occ_apps.rst +++ b/admin_manual/occ_apps.rst @@ -157,7 +157,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 You can list all configuration values with one command:: diff --git a/admin_manual/occ_files.rst b/admin_manual/occ_files.rst index bfcb9a6aadd..452b6209186 100644 --- a/admin_manual/occ_files.rst +++ b/admin_manual/occ_files.rst @@ -336,7 +336,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 Users may also transfer files or folders selectively by themselves. -See `user documentation `_ for details. +See `user documentation <../user_manual/files/transfer_ownership.rst>`_ for details. .. _occ_files_windows_filenames: @@ -427,7 +427,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 -`_ 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. ``integrity:sign-core`` is for Nextcloud core developers only. diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst index 50d43536328..dd22778010c 100644 --- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst +++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst @@ -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 `_). +- ``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 @@ -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 `_). +- ``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 ^^^^^^^^^^^^^^^ diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst index 03b9cd2a9e3..cea776931b7 100644 --- a/developer_manual/basics/logging.rst +++ b/developer_manual/basics/logging.rst @@ -301,7 +301,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 `_ +`admin audit log <../../admin_manual/configuration_server/logging_configuration.rst#admin-audit-log>`_ is the correct place. You can easily add a log by simply emitting an ``OCP\Log\Audit\CriticalActionPerformedEvent`` event: diff --git a/developer_manual/basics/setting.rst b/developer_manual/basics/setting.rst index 3a93091b30e..e15106ed58a 100644 --- 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 **/appinfo/info. `` instead. Additionally since Nextcloud 23, groups can be granted authorization to access individual -admin settings (`see admin docs `_). +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. diff --git a/developer_manual/client_apis/OCS/ocs-share-api.rst b/developer_manual/client_apis/OCS/ocs-share-api.rst index 2020e213278..d5c702f5930 100644 --- a/developer_manual/client_apis/OCS/ocs-share-api.rst +++ b/developer_manual/client_apis/OCS/ocs-share-api.rst @@ -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 `_. +enabled and configured. See `Configuring Federated Cloud Sharing <../../../admin_manual/configuration_files/federated_cloud_sharing_configuration.rst>`_. Create a new Federated Cloud Share ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/developer_manual/desktop/index.rst b/developer_manual/desktop/index.rst index 38811125f95..4421a14e28f 100644 --- a/developer_manual/desktop/index.rst +++ b/developer_manual/desktop/index.rst @@ -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/desktop/index.rst +.. _`Admin manual`: ../../admin_manual/desktop/index.rst diff --git a/developer_manual/digging_deeper/config/appconfig.rst b/developer_manual/digging_deeper/config/appconfig.rst index 6fd3e683e42..ae5313463d1 100644 --- a/developer_manual/digging_deeper/config/appconfig.rst +++ b/developer_manual/digging_deeper/config/appconfig.rst @@ -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: lexicon.rst#concept-overview AppFramework diff --git a/developer_manual/digging_deeper/config/userconfig.rst b/developer_manual/digging_deeper/config/userconfig.rst index cc21ba99ea8..3a74ce86698 100644 --- a/developer_manual/digging_deeper/config/userconfig.rst +++ b/developer_manual/digging_deeper/config/userconfig.rst @@ -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: lexicon.rst#concept-overview Typed Config Values diff --git a/developer_manual/digging_deeper/context_chat.rst b/developer_manual/digging_deeper/context_chat.rst index 462233dd56e..58c214da3c1 100644 --- a/developer_manual/digging_deeper/context_chat.rst +++ b/developer_manual/digging_deeper/context_chat.rst @@ -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 `_, -thereby enabling `Nextcloud Assistant `_ +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 diff --git a/developer_manual/exapp_development/faq/DockerSocketProxy.rst b/developer_manual/exapp_development/faq/DockerSocketProxy.rst index ada4e1af7a4..a602f9b97de 100644 --- a/developer_manual/exapp_development/faq/DockerSocketProxy.rst +++ b/developer_manual/exapp_development/faq/DockerSocketProxy.rst @@ -28,7 +28,7 @@ Nextcloud AIO implements its own `Docker Socket Proxy container `_ 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. .. note:: diff --git a/developer_manual/exapp_development/faq/Troubleshooting.rst b/developer_manual/exapp_development/faq/Troubleshooting.rst index 01188a532e5..90003200538 100644 --- a/developer_manual/exapp_development/faq/Troubleshooting.rst +++ b/developer_manual/exapp_development/faq/Troubleshooting.rst @@ -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 `_ 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: 1. Check Nextcloud logs diff --git a/developer_manual/exapp_development/tech_details/Translations.rst b/developer_manual/exapp_development/tech_details/Translations.rst index a0ee03a0f94..a5235b2e94e 100644 --- a/developer_manual/exapp_development/tech_details/Translations.rst +++ b/developer_manual/exapp_development/tech_details/Translations.rst @@ -43,7 +43,7 @@ You can then compile them to ``.mo`` files using `ui_example's `_ ``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//l10n/*.(js|json)``). This will allow the server to access the ExApp's strings with translations. diff --git a/developer_manual/exapp_development/tech_details/api/logging.rst b/developer_manual/exapp_development/tech_details/api/logging.rst index ad8aa31d3e6..28b394481d3 100644 --- a/developer_manual/exapp_development/tech_details/api/logging.rst +++ b/developer_manual/exapp_development/tech_details/api/logging.rst @@ -25,7 +25,7 @@ Request data } -The possible values of ``log_lvl`` are described here: `Nextcloud Log level `_ +The possible values of ``log_lvl`` are described here: `Nextcloud Log level <../../../../admin_manual/configuration_server/logging_configuration.rst#log-level>`_ Response data ************* diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst index db0e93f9248..58c966dae14 100644 --- a/developer_manual/getting_started/devenv.rst +++ b/developer_manual/getting_started/devenv.rst @@ -16,14 +16,14 @@ 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 `_ (**Section**: Manual Installation - Prerequisites). +First `set up your Web server and database <../../admin_manual/installation/index.rst>`_ (**Section**: Manual Installation - Prerequisites). Get the source -------------- There are two ways to obtain Nextcloud sources: -* Using the `stable version `_ +* Using the `stable version <../../admin_manual/installation/index.rst>`_ * Using the development version from `GitHub`_ which will be explained below. To check out the source from `GitHub`_ you will need to install Git (see `Setting up Git `_ from the GitHub help) diff --git a/user_manual/desktop/index.rst b/user_manual/desktop/index.rst index 909c017004c..2d4feb48518 100644 --- a/user_manual/desktop/index.rst +++ b/user_manual/desktop/index.rst @@ -25,5 +25,5 @@ For additional information, see: * `Admin manual`_ * `Developer manual`_ -.. _`Admin manual`: https://docs.nextcloud.com/server/latest/admin_manual/desktop/index.html -.. _`Developer manual`: https://docs.nextcloud.com/server/latest/developer_manual/desktop/index.html +.. _`Admin manual`: ../../admin_manual/desktop/index.rst +.. _`Developer manual`: ../../developer_manual/desktop/index.rst diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst index 7af7a6757bf..4885486ad4a 100644 --- a/user_manual/external_storage/external_storage.rst +++ b/user_manual/external_storage/external_storage.rst @@ -6,5 +6,5 @@ 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) -`_ in the Nextcloud Administrator's +<../../admin_manual/configuration_files/external_storage_configuration_gui.rst>`_ in the Nextcloud Administrator's manual for configuration how-tos and examples. diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index f181c132ccf..25707204784 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -222,7 +222,7 @@ path of your certificate as in this example:: Accessing files using macOS --------------------------- -.. note:: The macOS Finder suffers from a `series of implementation problems `_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck `_ (see instructions `here `_) and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. +.. note:: The macOS Finder suffers from a `series of implementation problems `_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck `_ (see instructions `here `_) and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. To access files through the macOS Finder: diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst index 6eb13a69e49..773e5d1de9e 100644 --- a/user_manual/files/deleted_file_management.rst +++ b/user_manual/files/deleted_file_management.rst @@ -56,4 +56,4 @@ Nextcloud will permanently delete those trashed files with the soonest expiratio until the space limit is met again. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `admin documentation `_ for more details. + to override the storage space management. See `admin documentation <../../admin_manual/configuration_server/config_sample_php_parameters.rst#deleted-items-trash-bin>`_ for more details. diff --git a/user_manual/files/encrypting_files.rst b/user_manual/files/encrypting_files.rst index 2cc3d38ea5c..71c77ff3b00 100644 --- a/user_manual/files/encrypting_files.rst +++ b/user_manual/files/encrypting_files.rst @@ -34,21 +34,21 @@ How can encryption be disabled? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The only way to disable encryption is to run the `"decrypt all" -`_ +<../../admin_manual/occ_command.rst#encryption-label>`_ script, which decrypts all files and disables encryption. Is it possible to disable encryption with the recovery key? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes, *if* every user uses the `file recovery key -`_, `"decrypt all" -`_ will use it to decrypt all files. +<../../admin_manual/configuration_files/encryption_configuration.rst#enabling-users-file-recovery-keys>`_, `"decrypt all" +<../../admin_manual/occ_command.rst#encryption-label>`_ will use it to decrypt all files. Can encryption be disabled without the user's password? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you don't have the users password or `file recovery key -`_, +<../../admin_manual/configuration_files/encryption_configuration.rst#enabling-users-file-recovery-keys>`_, then there is no way to decrypt all files. What's more, running it on login would be dangerous, because you would most likely run into timeouts. diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst index bce6c1efa86..11385a25575 100644 --- a/user_manual/files/large_file_upload.rst +++ b/user_manual/files/large_file_upload.rst @@ -9,5 +9,5 @@ Modifying certain Nextcloud variables requires administrative access. If you req * Contact your administrator to request an increase in these variables * Refer to the section in the `Administration Documentation - `_ that describes how to manage file + <../../admin_manual/configuration_files/big_file_upload_configuration.rst>`_ that describes how to manage file upload size limits. diff --git a/user_manual/files/quota.rst b/user_manual/files/quota.rst index 69c95b70a37..c3a0c0404e4 100644 --- a/user_manual/files/quota.rst +++ b/user_manual/files/quota.rst @@ -29,7 +29,7 @@ deleted files exceed 50% of quota then the oldest files are removed until the total is below 50%. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `administrator documentation `_ for more details. + to override the storage space management. See `administrator documentation <../../admin_manual/configuration_server/config_sample_php_parameters.rst#deleted-items-trash-bin>`_ for more details. When version control is enabled, the older file versions are not counted against quotas. diff --git a/user_manual/files/sharing.rst b/user_manual/files/sharing.rst index c4b8340c77b..dda88b7e733 100644 --- a/user_manual/files/sharing.rst +++ b/user_manual/files/sharing.rst @@ -12,7 +12,7 @@ Nextcloud users can share files and folders. Possible targets are: * users or groups on federated Nextcloud servers .. note:: Some options may not be available due to administrative configuration. - See `administrator documentation `__ for details. + See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.rst>`__ for details. Public link shares diff --git a/user_manual/files/transfer_ownership.rst b/user_manual/files/transfer_ownership.rst index df278aef99f..e903ea7669d 100644 --- a/user_manual/files/transfer_ownership.rst +++ b/user_manual/files/transfer_ownership.rst @@ -13,7 +13,7 @@ ownerships of those transferred files/folders will also be transferred. #. Click on *Transfer*. .. note:: The username autocompletion or listing may be limited due to administrative visibility configuration. - See `administrator documentation `_ for details. + See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.rst>`_ for details. #. The target user receives a notification where they are being asked whether to accept or reject the incoming transfer. diff --git a/user_manual/groupware/sync_gnome.rst b/user_manual/groupware/sync_gnome.rst index 4d42c58577a..a452566dc7a 100644 --- a/user_manual/groupware/sync_gnome.rst +++ b/user_manual/groupware/sync_gnome.rst @@ -15,7 +15,7 @@ This can be done by following these steps: #. Enter your server URL, username, and password. If you have enabled two-factor authentication (2FA), you need to generate an application password/token, because GNOME Online Accounts `doesn't support Nextcloud's WebFlow login yet `_ - (`Learn more `_): + (`Learn more <../session_management.rst#managing-devices>`_): .. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index 46165d7a12a..bcf469d788d 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -53,5 +53,5 @@ You should now find your contacts in the address book of your iPhone. If it's still not working, have a look at `Troubleshooting Contacts & Calendar`_ or `Troubleshooting Service Discovery`_. -.. _Troubleshooting Contacts & Calendar: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar -.. _Troubleshooting Service Discovery: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#service-discovery +.. _Troubleshooting Contacts & Calendar: ../../admin_manual/issues/general_troubleshooting.rst#troubleshooting-contacts-calendar +.. _Troubleshooting Service Discovery: ../../admin_manual/issues/general_troubleshooting.rst#service-discovery diff --git a/user_manual/groupware/sync_kde.rst b/user_manual/groupware/sync_kde.rst index 488f4261ce2..bcbf3c7ad0b 100644 --- a/user_manual/groupware/sync_kde.rst +++ b/user_manual/groupware/sync_kde.rst @@ -28,7 +28,7 @@ In Kalendar: In KOrganizer and Kalendar: -3. Enter your username. As password, you need to generate an app-password/token (`Learn more `_): +3. Enter your username. As password, you need to generate an app-password/token (`Learn more <../session_management.rst#managing-devices>`_): .. image:: ../images/korganizer_credentials.png From 4d438c76daa49ff50b22a23d6476ac30fa507335 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 24 Apr 2026 07:41:55 +0000 Subject: [PATCH 3/6] fix: resolve all broken links reported by lychee in feat/ci-lychee PR Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/ae18fa2c-5300-4ccd-9db7-6f2c00da3a4b Co-authored-by: nextcloud-command <88102737+nextcloud-command@users.noreply.github.com> Signed-off-by: skjnldsv --- .github/workflows/sphinxbuild.yml | 2 +- admin_manual/ai/overview.rst | 2 +- .../configuration_database/mysql_4byte_support.rst | 2 +- .../configuration_files/big_file_upload_configuration.rst | 6 +++--- admin_manual/configuration_files/encryption_details.rst | 2 +- .../configuration_files/external_storage/webdav.rst | 4 ++-- .../configuration_files/file_sharing_configuration.rst | 4 ++-- admin_manual/configuration_user/profile_configuration.rst | 2 +- admin_manual/configuration_user/two_factor-auth.rst | 4 ++-- admin_manual/desktop/index.rst | 4 ++-- admin_manual/index.rst | 4 ++-- admin_manual/installation/example_ubuntu.rst | 2 +- admin_manual/installation/harden_server.rst | 2 +- admin_manual/issues/general_troubleshooting.rst | 4 ++-- admin_manual/occ_apps.rst | 2 +- admin_manual/occ_files.rst | 4 ++-- admin_manual/office/configuration.rst | 2 +- .../app_upgrade_guide/upgrade_to_30.rst | 4 ++-- developer_manual/basics/logging.rst | 2 +- developer_manual/basics/setting.rst | 2 +- developer_manual/client_apis/OCS/ocs-share-api.rst | 2 +- developer_manual/desktop/index.rst | 4 ++-- developer_manual/digging_deeper/config/appconfig.rst | 2 +- developer_manual/digging_deeper/config/userconfig.rst | 2 +- developer_manual/digging_deeper/context_chat.rst | 4 ++-- .../exapp_development/faq/DockerSocketProxy.rst | 2 +- .../exapp_development/faq/Troubleshooting.rst | 2 +- .../exapp_development/tech_details/Translations.rst | 2 +- .../exapp_development/tech_details/api/logging.rst | 2 +- .../getting_started/coding_standards/index.rst | 2 +- developer_manual/getting_started/devenv.rst | 4 ++-- user_manual/desktop/index.rst | 4 ++-- user_manual/desktop/uninstallation.rst | 8 ++++---- user_manual/external_storage/external_storage.rst | 2 +- user_manual/files/access_webdav.rst | 2 +- user_manual/files/deleted_file_management.rst | 2 +- user_manual/files/encrypting_files.rst | 8 ++++---- user_manual/files/large_file_upload.rst | 2 +- user_manual/files/quota.rst | 2 +- user_manual/files/sharing.rst | 2 +- user_manual/files/transfer_ownership.rst | 2 +- user_manual/groupware/sync_gnome.rst | 2 +- user_manual/groupware/sync_ios.rst | 4 ++-- user_manual/groupware/sync_kde.rst | 2 +- 44 files changed, 65 insertions(+), 65 deletions(-) diff --git a/.github/workflows/sphinxbuild.yml b/.github/workflows/sphinxbuild.yml index 2ffe6f2e12a..675dc46361d 100644 --- a/.github/workflows/sphinxbuild.yml +++ b/.github/workflows/sphinxbuild.yml @@ -340,7 +340,7 @@ jobs: --root-dir "$(pwd)/stage" --offline --no-progress --remap "https://docs.nextcloud.com/server/ file://$(pwd)/stage/" - --exclude 'go\.php' --exclude 'mailto:' --exclude-path '.*/404\.html' + --exclude 'go\.php' --exclude 'mailto:' --exclude-path '.*/404\.html' --exclude-path '.*/_static/.*' --exclude "/user_manual/" --include "/user_manual/en/" --exclude '^file://.*/stage/(latest|stable|[0-9]+)/(developer_manual|admin_manual|user_manual)/?$' 'stage/${{ needs.stage-and-check.outputs.branch_name }}/user_manual/en/**/*.html' diff --git a/admin_manual/ai/overview.rst b/admin_manual/ai/overview.rst index 00ebce4f611..e01907343c4 100644 --- a/admin_manual/ai/overview.rst +++ b/admin_manual/ai/overview.rst @@ -118,7 +118,7 @@ Frontend apps * `Whiteboard `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Deck `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Nextcloud Office `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks in documents -* `Desktop Clients <../../user_manual/desktop/index.rst>`_ for simple "Chat with AI" +* `Desktop Clients <../../user_manual/desktop/index.html>`_ for simple "Chat with AI" Backend apps ~~~~~~~~~~~~ diff --git a/admin_manual/configuration_database/mysql_4byte_support.rst b/admin_manual/configuration_database/mysql_4byte_support.rst index 6196e611148..02c7cd0d2d0 100644 --- a/admin_manual/configuration_database/mysql_4byte_support.rst +++ b/admin_manual/configuration_database/mysql_4byte_support.rst @@ -13,7 +13,7 @@ installation needs to be tweaked a bit. This manual only covers MySQL 8 or newer and MariaDB 10.2 or newer. If you use MariaDB 10.2, please check - `this older version `_ + `this older version `_ of the documentation. If you use an older version of MySQL or MariaDB, please note that they are no longer supported by the current Nextcloud version. diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst index 1e0b8ae70fb..3d54ef8cd4f 100644 --- 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 -<../../developer_manual/client_apis/WebDAV/chunking.rst>`_ +<../../developer_manual/client_apis/WebDAV/chunking.html>`_ For those, PHP and webserver timeouts are the limiting factor on the upload size. Adjust these values for your needs. If you see PHP timeouts in your logfiles, @@ -160,7 +160,7 @@ Default is ``104857600`` (100 MiB). Large file upload on object storage ----------------------------------- -`Chunked file uploads <../../developer_manual/client_apis/WebDAV/chunking.rst>`_ +`Chunked file uploads <../../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 @@ -172,5 +172,5 @@ enough for PHP, webservers or any load balancers involved. Federated Cloud Sharing ----------------------- -If you are using `Federated Cloud Sharing `_ 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 `_ 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. diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst index dcf5eaa676d..eea844e9979 100644 --- 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 `_ -- `Nextcloud Encryption Configuration documentation `_ +- `Nextcloud Encryption Configuration documentation `_ - `Nextcloud Help response concerning the usage of version information `_ - `Sourcecode: Creation of the Message Authentication Code `_ - `Sourcecode: Derivation of the Encryption Key `_ diff --git a/admin_manual/configuration_files/external_storage/webdav.rst b/admin_manual/configuration_files/external_storage/webdav.rst index e8d58057c15..b42e4afbdc5 100644 --- a/admin_manual/configuration_files/external_storage/webdav.rst +++ b/admin_manual/configuration_files/external_storage/webdav.rst @@ -10,8 +10,8 @@ You need the following information: * Folder name: The name of your local mountpoint. * The URL of the WebDAV or Nextcloud server. * Username and password for the remote server -* Secure https://: We always recommend https:// for security, though you can - leave this unchecked for http://. +* Secure ``https://``: We always recommend ``https://`` for security, though you can + leave this unchecked for ``http://``. Optionally, a ``Remote Subfolder`` can be specified to change the destination directory. The default is to use the whole root. diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index fce2760a255..be57ac933c0 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -98,7 +98,7 @@ forcing them. `_ for discussion of this. .. note:: There are more sharing options on config.php level available: - `Configuration Parameters <../configuration_server/config_sample_php_parameters.rst#sharing>`_ + `Configuration Parameters <../configuration_server/config_sample_php_parameters.html#sharing>`_ .. _transfer_userfiles_label: @@ -174,7 +174,7 @@ Trashbin contents are not transferred:: reference.) Users may also transfer files or folders selectively by themselves. -See `user documentation <../../user_manual/files/transfer_ownership.rst>`_ for details. +See `user documentation <../../user_manual/files/transfer_ownership.html>`_ for details. Creating persistent file Shares diff --git a/admin_manual/configuration_user/profile_configuration.rst b/admin_manual/configuration_user/profile_configuration.rst index 45acc192d87..354147e0062 100644 --- a/admin_manual/configuration_user/profile_configuration.rst +++ b/admin_manual/configuration_user/profile_configuration.rst @@ -420,5 +420,5 @@ See also -------- - :doc:`../configuration_files/file_sharing_configuration` — sharing and autocomplete settings that interact with profile visibility -- `User manual: Personal settings <../../user_manual/userpreferences.rst>`_ — user-facing profile and personal info settings +- `User manual: Personal settings <../../user_manual/userpreferences.html>`_ — user-facing profile and personal info settings diff --git a/admin_manual/configuration_user/two_factor-auth.rst b/admin_manual/configuration_user/two_factor-auth.rst index eb9cec073bd..d9f88935870 100644 --- a/admin_manual/configuration_user/two_factor-auth.rst +++ b/admin_manual/configuration_user/two_factor-auth.rst @@ -46,13 +46,13 @@ 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 <../../developer_manual/digging_deeper/two-factor-provider.rst>`_. +apps <../../developer_manual/digging_deeper/two-factor-provider.html>`_. 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 <../../user_manual/user_2fa.rst>`_. +it for their account `under their personal settings <../../user_manual/user_2fa.html>`_. Admins may, however, enforce the use of 2FA. Enforcement is possible system-wide (all users) or for selected groups only. Select groups diff --git a/admin_manual/desktop/index.rst b/admin_manual/desktop/index.rst index 70c07600f99..f30ab34d7ac 100644 --- a/admin_manual/desktop/index.rst +++ b/admin_manual/desktop/index.rst @@ -22,5 +22,5 @@ You can find additional information here: * `User manual`_ * `Developer manual`_ -.. _`User manual`: ../../user_manual/desktop/index.rst -.. _`Developer manual`: ../../developer_manual/desktop/index.rst +.. _`User manual`: ../../user_manual/desktop/index.html +.. _`Developer manual`: ../../developer_manual/desktop/index.html diff --git a/admin_manual/index.rst b/admin_manual/index.rst index aeed5c75e46..0267cdaf746 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -25,13 +25,13 @@ For documentation on Nextcloud web, desktop, or mobile clients, see: - `Nextcloud User Manual`_ - `Nextcloud Desktop Client`_ -.. _`Nextcloud User Manual`: ../user_manual/index.rst +.. _`Nextcloud User Manual`: ../user_manual/index.html .. _`Nextcloud Desktop Client`: https://docs.nextcloud.com/desktop/latest/ For documentation on development topics, see: - The individual repositories on GitHub within `the @nextcloud organization `_ -- `Nextcloud Development Manual <../developer_manual/index.rst>`_ +- `Nextcloud Development Manual <../developer_manual/index.html>`_ Core Components --------------- diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst index 02f214f5849..0394ec38e4d 100644 --- 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 `_ for details. + require additional packages. See `Prerequisites for manual installation `_ for details. Now you need to create a database user and the database itself by using the MySQL command line interface. The database tables will be created by Nextcloud diff --git a/admin_manual/installation/harden_server.rst b/admin_manual/installation/harden_server.rst index edab8d2e644..b96218c2b24 100644 --- a/admin_manual/installation/harden_server.rst +++ b/admin_manual/installation/harden_server.rst @@ -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): ../configuration_server/config_sample_php_parameters.rst#has-internet-connection +.. _optional (config): ../configuration_server/config_sample_php_parameters.html#has-internet-connection .. _detailed field list: https://github.com/nextcloud/survey_client diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index 8c46f58346d..06c6eb9725c 100644 --- 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: ../../developer_manual/prologue/bugtracker/index.rst +.. _bugtracker: ../../developer_manual/prologue/bugtracker/index.html General troubleshooting ----------------------- @@ -411,7 +411,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 <../../user_manual/files/quota.rst>`_ for details. + Please refer to the `quota documentation <../../user_manual/files/quota.html>`_ for details. Running the following command can help fix the sizes and quota for a given user:: diff --git a/admin_manual/occ_apps.rst b/admin_manual/occ_apps.rst index 9307bd9894b..c4911bf8db1 100644 --- a/admin_manual/occ_apps.rst +++ b/admin_manual/occ_apps.rst @@ -157,7 +157,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: ../developer_manual/digging_deeper/config/appconfig.rst#concept-overview +.. _Appconfig Concepts: ../developer_manual/digging_deeper/config/appconfig.html#concept-overview You can list all configuration values with one command:: diff --git a/admin_manual/occ_files.rst b/admin_manual/occ_files.rst index 452b6209186..f20243b0aad 100644 --- a/admin_manual/occ_files.rst +++ b/admin_manual/occ_files.rst @@ -336,7 +336,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 Users may also transfer files or folders selectively by themselves. -See `user documentation <../user_manual/files/transfer_ownership.rst>`_ for details. +See `user documentation <../user_manual/files/transfer_ownership.html>`_ for details. .. _occ_files_windows_filenames: @@ -427,7 +427,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 -<../developer_manual/app_publishing_maintenance/code_signing.rst#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information. +<../developer_manual/app_publishing_maintenance/code_signing.html#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information. ``integrity:sign-core`` is for Nextcloud core developers only. diff --git a/admin_manual/office/configuration.rst b/admin_manual/office/configuration.rst index 841af5a8628..76fd712a947 100644 --- a/admin_manual/office/configuration.rst +++ b/admin_manual/office/configuration.rst @@ -8,7 +8,7 @@ Nextcloud Office App Settings Collabora Online Server *********************** -URL (and port) of the Collabora Online server that provides the editing functionality as a WOPI client. Collabora Online should use the same protocol (http:// or https://) as the server installation. Naturally, https:// is recommended. +URL (and port) of the Collabora Online server that provides the editing functionality as a WOPI client. Collabora Online should use the same protocol (``http://`` or ``https://``) as the server installation. Naturally, ``https://`` is recommended. Restrict usage to specific groups ********************************* diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst index dd22778010c..763fdc37e94 100644 --- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst +++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst @@ -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 <../../../admin_manual/webhook_listeners/index.rst>`_). +- ``OCP\EventDispatcher\IWebhookCompatibleEvent`` is a new interface for events compatible with webhooks (`see webhook_listeners documentation <../../../admin_manual/webhook_listeners/index.html>`_). - ``OCP\EventDispatcher\JsonSerializer`` is a new public helper for serializing users and fileinfos to json (ie for webhook events) Changed APIs @@ -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 <../../../admin_manual/webhook_listeners/index.rst>`_). +- ``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.html>`_). Deprecated APIs ^^^^^^^^^^^^^^^ diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst index cea776931b7..2e1d5a67a60 100644 --- a/developer_manual/basics/logging.rst +++ b/developer_manual/basics/logging.rst @@ -301,7 +301,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 <../../admin_manual/configuration_server/logging_configuration.rst#admin-audit-log>`_ +`admin audit log <../../admin_manual/configuration_server/logging_configuration.html#admin-audit-log>`_ is the correct place. You can easily add a log by simply emitting an ``OCP\Log\Audit\CriticalActionPerformedEvent`` event: diff --git a/developer_manual/basics/setting.rst b/developer_manual/basics/setting.rst index e15106ed58a..4bb1271d7dd 100644 --- 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 **/appinfo/info. `` instead. Additionally since Nextcloud 23, groups can be granted authorization to access individual -admin settings (`see admin docs <../../admin_manual/configuration_server/admin_delegation_configuration.rst>`_). +admin settings (`see admin docs <../../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 index d5c702f5930..c3d8b8d40f9 100644 --- a/developer_manual/client_apis/OCS/ocs-share-api.rst +++ b/developer_manual/client_apis/OCS/ocs-share-api.rst @@ -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 <../../../admin_manual/configuration_files/federated_cloud_sharing_configuration.rst>`_. +enabled and configured. See `Configuring Federated Cloud Sharing <../../../admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_. Create a new Federated Cloud Share ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/developer_manual/desktop/index.rst b/developer_manual/desktop/index.rst index 4421a14e28f..18e30b382c6 100644 --- a/developer_manual/desktop/index.rst +++ b/developer_manual/desktop/index.rst @@ -21,5 +21,5 @@ You can find additional information here: * `User manual`_ * `Admin manual`_ -.. _`User manual`: ../../user_manual/desktop/index.rst -.. _`Admin manual`: ../../admin_manual/desktop/index.rst +.. _`User manual`: ../../user_manual/desktop/index.html +.. _`Admin manual`: ../../admin_manual/desktop/index.html diff --git a/developer_manual/digging_deeper/config/appconfig.rst b/developer_manual/digging_deeper/config/appconfig.rst index ae5313463d1..cf364a3cbd4 100644 --- a/developer_manual/digging_deeper/config/appconfig.rst +++ b/developer_manual/digging_deeper/config/appconfig.rst @@ -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: lexicon.rst#concept-overview +.. _Lexicon Concepts: lexicon.html#concept-overview AppFramework diff --git a/developer_manual/digging_deeper/config/userconfig.rst b/developer_manual/digging_deeper/config/userconfig.rst index 3a74ce86698..86308d31636 100644 --- a/developer_manual/digging_deeper/config/userconfig.rst +++ b/developer_manual/digging_deeper/config/userconfig.rst @@ -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: lexicon.rst#concept-overview +.. _Lexicon Concepts: lexicon.html#concept-overview Typed Config Values diff --git a/developer_manual/digging_deeper/context_chat.rst b/developer_manual/digging_deeper/context_chat.rst index 58c214da3c1..5c0b9da4c92 100644 --- a/developer_manual/digging_deeper/context_chat.rst +++ b/developer_manual/digging_deeper/context_chat.rst @@ -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 <../../admin_manual/ai/app_context_chat.rst>`_, -thereby enabling `Nextcloud Assistant <../../admin_manual/ai/app_assistant.rst>`_ +to the `Nextcloud Assistant Context Chat <../../admin_manual/ai/app_context_chat.html>`_, +thereby enabling `Nextcloud Assistant <../../admin_manual/ai/app_assistant.html>`_ to answer questions, provide insights and search results based on the submitted data and natural language queries. Implementing a content provider for Context Chat diff --git a/developer_manual/exapp_development/faq/DockerSocketProxy.rst b/developer_manual/exapp_development/faq/DockerSocketProxy.rst index a602f9b97de..a5ed18858a7 100644 --- a/developer_manual/exapp_development/faq/DockerSocketProxy.rst +++ b/developer_manual/exapp_development/faq/DockerSocketProxy.rst @@ -28,7 +28,7 @@ Nextcloud AIO implements its own `Docker Socket Proxy container `_ for more details. +See `Nextcloud in Docker AIO (all-in-one) <../../../admin_manual/exapps_management/DeployConfigurations.html#nextcloud-in-docker-aio-all-in-one>`_ for more details. .. note:: diff --git a/developer_manual/exapp_development/faq/Troubleshooting.rst b/developer_manual/exapp_development/faq/Troubleshooting.rst index 90003200538..6598f9f29e7 100644 --- a/developer_manual/exapp_development/faq/Troubleshooting.rst +++ b/developer_manual/exapp_development/faq/Troubleshooting.rst @@ -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 <../../../admin_manual/exapps_management/TestDeploy.rst>`_ section of the administration guide. +The deployment issues questions are covered in the `Test Deploy <../../../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: 1. Check Nextcloud logs diff --git a/developer_manual/exapp_development/tech_details/Translations.rst b/developer_manual/exapp_development/tech_details/Translations.rst index a5235b2e94e..f7bdb6e71af 100644 --- a/developer_manual/exapp_development/tech_details/Translations.rst +++ b/developer_manual/exapp_development/tech_details/Translations.rst @@ -43,7 +43,7 @@ You can then compile them to ``.mo`` files using `ui_example's `_ ``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.html#apps-paths>`_ ``l10n`` folder of the ExApp (e.g. ``/path/to/apps-writable//l10n/*.(js|json)``). This will allow the server to access the ExApp's strings with translations. diff --git a/developer_manual/exapp_development/tech_details/api/logging.rst b/developer_manual/exapp_development/tech_details/api/logging.rst index 28b394481d3..35601054bea 100644 --- a/developer_manual/exapp_development/tech_details/api/logging.rst +++ b/developer_manual/exapp_development/tech_details/api/logging.rst @@ -25,7 +25,7 @@ Request data } -The possible values of ``log_lvl`` are described here: `Nextcloud Log level <../../../../admin_manual/configuration_server/logging_configuration.rst#log-level>`_ +The possible values of ``log_lvl`` are described here: `Nextcloud Log level <../../../../admin_manual/configuration_server/logging_configuration.html#log-level>`_ Response data ************* diff --git a/developer_manual/getting_started/coding_standards/index.rst b/developer_manual/getting_started/coding_standards/index.rst index 45a0e3d56ac..515bad0a7c1 100644 --- a/developer_manual/getting_started/coding_standards/index.rst +++ b/developer_manual/getting_started/coding_standards/index.rst @@ -16,7 +16,7 @@ General You describe what you want to do, ask feedback on the direction you take it and take it from there. * When you are finished, use the merge request function on GitHub to create a pull request. The other developers will look at it and give you feedback. You can signify that your PR is ready for review by adding the label "3. to review" to it. - See `the code review page for more information <../prologue/bugtracker/codereviews.html>`_ + See `the code review page for more information <../../prologue/bugtracker/codereviews.html>`_ * It is key to keep changes separate and small. The bigger and more hairy a PR grows, the harder it is to get it in. So split things up where you can in smaller changes - if you need a small improvement like a API addition for a big feature addition, get it in first rather than adding it to the big piece of work! * Decisions are made by consensus. We strive for making the best technical decisions and as nobody can know everything, we collaborate. diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst index 58c966dae14..d3b769d8719 100644 --- a/developer_manual/getting_started/devenv.rst +++ b/developer_manual/getting_started/devenv.rst @@ -16,14 +16,14 @@ 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 <../../admin_manual/installation/index.rst>`_ (**Section**: Manual Installation - Prerequisites). +First `set up your Web server and database <../../admin_manual/installation/index.html>`_ (**Section**: Manual Installation - Prerequisites). Get the source -------------- There are two ways to obtain Nextcloud sources: -* Using the `stable version <../../admin_manual/installation/index.rst>`_ +* Using the `stable version <../../admin_manual/installation/index.html>`_ * Using the development version from `GitHub`_ which will be explained below. To check out the source from `GitHub`_ you will need to install Git (see `Setting up Git `_ from the GitHub help) diff --git a/user_manual/desktop/index.rst b/user_manual/desktop/index.rst index 2d4feb48518..66614fdb4ca 100644 --- a/user_manual/desktop/index.rst +++ b/user_manual/desktop/index.rst @@ -25,5 +25,5 @@ For additional information, see: * `Admin manual`_ * `Developer manual`_ -.. _`Admin manual`: ../../admin_manual/desktop/index.rst -.. _`Developer manual`: ../../developer_manual/desktop/index.rst +.. _`Admin manual`: ../../admin_manual/desktop/index.html +.. _`Developer manual`: ../../developer_manual/desktop/index.html diff --git a/user_manual/desktop/uninstallation.rst b/user_manual/desktop/uninstallation.rst index 8fc9b379779..105ff24e882 100644 --- a/user_manual/desktop/uninstallation.rst +++ b/user_manual/desktop/uninstallation.rst @@ -12,7 +12,7 @@ In each operating system: 2. *Uninstall* the desktop client. -3. You may also need to take into consideration that uninstalling the desktop client will not remove the `user's configuration `_ file and synced data. +3. You may also need to take into consideration that uninstalling the desktop client will not remove the `user's configuration `_ file and synced data. For data removal (sync folders), consider using the server feature `remote wipe `_. This feature is available across all clients. @@ -30,7 +30,7 @@ There are two ways of removing the desktop client: msiexec /uninstall Nextcloud-x.y.z-x64.msi /quiet`` -3. The `user's configuration `_ is located at ``%APPDATA%\Nextcloud\nextcloud.cfg``. +3. The `user's configuration `_ is located at ``%APPDATA%\Nextcloud\nextcloud.cfg``. macOS ^^^^^ @@ -53,7 +53,7 @@ Beyond deleting the desktop client from the *Applications* folder, you may also rm -rf "$HOME/Library/Preferences/Nextcloud" rm -f "$HOME/Library/Preferences/com.nextcloud.desktopclient.plist" -3. From version 33.0.0 the `user's configuration `_ is located at ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``. +3. From version 33.0.0 the `user's configuration `_ is located at ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``. On older versions it is located at ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg``. Linux @@ -68,5 +68,5 @@ It depends on how you installed the desktop client: sudo apt remove nextcloud-desktop -3. The `user's configuration `_ is located at *$HOME/.config/Nextcloud/nextcloud.cfg*. +3. The `user's configuration `_ is located at *$HOME/.config/Nextcloud/nextcloud.cfg*. diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst index 4885486ad4a..70d51f576b8 100644 --- a/user_manual/external_storage/external_storage.rst +++ b/user_manual/external_storage/external_storage.rst @@ -6,5 +6,5 @@ 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) -<../../admin_manual/configuration_files/external_storage_configuration_gui.rst>`_ in the Nextcloud Administrator's +<../../admin_manual/configuration_files/external_storage_configuration_gui.html>`_ in the Nextcloud Administrator's manual for configuration how-tos and examples. diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 25707204784..4fdcc63eeee 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -222,7 +222,7 @@ path of your certificate as in this example:: Accessing files using macOS --------------------------- -.. note:: The macOS Finder suffers from a `series of implementation problems `_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck `_ (see instructions `here `_) and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. +.. note:: The macOS Finder suffers from a `series of implementation problems `_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck `_ (see instructions `here <#accessing-files-using-cyberduck>`_) and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. To access files through the macOS Finder: diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst index 773e5d1de9e..52f730bb5f7 100644 --- a/user_manual/files/deleted_file_management.rst +++ b/user_manual/files/deleted_file_management.rst @@ -56,4 +56,4 @@ Nextcloud will permanently delete those trashed files with the soonest expiratio until the space limit is met again. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `admin documentation <../../admin_manual/configuration_server/config_sample_php_parameters.rst#deleted-items-trash-bin>`_ for more details. + to override the storage space management. See `admin documentation <../../admin_manual/configuration_server/config_sample_php_parameters.html#deleted-items-trash-bin>`_ for more details. diff --git a/user_manual/files/encrypting_files.rst b/user_manual/files/encrypting_files.rst index 71c77ff3b00..0a51b85e218 100644 --- a/user_manual/files/encrypting_files.rst +++ b/user_manual/files/encrypting_files.rst @@ -34,21 +34,21 @@ How can encryption be disabled? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The only way to disable encryption is to run the `"decrypt all" -<../../admin_manual/occ_command.rst#encryption-label>`_ +<../../admin_manual/occ_command.html#encryption-label>`_ script, which decrypts all files and disables encryption. Is it possible to disable encryption with the recovery key? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes, *if* every user uses the `file recovery key -<../../admin_manual/configuration_files/encryption_configuration.rst#enabling-users-file-recovery-keys>`_, `"decrypt all" -<../../admin_manual/occ_command.rst#encryption-label>`_ will use it to decrypt all files. +<../../admin_manual/configuration_files/encryption_configuration.html#enabling-users-file-recovery-keys>`_, `"decrypt all" +<../../admin_manual/occ_command.html#encryption-label>`_ will use it to decrypt all files. Can encryption be disabled without the user's password? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you don't have the users password or `file recovery key -<../../admin_manual/configuration_files/encryption_configuration.rst#enabling-users-file-recovery-keys>`_, +<../../admin_manual/configuration_files/encryption_configuration.html#enabling-users-file-recovery-keys>`_, then there is no way to decrypt all files. What's more, running it on login would be dangerous, because you would most likely run into timeouts. diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst index 11385a25575..2d5cd8273a4 100644 --- a/user_manual/files/large_file_upload.rst +++ b/user_manual/files/large_file_upload.rst @@ -9,5 +9,5 @@ Modifying certain Nextcloud variables requires administrative access. If you req * Contact your administrator to request an increase in these variables * Refer to the section in the `Administration Documentation - <../../admin_manual/configuration_files/big_file_upload_configuration.rst>`_ that describes how to manage file + <../../admin_manual/configuration_files/big_file_upload_configuration.html>`_ that describes how to manage file upload size limits. diff --git a/user_manual/files/quota.rst b/user_manual/files/quota.rst index c3a0c0404e4..3239b1c18e4 100644 --- a/user_manual/files/quota.rst +++ b/user_manual/files/quota.rst @@ -29,7 +29,7 @@ deleted files exceed 50% of quota then the oldest files are removed until the total is below 50%. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `administrator documentation <../../admin_manual/configuration_server/config_sample_php_parameters.rst#deleted-items-trash-bin>`_ for more details. + to override the storage space management. See `administrator documentation <../../admin_manual/configuration_server/config_sample_php_parameters.html#deleted-items-trash-bin>`_ for more details. When version control is enabled, the older file versions are not counted against quotas. diff --git a/user_manual/files/sharing.rst b/user_manual/files/sharing.rst index dda88b7e733..a46543a6b3c 100644 --- a/user_manual/files/sharing.rst +++ b/user_manual/files/sharing.rst @@ -12,7 +12,7 @@ Nextcloud users can share files and folders. Possible targets are: * users or groups on federated Nextcloud servers .. note:: Some options may not be available due to administrative configuration. - See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.rst>`__ for details. + See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.html>`__ for details. Public link shares diff --git a/user_manual/files/transfer_ownership.rst b/user_manual/files/transfer_ownership.rst index e903ea7669d..63bdf6cc8ba 100644 --- a/user_manual/files/transfer_ownership.rst +++ b/user_manual/files/transfer_ownership.rst @@ -13,7 +13,7 @@ ownerships of those transferred files/folders will also be transferred. #. Click on *Transfer*. .. note:: The username autocompletion or listing may be limited due to administrative visibility configuration. - See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.rst>`_ for details. + See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.html>`_ for details. #. The target user receives a notification where they are being asked whether to accept or reject the incoming transfer. diff --git a/user_manual/groupware/sync_gnome.rst b/user_manual/groupware/sync_gnome.rst index a452566dc7a..10240ef4829 100644 --- a/user_manual/groupware/sync_gnome.rst +++ b/user_manual/groupware/sync_gnome.rst @@ -15,7 +15,7 @@ This can be done by following these steps: #. Enter your server URL, username, and password. If you have enabled two-factor authentication (2FA), you need to generate an application password/token, because GNOME Online Accounts `doesn't support Nextcloud's WebFlow login yet `_ - (`Learn more <../session_management.rst#managing-devices>`_): + (`Learn more <../session_management.html#managing-devices>`_): .. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index bcf469d788d..000da89e78a 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -53,5 +53,5 @@ You should now find your contacts in the address book of your iPhone. If it's still not working, have a look at `Troubleshooting Contacts & Calendar`_ or `Troubleshooting Service Discovery`_. -.. _Troubleshooting Contacts & Calendar: ../../admin_manual/issues/general_troubleshooting.rst#troubleshooting-contacts-calendar -.. _Troubleshooting Service Discovery: ../../admin_manual/issues/general_troubleshooting.rst#service-discovery +.. _Troubleshooting Contacts & Calendar: ../../admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar +.. _Troubleshooting Service Discovery: ../../admin_manual/issues/general_troubleshooting.html#service-discovery diff --git a/user_manual/groupware/sync_kde.rst b/user_manual/groupware/sync_kde.rst index bcbf3c7ad0b..31a37e977bb 100644 --- a/user_manual/groupware/sync_kde.rst +++ b/user_manual/groupware/sync_kde.rst @@ -28,7 +28,7 @@ In Kalendar: In KOrganizer and Kalendar: -3. Enter your username. As password, you need to generate an app-password/token (`Learn more <../session_management.rst#managing-devices>`_): +3. Enter your username. As password, you need to generate an app-password/token (`Learn more <../session_management.html#managing-devices>`_): .. image:: ../images/korganizer_credentials.png From 51eaa50b7416c5c56bb918a16dd0f0a99eef931f Mon Sep 17 00:00:00 2001 From: skjnldsv Date: Fri, 24 Apr 2026 10:15:06 +0200 Subject: [PATCH 4/6] fix(admin_manual): cleaner db requirements note Signed-off-by: skjnldsv --- .../configuration_database/mysql_4byte_support.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/admin_manual/configuration_database/mysql_4byte_support.rst b/admin_manual/configuration_database/mysql_4byte_support.rst index 02c7cd0d2d0..dcc50034550 100644 --- a/admin_manual/configuration_database/mysql_4byte_support.rst +++ b/admin_manual/configuration_database/mysql_4byte_support.rst @@ -11,11 +11,9 @@ installation needs to be tweaked a bit. .. warning:: - This manual only covers MySQL 8 or newer and MariaDB 10.2 or newer. - If you use MariaDB 10.2, please check - `this older version `_ - of the documentation. If you use an older version of MySQL or MariaDB, please note that they are no longer supported - by the current Nextcloud version. + This guide applies only to MySQL 8 or newer and MariaDB 10.6 or newer. + For a list of supported MySQL and MariaDB versions, see our + `system requirements documentation <../installation/system_requirements.html>`. 1. Make sure the following InnoDB settings are set on your MySQL server:: From 612fb51b9921e6512277f58c98a2f6c7a3a64205 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 24 Apr 2026 09:19:23 +0000 Subject: [PATCH 5/6] fix: use absolute URLs for cross-manual links to fix PDF navigation Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/0eeab2cf-94b4-4068-b59b-d8eae342c840 Co-authored-by: nextcloud-command <88102737+nextcloud-command@users.noreply.github.com> Signed-off-by: skjnldsv --- admin_manual/ai/overview.rst | 2 +- .../configuration_database/mysql_4byte_support.rst | 2 +- .../configuration_files/big_file_upload_configuration.rst | 6 +++--- .../configuration_files/encryption_configuration.rst | 2 +- admin_manual/configuration_files/encryption_details.rst | 2 +- .../configuration_files/file_sharing_configuration.rst | 4 ++-- .../configuration_server/config_sample_php_parameters.rst | 2 +- admin_manual/configuration_user/profile_configuration.rst | 2 +- admin_manual/configuration_user/two_factor-auth.rst | 4 ++-- admin_manual/desktop/index.rst | 4 ++-- admin_manual/index.rst | 4 ++-- admin_manual/installation/example_ubuntu.rst | 2 +- admin_manual/installation/harden_server.rst | 2 +- admin_manual/issues/general_troubleshooting.rst | 4 ++-- admin_manual/occ_apps.rst | 2 +- admin_manual/occ_files.rst | 4 ++-- .../app_upgrade_guide/upgrade_to_30.rst | 4 ++-- .../app_publishing_maintenance/publishing.rst | 2 +- developer_manual/basics/controllers.rst | 2 +- developer_manual/basics/logging.rst | 2 +- developer_manual/basics/setting.rst | 2 +- developer_manual/basics/storage/filesystem.rst | 2 +- developer_manual/client_apis/OCS/ocs-share-api.rst | 2 +- developer_manual/desktop/index.rst | 4 ++-- developer_manual/digging_deeper/config/appconfig.rst | 4 +--- developer_manual/digging_deeper/config/lexicon.rst | 2 ++ developer_manual/digging_deeper/config/userconfig.rst | 4 +--- developer_manual/digging_deeper/context_chat.rst | 4 ++-- .../exapp_development/faq/DockerSocketProxy.rst | 2 +- .../exapp_development/faq/Troubleshooting.rst | 2 +- .../exapp_development/tech_details/Translations.rst | 2 +- .../exapp_development/tech_details/api/logging.rst | 2 +- .../getting_started/coding_standards/index.rst | 2 +- developer_manual/getting_started/devenv.rst | 4 ++-- user_manual/desktop/index.rst | 4 ++-- user_manual/desktop/uninstallation.rst | 8 ++++---- user_manual/external_storage/external_storage.rst | 2 +- user_manual/files/access_webdav.rst | 3 +-- user_manual/files/deleted_file_management.rst | 2 +- user_manual/files/encrypting_files.rst | 8 ++++---- user_manual/files/large_file_upload.rst | 2 +- user_manual/files/quota.rst | 2 +- user_manual/files/sharing.rst | 2 +- user_manual/files/transfer_ownership.rst | 2 +- user_manual/groupware/sync_android.rst | 2 +- user_manual/groupware/sync_gnome.rst | 2 +- user_manual/groupware/sync_ios.rst | 4 ++-- user_manual/groupware/sync_kde.rst | 2 +- 48 files changed, 69 insertions(+), 72 deletions(-) diff --git a/admin_manual/ai/overview.rst b/admin_manual/ai/overview.rst index e01907343c4..f275d91ec38 100644 --- a/admin_manual/ai/overview.rst +++ b/admin_manual/ai/overview.rst @@ -118,7 +118,7 @@ Frontend apps * `Whiteboard `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Deck `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks * `Nextcloud Office `_ integrating Assistant through the smart picker to offer a graphical UI for the various tasks in documents -* `Desktop Clients <../../user_manual/desktop/index.html>`_ for simple "Chat with AI" +* `Desktop Clients `_ for simple "Chat with AI" Backend apps ~~~~~~~~~~~~ diff --git a/admin_manual/configuration_database/mysql_4byte_support.rst b/admin_manual/configuration_database/mysql_4byte_support.rst index dcc50034550..bb1cea4744d 100644 --- a/admin_manual/configuration_database/mysql_4byte_support.rst +++ b/admin_manual/configuration_database/mysql_4byte_support.rst @@ -13,7 +13,7 @@ installation needs to be tweaked a bit. This guide applies only to MySQL 8 or newer and MariaDB 10.6 or newer. For a list of supported MySQL and MariaDB versions, see our - `system requirements documentation <../installation/system_requirements.html>`. + :doc:`system requirements documentation <../installation/system_requirements>`. 1. Make sure the following InnoDB settings are set on your MySQL server:: diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst index 3d54ef8cd4f..b124507eeb0 100644 --- 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 -<../../developer_manual/client_apis/WebDAV/chunking.html>`_ +`_ For those, PHP and webserver timeouts are the limiting factor on the upload size. Adjust these values for your needs. If you see PHP timeouts in your logfiles, @@ -160,7 +160,7 @@ Default is ``104857600`` (100 MiB). Large file upload on object storage ----------------------------------- -`Chunked file uploads <../../developer_manual/client_apis/WebDAV/chunking.html>`_ +`Chunked file uploads `_ 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 @@ -172,5 +172,5 @@ enough for PHP, webservers or any load balancers involved. Federated Cloud Sharing ----------------------- -If you are using `Federated Cloud Sharing `_ and want to share large files, you can increase the timeout values for requests to the federated servers. +If you are using :doc:`Federated Cloud Sharing ` 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. diff --git a/admin_manual/configuration_files/encryption_configuration.rst b/admin_manual/configuration_files/encryption_configuration.rst index 0ca99e78751..298177ec1b0 100644 --- a/admin_manual/configuration_files/encryption_configuration.rst +++ b/admin_manual/configuration_files/encryption_configuration.rst @@ -389,6 +389,6 @@ Further Reading - :ref:`occ Command Reference: Encryption ` - `How Nextcloud uses encryption to protect your data `_ - `Technical impact of Authenticated Encryption `_ -- `Nextcloud SSE Implementation Details `_ +- :doc:`Nextcloud SSE Implementation Details ` - `Nextcloud Encryption (SSE & E2EE) Recovery Tools `_ - `Nextcloud E2EE Server API App (required for E2EE usage) `_ diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst index eea844e9979..2fb779f9326 100644 --- 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 `_ -- `Nextcloud Encryption Configuration documentation `_ +- :doc:`Nextcloud Encryption Configuration documentation ` - `Nextcloud Help response concerning the usage of version information `_ - `Sourcecode: Creation of the Message Authentication Code `_ - `Sourcecode: Derivation of the Encryption Key `_ diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index be57ac933c0..da97e6c8b2f 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -98,7 +98,7 @@ forcing them. `_ for discussion of this. .. note:: There are more sharing options on config.php level available: - `Configuration Parameters <../configuration_server/config_sample_php_parameters.html#sharing>`_ + :doc:`Configuration Parameters <../configuration_server/config_sample_php_parameters>` .. _transfer_userfiles_label: @@ -174,7 +174,7 @@ Trashbin contents are not transferred:: reference.) Users may also transfer files or folders selectively by themselves. -See `user documentation <../../user_manual/files/transfer_ownership.html>`_ for details. +See `user documentation `_ for details. Creating persistent file Shares diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 00f8800fadf..08745aeb84a 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -1074,7 +1074,7 @@ Enable SMTP class debugging. .. note:: ``loglevel`` will likely need to be adjusted too. See docs: - email_configuration.rst#enabling-debug-mode + https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/email_configuration.html#enabling-debug-mode Defaults to ``false`` diff --git a/admin_manual/configuration_user/profile_configuration.rst b/admin_manual/configuration_user/profile_configuration.rst index 354147e0062..00ba8a1d409 100644 --- a/admin_manual/configuration_user/profile_configuration.rst +++ b/admin_manual/configuration_user/profile_configuration.rst @@ -420,5 +420,5 @@ See also -------- - :doc:`../configuration_files/file_sharing_configuration` — sharing and autocomplete settings that interact with profile visibility -- `User manual: Personal settings <../../user_manual/userpreferences.html>`_ — user-facing profile and personal info settings +- `User manual: Personal settings `_ — user-facing profile and personal info settings diff --git a/admin_manual/configuration_user/two_factor-auth.rst b/admin_manual/configuration_user/two_factor-auth.rst index d9f88935870..7312f1a00a3 100644 --- a/admin_manual/configuration_user/two_factor-auth.rst +++ b/admin_manual/configuration_user/two_factor-auth.rst @@ -46,13 +46,13 @@ 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 <../../developer_manual/digging_deeper/two-factor-provider.html>`_. +apps `_. 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 <../../user_manual/user_2fa.html>`_. +it for their account `under their personal settings `_. Admins may, however, enforce the use of 2FA. Enforcement is possible system-wide (all users) or for selected groups only. Select groups diff --git a/admin_manual/desktop/index.rst b/admin_manual/desktop/index.rst index f30ab34d7ac..370995513bd 100644 --- a/admin_manual/desktop/index.rst +++ b/admin_manual/desktop/index.rst @@ -22,5 +22,5 @@ You can find additional information here: * `User manual`_ * `Developer manual`_ -.. _`User manual`: ../../user_manual/desktop/index.html -.. _`Developer manual`: ../../developer_manual/desktop/index.html +.. _`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 diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 0267cdaf746..8cb2e40c416 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -25,13 +25,13 @@ For documentation on Nextcloud web, desktop, or mobile clients, see: - `Nextcloud User Manual`_ - `Nextcloud Desktop Client`_ -.. _`Nextcloud User Manual`: ../user_manual/index.html +.. _`Nextcloud User Manual`: https://docs.nextcloud.com/server/latest/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 `_ -- `Nextcloud Development Manual <../developer_manual/index.html>`_ +- `Nextcloud Development Manual `_ Core Components --------------- diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst index 0394ec38e4d..1e45881ea11 100644 --- 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 `_ for details. + require additional packages. See :ref:`Prerequisites for manual installation ` for details. Now you need to create a database user and the database itself by using the MySQL command line interface. The database tables will be created by Nextcloud diff --git a/admin_manual/installation/harden_server.rst b/admin_manual/installation/harden_server.rst index b96218c2b24..d884534e70a 100644 --- a/admin_manual/installation/harden_server.rst +++ b/admin_manual/installation/harden_server.rst @@ -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): ../configuration_server/config_sample_php_parameters.html#has-internet-connection +.. _optional (config): https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#has-internet-connection .. _detailed field list: https://github.com/nextcloud/survey_client diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index 06c6eb9725c..bb71b685ec1 100644 --- 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: ../../developer_manual/prologue/bugtracker/index.html +.. _bugtracker: https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html General troubleshooting ----------------------- @@ -411,7 +411,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 <../../user_manual/files/quota.html>`_ for details. + Please refer to the `quota documentation `_ for details. Running the following command can help fix the sizes and quota for a given user:: diff --git a/admin_manual/occ_apps.rst b/admin_manual/occ_apps.rst index c4911bf8db1..553b6573efe 100644 --- a/admin_manual/occ_apps.rst +++ b/admin_manual/occ_apps.rst @@ -157,7 +157,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: ../developer_manual/digging_deeper/config/appconfig.html#concept-overview +.. _Appconfig Concepts: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/config/appconfig.html#concept-overview You can list all configuration values with one command:: diff --git a/admin_manual/occ_files.rst b/admin_manual/occ_files.rst index f20243b0aad..bfcb9a6aadd 100644 --- a/admin_manual/occ_files.rst +++ b/admin_manual/occ_files.rst @@ -336,7 +336,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 Users may also transfer files or folders selectively by themselves. -See `user documentation <../user_manual/files/transfer_ownership.html>`_ for details. +See `user documentation `_ for details. .. _occ_files_windows_filenames: @@ -427,7 +427,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 -<../developer_manual/app_publishing_maintenance/code_signing.html#how-to-get-your-app-signed>`_ in the Developer manual for more detailed information. +`_ in the Developer manual for more detailed information. ``integrity:sign-core`` is for Nextcloud core developers only. diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst index 763fdc37e94..50d43536328 100644 --- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst +++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst @@ -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 <../../../admin_manual/webhook_listeners/index.html>`_). +- ``OCP\EventDispatcher\IWebhookCompatibleEvent`` is a new interface for events compatible with webhooks (`see webhook_listeners documentation `_). - ``OCP\EventDispatcher\JsonSerializer`` is a new public helper for serializing users and fileinfos to json (ie for webhook events) Changed APIs @@ -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 <../../../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 `_). Deprecated APIs ^^^^^^^^^^^^^^^ diff --git a/developer_manual/app_publishing_maintenance/publishing.rst b/developer_manual/app_publishing_maintenance/publishing.rst index 20c88cafa81..c3b39146a93 100644 --- a/developer_manual/app_publishing_maintenance/publishing.rst +++ b/developer_manual/app_publishing_maintenance/publishing.rst @@ -52,7 +52,7 @@ Be technically sound Respect the users ^^^^^^^^^^^^^^^^^ -* Apps have to follow design and `HTML/CSS layout guidelines <../html_css_design/css.html>`_. +* Apps have to follow design and :doc:`HTML/CSS layout guidelines <../html_css_design/css>`. * Apps correctly clean up after themselves on uninstall and correctly handle up- and downgrades. * Apps clearly communicate their intended purpose and active features, including features introduced through updates. * Apps respect the users' choices and do not make unexpected changes, or limit users' ability to revert them. For example, they do not remove other apps or disable settings. diff --git a/developer_manual/basics/controllers.rst b/developer_manual/basics/controllers.rst index a0c5b975f6c..7154efecba1 100644 --- a/developer_manual/basics/controllers.rst +++ b/developer_manual/basics/controllers.rst @@ -838,7 +838,7 @@ To turn off checks the following *Attributes* can be added before the controller * ``#[NoAdminRequired]``: Also users that are not admins can access the page * ``#[PublicPage]``: Everyone can access the page without having to log in * ``#[NoTwoFactorRequired]``: A user can access the page before the two-factor challenge has been passed (use this wisely and only in two-factor auth apps, e.g. to allow setup during login) -* ``#[NoCSRFRequired]``: Don't check the CSRF token (use this wisely since you might create a security hole; to understand what it does see `CSRF in the security section <../prologue/security.html#cross-site-request-forgery>`__) +* ``#[NoCSRFRequired]``: Don't check the CSRF token (use this wisely since you might create a security hole; to understand what it does see :ref:`CSRF in the security section `) .. note:: diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst index 2e1d5a67a60..03b9cd2a9e3 100644 --- a/developer_manual/basics/logging.rst +++ b/developer_manual/basics/logging.rst @@ -301,7 +301,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 <../../admin_manual/configuration_server/logging_configuration.html#admin-audit-log>`_ +`admin audit log `_ is the correct place. You can easily add a log by simply emitting an ``OCP\Log\Audit\CriticalActionPerformedEvent`` event: diff --git a/developer_manual/basics/setting.rst b/developer_manual/basics/setting.rst index 4bb1271d7dd..3a93091b30e 100644 --- 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 **/appinfo/info. `` instead. Additionally since Nextcloud 23, groups can be granted authorization to access individual -admin settings (`see admin docs <../../admin_manual/configuration_server/admin_delegation_configuration.html>`_). +admin settings (`see admin docs `_). 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/basics/storage/filesystem.rst b/developer_manual/basics/storage/filesystem.rst index 2f346f8c98f..826c2bdfbeb 100644 --- a/developer_manual/basics/storage/filesystem.rst +++ b/developer_manual/basics/storage/filesystem.rst @@ -7,7 +7,7 @@ Nextcloud filesystem API High level guide to using the Nextcloud filesystem API. -Because users can choose their storage backend, the filesystem should be accessed by using the appropriate filesystem classes. For a simplified filesystem for app specific data see `IAppData `_ +Because users can choose their storage backend, the filesystem should be accessed by using the appropriate filesystem classes. For a simplified filesystem for app specific data see :doc:`IAppData ` Node API ^^^^^^^^ diff --git a/developer_manual/client_apis/OCS/ocs-share-api.rst b/developer_manual/client_apis/OCS/ocs-share-api.rst index c3d8b8d40f9..2020e213278 100644 --- a/developer_manual/client_apis/OCS/ocs-share-api.rst +++ b/developer_manual/client_apis/OCS/ocs-share-api.rst @@ -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 <../../../admin_manual/configuration_files/federated_cloud_sharing_configuration.html>`_. +enabled and configured. See `Configuring Federated Cloud Sharing `_. Create a new Federated Cloud Share ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/developer_manual/desktop/index.rst b/developer_manual/desktop/index.rst index 18e30b382c6..38811125f95 100644 --- a/developer_manual/desktop/index.rst +++ b/developer_manual/desktop/index.rst @@ -21,5 +21,5 @@ You can find additional information here: * `User manual`_ * `Admin manual`_ -.. _`User manual`: ../../user_manual/desktop/index.html -.. _`Admin manual`: ../../admin_manual/desktop/index.html +.. _`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 diff --git a/developer_manual/digging_deeper/config/appconfig.rst b/developer_manual/digging_deeper/config/appconfig.rst index cf364a3cbd4..0a855660887 100644 --- a/developer_manual/digging_deeper/config/appconfig.rst +++ b/developer_manual/digging_deeper/config/appconfig.rst @@ -22,9 +22,7 @@ In addition to simple read/write operations, ``IAppConfig`` supports: .. _appconfig_concepts: .. note:: - See `Lexicon Concepts`_ to learn more about **Lexicon**, a way to define configuration keys and avoid conflicts in your code. - -.. _Lexicon Concepts: lexicon.html#concept-overview + See :ref:`Lexicon Concepts ` to learn more about **Lexicon**, a way to define configuration keys and avoid conflicts in your code. AppFramework diff --git a/developer_manual/digging_deeper/config/lexicon.rst b/developer_manual/digging_deeper/config/lexicon.rst index 3cede1d8b24..973e5da4e86 100644 --- a/developer_manual/digging_deeper/config/lexicon.rst +++ b/developer_manual/digging_deeper/config/lexicon.rst @@ -7,6 +7,8 @@ Lexicon Since v32, Nextcloud provides a way to centralize the definition of your app's configuration keys and values in a single place. +.. _concept-overview: + Concept overview ---------------- diff --git a/developer_manual/digging_deeper/config/userconfig.rst b/developer_manual/digging_deeper/config/userconfig.rst index 86308d31636..fa01589c758 100644 --- a/developer_manual/digging_deeper/config/userconfig.rst +++ b/developer_manual/digging_deeper/config/userconfig.rst @@ -16,9 +16,7 @@ On top of storing and accessing your configuration values, ``IUserConfig`` comes .. _userconfig_concepts: .. 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: lexicon.html#concept-overview + See :ref:`Lexicon Concepts ` to learn more about **Lexicon**, a way to fully define your configuration keys and avoid conflict when using it in your code. Typed Config Values diff --git a/developer_manual/digging_deeper/context_chat.rst b/developer_manual/digging_deeper/context_chat.rst index 5c0b9da4c92..462233dd56e 100644 --- a/developer_manual/digging_deeper/context_chat.rst +++ b/developer_manual/digging_deeper/context_chat.rst @@ -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 <../../admin_manual/ai/app_context_chat.html>`_, -thereby enabling `Nextcloud Assistant <../../admin_manual/ai/app_assistant.html>`_ +to the `Nextcloud Assistant Context Chat `_, +thereby enabling `Nextcloud Assistant `_ to answer questions, provide insights and search results based on the submitted data and natural language queries. Implementing a content provider for Context Chat diff --git a/developer_manual/exapp_development/faq/DockerSocketProxy.rst b/developer_manual/exapp_development/faq/DockerSocketProxy.rst index a5ed18858a7..ada4e1af7a4 100644 --- a/developer_manual/exapp_development/faq/DockerSocketProxy.rst +++ b/developer_manual/exapp_development/faq/DockerSocketProxy.rst @@ -28,7 +28,7 @@ Nextcloud AIO implements its own `Docker Socket Proxy container `_ for more details. +See `Nextcloud in Docker AIO (all-in-one) `_ for more details. .. note:: diff --git a/developer_manual/exapp_development/faq/Troubleshooting.rst b/developer_manual/exapp_development/faq/Troubleshooting.rst index 6598f9f29e7..01188a532e5 100644 --- a/developer_manual/exapp_development/faq/Troubleshooting.rst +++ b/developer_manual/exapp_development/faq/Troubleshooting.rst @@ -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 <../../../admin_manual/exapps_management/TestDeploy.html>`_ section of the administration guide. +The deployment issues questions are covered in the `Test Deploy `_ section of the administration guide. Generally speaking, there are three steps to find the proper error message to understand the problem: 1. Check Nextcloud logs diff --git a/developer_manual/exapp_development/tech_details/Translations.rst b/developer_manual/exapp_development/tech_details/Translations.rst index f7bdb6e71af..a0ee03a0f94 100644 --- a/developer_manual/exapp_development/tech_details/Translations.rst +++ b/developer_manual/exapp_development/tech_details/Translations.rst @@ -43,7 +43,7 @@ You can then compile them to ``.mo`` files using `ui_example's `_ ``l10n`` folder of the ExApp +For the ``manual-install`` type, an administrator will have to manually extract to the server's `writable apps directory `_ ``l10n`` folder of the ExApp (e.g. ``/path/to/apps-writable//l10n/*.(js|json)``). This will allow the server to access the ExApp's strings with translations. diff --git a/developer_manual/exapp_development/tech_details/api/logging.rst b/developer_manual/exapp_development/tech_details/api/logging.rst index 35601054bea..ad8aa31d3e6 100644 --- a/developer_manual/exapp_development/tech_details/api/logging.rst +++ b/developer_manual/exapp_development/tech_details/api/logging.rst @@ -25,7 +25,7 @@ Request data } -The possible values of ``log_lvl`` are described here: `Nextcloud Log level <../../../../admin_manual/configuration_server/logging_configuration.html#log-level>`_ +The possible values of ``log_lvl`` are described here: `Nextcloud Log level `_ Response data ************* diff --git a/developer_manual/getting_started/coding_standards/index.rst b/developer_manual/getting_started/coding_standards/index.rst index 515bad0a7c1..120bd04f22b 100644 --- a/developer_manual/getting_started/coding_standards/index.rst +++ b/developer_manual/getting_started/coding_standards/index.rst @@ -16,7 +16,7 @@ General You describe what you want to do, ask feedback on the direction you take it and take it from there. * When you are finished, use the merge request function on GitHub to create a pull request. The other developers will look at it and give you feedback. You can signify that your PR is ready for review by adding the label "3. to review" to it. - See `the code review page for more information <../../prologue/bugtracker/codereviews.html>`_ + See :doc:`the code review page for more information <../../prologue/bugtracker/codereviews>` * It is key to keep changes separate and small. The bigger and more hairy a PR grows, the harder it is to get it in. So split things up where you can in smaller changes - if you need a small improvement like a API addition for a big feature addition, get it in first rather than adding it to the big piece of work! * Decisions are made by consensus. We strive for making the best technical decisions and as nobody can know everything, we collaborate. diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst index d3b769d8719..db0e93f9248 100644 --- a/developer_manual/getting_started/devenv.rst +++ b/developer_manual/getting_started/devenv.rst @@ -16,14 +16,14 @@ 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 <../../admin_manual/installation/index.html>`_ (**Section**: Manual Installation - Prerequisites). +First `set up your Web server and database `_ (**Section**: Manual Installation - Prerequisites). Get the source -------------- There are two ways to obtain Nextcloud sources: -* Using the `stable version <../../admin_manual/installation/index.html>`_ +* Using the `stable version `_ * Using the development version from `GitHub`_ which will be explained below. To check out the source from `GitHub`_ you will need to install Git (see `Setting up Git `_ from the GitHub help) diff --git a/user_manual/desktop/index.rst b/user_manual/desktop/index.rst index 66614fdb4ca..909c017004c 100644 --- a/user_manual/desktop/index.rst +++ b/user_manual/desktop/index.rst @@ -25,5 +25,5 @@ For additional information, see: * `Admin manual`_ * `Developer manual`_ -.. _`Admin manual`: ../../admin_manual/desktop/index.html -.. _`Developer manual`: ../../developer_manual/desktop/index.html +.. _`Admin manual`: https://docs.nextcloud.com/server/latest/admin_manual/desktop/index.html +.. _`Developer manual`: https://docs.nextcloud.com/server/latest/developer_manual/desktop/index.html diff --git a/user_manual/desktop/uninstallation.rst b/user_manual/desktop/uninstallation.rst index 105ff24e882..8b208b78f0d 100644 --- a/user_manual/desktop/uninstallation.rst +++ b/user_manual/desktop/uninstallation.rst @@ -12,7 +12,7 @@ In each operating system: 2. *Uninstall* the desktop client. -3. You may also need to take into consideration that uninstalling the desktop client will not remove the `user's configuration `_ file and synced data. +3. You may also need to take into consideration that uninstalling the desktop client will not remove the :doc:`user's configuration ` file and synced data. For data removal (sync folders), consider using the server feature `remote wipe `_. This feature is available across all clients. @@ -30,7 +30,7 @@ There are two ways of removing the desktop client: msiexec /uninstall Nextcloud-x.y.z-x64.msi /quiet`` -3. The `user's configuration `_ is located at ``%APPDATA%\Nextcloud\nextcloud.cfg``. +3. The :doc:`user's configuration ` is located at ``%APPDATA%\Nextcloud\nextcloud.cfg``. macOS ^^^^^ @@ -53,7 +53,7 @@ Beyond deleting the desktop client from the *Applications* folder, you may also rm -rf "$HOME/Library/Preferences/Nextcloud" rm -f "$HOME/Library/Preferences/com.nextcloud.desktopclient.plist" -3. From version 33.0.0 the `user's configuration `_ is located at ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``. +3. From version 33.0.0 the :doc:`user's configuration ` is located at ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``. On older versions it is located at ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg``. Linux @@ -68,5 +68,5 @@ It depends on how you installed the desktop client: sudo apt remove nextcloud-desktop -3. The `user's configuration `_ is located at *$HOME/.config/Nextcloud/nextcloud.cfg*. +3. The :doc:`user's configuration ` is located at *$HOME/.config/Nextcloud/nextcloud.cfg*. diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst index 70d51f576b8..7af7a6757bf 100644 --- a/user_manual/external_storage/external_storage.rst +++ b/user_manual/external_storage/external_storage.rst @@ -6,5 +6,5 @@ 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) -<../../admin_manual/configuration_files/external_storage_configuration_gui.html>`_ in the Nextcloud Administrator's +`_ in the Nextcloud Administrator's manual for configuration how-tos and examples. diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 4fdcc63eeee..3a5e4cbee59 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -92,8 +92,7 @@ You can access files in Linux operating systems using the following methods. Nautilus file manager ^^^^^^^^^^^^^^^^^^^^^ -**When you configure your Nextcloud account in the** `GNOME Control Center -<../groupware/sync_gnome.html>`_, **your files will automatically be mounted +**When you configure your Nextcloud account in the** :doc:`GNOME Control Center <../groupware/sync_gnome>`, **your files will automatically be mounted by Nautilus as a WebDAV share, unless you deselect file access**. You can also mount your Nextcloud files manually. Use the ``davs://`` diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst index 52f730bb5f7..6eb13a69e49 100644 --- a/user_manual/files/deleted_file_management.rst +++ b/user_manual/files/deleted_file_management.rst @@ -56,4 +56,4 @@ Nextcloud will permanently delete those trashed files with the soonest expiratio until the space limit is met again. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `admin documentation <../../admin_manual/configuration_server/config_sample_php_parameters.html#deleted-items-trash-bin>`_ for more details. + to override the storage space management. See `admin documentation `_ for more details. diff --git a/user_manual/files/encrypting_files.rst b/user_manual/files/encrypting_files.rst index 0a51b85e218..2cc3d38ea5c 100644 --- a/user_manual/files/encrypting_files.rst +++ b/user_manual/files/encrypting_files.rst @@ -34,21 +34,21 @@ How can encryption be disabled? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The only way to disable encryption is to run the `"decrypt all" -<../../admin_manual/occ_command.html#encryption-label>`_ +`_ script, which decrypts all files and disables encryption. Is it possible to disable encryption with the recovery key? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes, *if* every user uses the `file recovery key -<../../admin_manual/configuration_files/encryption_configuration.html#enabling-users-file-recovery-keys>`_, `"decrypt all" -<../../admin_manual/occ_command.html#encryption-label>`_ will use it to decrypt all files. +`_, `"decrypt all" +`_ will use it to decrypt all files. Can encryption be disabled without the user's password? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you don't have the users password or `file recovery key -<../../admin_manual/configuration_files/encryption_configuration.html#enabling-users-file-recovery-keys>`_, +`_, then there is no way to decrypt all files. What's more, running it on login would be dangerous, because you would most likely run into timeouts. diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst index 2d5cd8273a4..bce6c1efa86 100644 --- a/user_manual/files/large_file_upload.rst +++ b/user_manual/files/large_file_upload.rst @@ -9,5 +9,5 @@ Modifying certain Nextcloud variables requires administrative access. If you req * Contact your administrator to request an increase in these variables * Refer to the section in the `Administration Documentation - <../../admin_manual/configuration_files/big_file_upload_configuration.html>`_ that describes how to manage file + `_ that describes how to manage file upload size limits. diff --git a/user_manual/files/quota.rst b/user_manual/files/quota.rst index 3239b1c18e4..69c95b70a37 100644 --- a/user_manual/files/quota.rst +++ b/user_manual/files/quota.rst @@ -29,7 +29,7 @@ deleted files exceed 50% of quota then the oldest files are removed until the total is below 50%. .. note:: Your administrator may have configured the trash bin retention period - to override the storage space management. See `administrator documentation <../../admin_manual/configuration_server/config_sample_php_parameters.html#deleted-items-trash-bin>`_ for more details. + to override the storage space management. See `administrator documentation `_ for more details. When version control is enabled, the older file versions are not counted against quotas. diff --git a/user_manual/files/sharing.rst b/user_manual/files/sharing.rst index a46543a6b3c..c4b8340c77b 100644 --- a/user_manual/files/sharing.rst +++ b/user_manual/files/sharing.rst @@ -12,7 +12,7 @@ Nextcloud users can share files and folders. Possible targets are: * users or groups on federated Nextcloud servers .. note:: Some options may not be available due to administrative configuration. - See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.html>`__ for details. + See `administrator documentation `__ for details. Public link shares diff --git a/user_manual/files/transfer_ownership.rst b/user_manual/files/transfer_ownership.rst index 63bdf6cc8ba..df278aef99f 100644 --- a/user_manual/files/transfer_ownership.rst +++ b/user_manual/files/transfer_ownership.rst @@ -13,7 +13,7 @@ ownerships of those transferred files/folders will also be transferred. #. Click on *Transfer*. .. note:: The username autocompletion or listing may be limited due to administrative visibility configuration. - See `administrator documentation <../../admin_manual/configuration_files/file_sharing_configuration.html>`_ for details. + See `administrator documentation `_ for details. #. The target user receives a notification where they are being asked whether to accept or reject the incoming transfer. diff --git a/user_manual/groupware/sync_android.rst b/user_manual/groupware/sync_android.rst index 233ae7f6d5d..4231dc2dbb6 100644 --- a/user_manual/groupware/sync_android.rst +++ b/user_manual/groupware/sync_android.rst @@ -14,7 +14,7 @@ Files and notifications confirm to grant access. *Or*: In Nextcloud's web GUI, go to the - `user preferences <../userpreferences.html>`_, go to + :doc:`user preferences <../userpreferences>`, go to **Security**. Generate an App password, click "Generate QR code" and tap the QR scanner icon in the Nextcloud app, point your phone's camera towards the screen. diff --git a/user_manual/groupware/sync_gnome.rst b/user_manual/groupware/sync_gnome.rst index 10240ef4829..2ed95d5f94b 100644 --- a/user_manual/groupware/sync_gnome.rst +++ b/user_manual/groupware/sync_gnome.rst @@ -15,7 +15,7 @@ This can be done by following these steps: #. Enter your server URL, username, and password. If you have enabled two-factor authentication (2FA), you need to generate an application password/token, because GNOME Online Accounts `doesn't support Nextcloud's WebFlow login yet `_ - (`Learn more <../session_management.html#managing-devices>`_): + (:ref:`Learn more `): .. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index 000da89e78a..46165d7a12a 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -53,5 +53,5 @@ You should now find your contacts in the address book of your iPhone. If it's still not working, have a look at `Troubleshooting Contacts & Calendar`_ or `Troubleshooting Service Discovery`_. -.. _Troubleshooting Contacts & Calendar: ../../admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar -.. _Troubleshooting Service Discovery: ../../admin_manual/issues/general_troubleshooting.html#service-discovery +.. _Troubleshooting Contacts & Calendar: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar +.. _Troubleshooting Service Discovery: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#service-discovery diff --git a/user_manual/groupware/sync_kde.rst b/user_manual/groupware/sync_kde.rst index 31a37e977bb..e4bea12190a 100644 --- a/user_manual/groupware/sync_kde.rst +++ b/user_manual/groupware/sync_kde.rst @@ -28,7 +28,7 @@ In Kalendar: In KOrganizer and Kalendar: -3. Enter your username. As password, you need to generate an app-password/token (`Learn more <../session_management.html#managing-devices>`_): +3. Enter your username. As password, you need to generate an app-password/token (:ref:`Learn more `): .. image:: ../images/korganizer_credentials.png From 60c0d3e355436d274a5ed386355b30615419cf73 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Fri, 24 Apr 2026 14:51:52 +0200 Subject: [PATCH 6/6] fix: revert doc url change --- admin_manual/configuration_files/file_sharing_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index da97e6c8b2f..550a7a78558 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -98,7 +98,7 @@ forcing them. `_ for discussion of this. .. note:: There are more sharing options on config.php level available: - :doc:`Configuration Parameters <../configuration_server/config_sample_php_parameters>` + `Configuration Parameters `_ .. _transfer_userfiles_label: