From 4d482982af33ac47f7d2aa9d0cedcfe511b05d84 Mon Sep 17 00:00:00 2001 From: skjnldsv Date: Thu, 23 Apr 2026 11:29:25 +0200 Subject: [PATCH 1/5] sync_windows10.rst: Cleanup and document TLSv1.2 - Remove redundant Contacts section. The remaining section works and is simpler. - Remove redundant "repeat steps" step - Move credit to the bottom as it is just a distraction - Document the server-side TLSv1.2 requirement for Windows 10's schannel TLS client support. Keywords for SEO: Windows 10 calendar contacts nextcloud owncloud caldav carddav sync --- .docker/sphinx-latex/Dockerfile.orig | 34 +++++++++++++++++++ user_manual/groupware/sync_windows10.rst | 43 ++++++++---------------- 2 files changed, 48 insertions(+), 29 deletions(-) create mode 100644 .docker/sphinx-latex/Dockerfile.orig diff --git a/.docker/sphinx-latex/Dockerfile.orig b/.docker/sphinx-latex/Dockerfile.orig new file mode 100644 index 00000000000..235d6b71fee --- /dev/null +++ b/.docker/sphinx-latex/Dockerfile.orig @@ -0,0 +1,34 @@ +FROM ubuntu:24.04 + +LABEL org.opencontainers.image.source="https://github.com/nextcloud/documentation" +LABEL org.opencontainers.image.description="Sphinx + LaTeX build environment for Nextcloud documentation" +LABEL org.opencontainers.image.licenses="AGPL-3.0" + +ENV DEBIAN_FRONTEND=noninteractive +# Allow pip to install packages system-wide inside the container +ENV PIP_BREAK_SYSTEM_PACKAGES=1 + +RUN apt-get update \ + && apt-get install -y --no-install-recommends \ + curl \ + git \ +<<<<<<< HEAD + lsb-release \ +======= +>>>>>>> 18b2977d1 (ci: use Docker image for PDF builds, split HTML and PDF jobs) + make \ + latexmk \ + tex-gyre \ + texlive-fonts-extra \ + texlive-fonts-extra-links \ + texlive-fonts-recommended \ + texlive-latex-extra \ + texlive-latex-recommended \ + texlive-xetex \ + xindy \ + && mktexlsr \ + && rm -rf /var/lib/apt/lists/* + +# Allow pip to install packages system-wide inside the container (used by +# actions/setup-python and plain pip invocations running as root) +RUN printf '[global]\nbreak-system-packages = true\n' > /etc/pip.conf diff --git a/user_manual/groupware/sync_windows10.rst b/user_manual/groupware/sync_windows10.rst index ce77e60f452..ea52c816dba 100644 --- a/user_manual/groupware/sync_windows10.rst +++ b/user_manual/groupware/sync_windows10.rst @@ -21,35 +21,19 @@ Calendar 8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Calendar"). Click "Save". - Contacts -------- -1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little (chain) link symbol that looks like this: - -.. image:: ../images/contacts_link.png - -which will display a URL that looks something like this: -https://cloud.nextcloud.com/remote.php/dav/addressbooks/users/daniel/Thunderbird/ -2. Launch the Windows 10 Calendar app. Then, click the settings icon (gear icon) and select "Manage accounts". - -3. Click "Add account" and choose "iCloud". - -4. Enter an email, username and password. None of this information has to be valid-it will all be changed in the upcoming steps. - -5. Click "Sign in" and then "Done". A message should appear indicating the settings were saved successfully. - -6. In the "Manage Accounts" menu, click on the iCloud account created in previous steps, and select "Change settings". Then, click on "Change mailbox sync settings". - -7. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)". +1. Repeat steps 1–7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this. -8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Contacts"). Click "Save". +2. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)". +3. Replace the path "principals" within the URL with "addressbooks". -Troubleshooting ---------------- +4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save". -After following all these steps, your Nextcloud calendar should synchronize. If not, check your username and password. Otherwise, repeat these steps. +Troubleshooting: 2FA +-------------------- **NOTE: You will not be able to synchronize your calendar if you have two-factor authentication enabled. Follow the steps below to get an app password that can be used with the Calendar client app:** @@ -57,14 +41,15 @@ After following all these steps, your Nextcloud calendar should synchronize. If 2. Click on "Security", then locate a button labeled "Create new app password". Next to this button, enter "Windows 10 Calendar app". Then, click the button, copy and paste the password. Use this password instead of your Nextcloud password for Step 8. +Troubleshooting: TLSv1.2 +------------------------ -Contacts --------- - -1. Repeat steps 1–7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this. +- For Windows 10 your Nextcloud https server `must support TLSv1.2`_. This is apparent if no connection attempts are seen on the server, and the Windows client Event Viewer will display Schannel TLS errors under "Windows Logs -> System". -2. In the "Advanced mailbox settings" paste your CalDAV URL in the field labelled "Contacts server (CardDAV)". +Credits +------ -3. Replace the path "principals" within the URL with "addressbooks". +Special thanks to this Reddit user for their post: +https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/ -4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save". +.. _must support TLSv1.2: https://docs.microsoft.com/en-us/windows/win32/secauthn/protocols-in-tls-ssl--schannel-ssp- From d789cb071db8c10d5c3875f3a1a3b0dcec27d9ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Thu, 23 Apr 2026 12:18:06 +0200 Subject: [PATCH 2/5] fix: delete unwanted `.orig` file MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: John Molakvoæ --- .docker/sphinx-latex/Dockerfile.orig | 34 ---------------------------- 1 file changed, 34 deletions(-) delete mode 100644 .docker/sphinx-latex/Dockerfile.orig diff --git a/.docker/sphinx-latex/Dockerfile.orig b/.docker/sphinx-latex/Dockerfile.orig deleted file mode 100644 index 235d6b71fee..00000000000 --- a/.docker/sphinx-latex/Dockerfile.orig +++ /dev/null @@ -1,34 +0,0 @@ -FROM ubuntu:24.04 - -LABEL org.opencontainers.image.source="https://github.com/nextcloud/documentation" -LABEL org.opencontainers.image.description="Sphinx + LaTeX build environment for Nextcloud documentation" -LABEL org.opencontainers.image.licenses="AGPL-3.0" - -ENV DEBIAN_FRONTEND=noninteractive -# Allow pip to install packages system-wide inside the container -ENV PIP_BREAK_SYSTEM_PACKAGES=1 - -RUN apt-get update \ - && apt-get install -y --no-install-recommends \ - curl \ - git \ -<<<<<<< HEAD - lsb-release \ -======= ->>>>>>> 18b2977d1 (ci: use Docker image for PDF builds, split HTML and PDF jobs) - make \ - latexmk \ - tex-gyre \ - texlive-fonts-extra \ - texlive-fonts-extra-links \ - texlive-fonts-recommended \ - texlive-latex-extra \ - texlive-latex-recommended \ - texlive-xetex \ - xindy \ - && mktexlsr \ - && rm -rf /var/lib/apt/lists/* - -# Allow pip to install packages system-wide inside the container (used by -# actions/setup-python and plain pip invocations running as root) -RUN printf '[global]\nbreak-system-packages = true\n' > /etc/pip.conf From ca6849bade59110e1ea6925d20747004e0769aca Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 23 Apr 2026 14:18:21 +0000 Subject: [PATCH 3/5] Fix Credits title underline too short warning Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/4fe9b431-206e-46c3-a2ee-1f94d301bbba Co-authored-by: skjnldsv <14975046+skjnldsv@users.noreply.github.com> --- user_manual/groupware/sync_windows10.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/groupware/sync_windows10.rst b/user_manual/groupware/sync_windows10.rst index ea52c816dba..5269ce9536e 100644 --- a/user_manual/groupware/sync_windows10.rst +++ b/user_manual/groupware/sync_windows10.rst @@ -47,7 +47,7 @@ Troubleshooting: TLSv1.2 - For Windows 10 your Nextcloud https server `must support TLSv1.2`_. This is apparent if no connection attempts are seen on the server, and the Windows client Event Viewer will display Schannel TLS errors under "Windows Logs -> System". Credits ------- +------- Special thanks to this Reddit user for their post: https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/ From 9e470b8124d95808f801f55f613bce6c509c7933 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 24 Apr 2026 07:57:09 +0000 Subject: [PATCH 4/5] Apply review suggestions: fix grammar and clarify step references Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/4bceccbe-e719-48b2-a901-da5a4c943e8e Co-authored-by: nextcloud-command <88102737+nextcloud-command@users.noreply.github.com> --- user_manual/groupware/sync_windows10.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user_manual/groupware/sync_windows10.rst b/user_manual/groupware/sync_windows10.rst index 5269ce9536e..2635da21000 100644 --- a/user_manual/groupware/sync_windows10.rst +++ b/user_manual/groupware/sync_windows10.rst @@ -24,9 +24,9 @@ Calendar Contacts -------- -1. Repeat steps 1–7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this. +1. Repeat steps 1–7 from the Calendar instructions. If you already have set up the Calendar synchronization, you can use the same account for this. -2. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)". +2. From the "Advanced mailbox settings" screen, scroll to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)". 3. Replace the path "principals" within the URL with "addressbooks". @@ -39,7 +39,7 @@ Troubleshooting: 2FA 1. Log into Nextcloud. Click on your user icon, then click on "Settings". -2. Click on "Security", then locate a button labeled "Create new app password". Next to this button, enter "Windows 10 Calendar app". Then, click the button, copy and paste the password. Use this password instead of your Nextcloud password for Step 8. +2. Click on "Security", then locate a button labeled "Create new app password". Next to this button, enter "Windows 10 Calendar app". Then, click the button, copy and paste the password. Use this password instead of your Nextcloud password when prompted for credentials during setup, for example in Calendar step 8 or Contacts step 4. Troubleshooting: TLSv1.2 ------------------------ From ee1c5f5cd95c05538295bd25eec94292251856b3 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 26 Apr 2026 08:38:44 +0000 Subject: [PATCH 5/5] Add anchor label and :ref: link to Calendar section from Contacts step 1 Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/2f8acb70-306c-48ae-acc9-56e9ef9f6f99 Co-authored-by: nextcloud-command <88102737+nextcloud-command@users.noreply.github.com> --- user_manual/groupware/sync_windows10.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/user_manual/groupware/sync_windows10.rst b/user_manual/groupware/sync_windows10.rst index 2635da21000..f3f0f6ea16f 100644 --- a/user_manual/groupware/sync_windows10.rst +++ b/user_manual/groupware/sync_windows10.rst @@ -2,6 +2,8 @@ Synchronizing with Windows 10 ============================= +.. _calendar-section: + Calendar -------- @@ -24,7 +26,7 @@ Calendar Contacts -------- -1. Repeat steps 1–7 from the Calendar instructions. If you already have set up the Calendar synchronization, you can use the same account for this. +1. Repeat steps 1–7 from the :ref:`Calendar instructions `. If you already have set up the Calendar synchronization, you can use the same account for this. 2. From the "Advanced mailbox settings" screen, scroll to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)".