Merge pull request #15639 from nextcloud/docs/desktop-advanced-configuration

docs(desktop): consolidate desktop advanced configuration

Author: Rello

_shared_assets/_desktop_account_setup_options.rst

@@ -0,0 +1,31 @@
+.. Shared parameter table for desktop account provisioning commands.
+
+.. list-table::
+   :header-rows: 1
+   :class: configuration-table
+   :widths: 32 18 50
+
+   * - Parameter
+     - Default
+     - Description
+   * - ``--userid <user>``
+     - Required
+     - User ID for the account to create.
+   * - ``--serverurl <url>``
+     - Required
+     - Base URL of the Nextcloud server, for example ``https://cloud.example.com``.
+   * - ``--apppassword <password>``
+     - Not set
+     - App password for the account. If omitted, the account is saved and you must log in from the desktop app later.
+   * - ``--localdirpath <path>``
+     - Suggested folder
+     - Local sync folder. If omitted, use the folder suggested by the setup wizard. An existing folder must be empty.
+       Ignored when macOS File Provider mode is enabled.
+   * - ``--remotedirpath <path>``
+     - ``/``
+     - Remote folder for the new classic sync connection. Applies when a local sync folder is created.
+   * - ``--isvfsenabled <0|1>``
+     - ``0``
+     - Use ``1`` to request virtual files for the new classic sync folder, where supported, or ``0`` to download
+       files. This does not enable macOS File Provider mode.
+

_shared_assets/static/custom.css

@@ -247,6 +247,18 @@ table.docutils {
 	width: 100%;
 }
 
+.rst-content table.configuration-table {
+	width: 100%;
+	table-layout: fixed;
+}
+
+.rst-content table.configuration-table th,
+.rst-content table.configuration-table td,
+.rst-content table.configuration-table code {
+	white-space: normal;
+	overflow-wrap: anywhere;
+}
+
 /* Version picker lists — 2-column grid, emoji as absolute ::before bullet */
 .rst-versions .rst-other-versions {
 	padding-left: 26px;

user_manual/conf.py

@@ -174,6 +174,9 @@
 # https://documatt.gitlab.io/sphinx-reredirects/usage.html
 
 redirects = {
+    'desktop/options': 'advanced_configuration.html',
+    'desktop/configfile': 'advanced_configuration.html',
+    'desktop/envvars': 'advanced_configuration.html',
     # Renamed 2026-06
     'desktop/macosvfs': 'desktop/macosfileprovider',
 }