Skip to content

Commit 5796461

Browse files
Copilotskjnldsv
authored andcommitted
docs: polish access_webdav wording and style
Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/2c1f4cf0-01aa-4de3-94e3-2d687cf5d98a Co-authored-by: skjnldsv <14975046+skjnldsv@users.noreply.github.com>
1 parent 2a09a18 commit 5796461

1 file changed

Lines changed: 29 additions & 23 deletions

File tree

user_manual/files/access_webdav.rst

Lines changed: 29 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,17 @@
22
Accessing Nextcloud files using WebDAV
33
======================================
44

5-
Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize
6-
with Nextcloud Files over WebDAV. In this chapter, you will learn how to
7-
connect Linux, macOS, Windows, and mobile devices to your Nextcloud server.
5+
Nextcloud fully supports the WebDAV protocol, and you can connect to and synchronize
6+
with Nextcloud Files over WebDAV. This chapter explains how to connect Linux, macOS,
7+
Windows, and mobile devices to your Nextcloud server.
88

99
WebDAV stands for Distributed Authoring and Versioning. It is an HTTP extension
1010
that makes it easy to create, read, and edit files hosted on remote Web servers. With
1111
a WebDAV client, you can access your Nextcloud Files (including shares) on Linux,
1212
macOS and Windows in a similar way as any remote network share, and stay synchronized.
1313

14-
Before we get into configuring WebDAV, let's take a quick look at the
15-
recommended way of connecting client devices to Nextcloud.
14+
Before you configure WebDAV, review the recommended way to connect client devices to
15+
Nextcloud.
1616

1717
Official Nextcloud desktop and mobile clients
1818
---------------------------------------------
@@ -65,7 +65,7 @@ If Nextcloud is installed in a subdirectory called "nextcloud"::
6565

6666
.. note:: When using a third-party WebDAV client (including your operating system's
6767
built-in client), you should use an application password for login rather than your
68-
regular password. In addition improved security, this `increases performance significantly
68+
regular password. In addition to improved security, this `increases performance significantly
6969
<https://github.com/nextcloud/server/issues/32729#issuecomment-1556667151>`_. To
7070
configure an application password, log into the Nextcloud Web interface, click on the avatar
7171
in the top right and choose *Personal settings*. Then choose *Security* in the left
@@ -76,7 +76,7 @@ If Nextcloud is installed in a subdirectory called "nextcloud"::
7676
URL of your Nextcloud server (omit the directory part if the installation is
7777
in the root of your domain), and **USERNAME** with the username of the connecting user.
7878

79-
See the WebDAV URL, to be found in Files Settings -> WebDAV in the Files on your Nextcloud account.
79+
You can find the WebDAV URL in **Files settings** under **WebDAV** in your Nextcloud account.
8080

8181
.. image:: ../images/webdav_link.png
8282
:alt: Screenshot of the Files settings showing the personal WebDAV link
@@ -110,8 +110,8 @@ share::
110110
.. note:: The same method works for other file managers that use GVFS,
111111
such as MATE's Caja and Cinnamon's Nemo.
112112

113-
Accessing files with KDE and Dolphin file manager
114-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
113+
Accessing files with KDE and Dolphin
114+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
115115

116116
#. Navigate to System Settings -> Networking -> Online Accounts
117117
#. Click "Add Account..."
@@ -120,8 +120,8 @@ Accessing files with KDE and Dolphin file manager
120120
#. Follow the on-screen instructions to log in
121121
#. After logging in, ensure you enable "Storage" in the "Use This Account For" section
122122
#. You can now access your files in Dolphin under "Network" in the sidebar
123-
#. (Optional) To add this as a shortcut in the sidebar, right click "Nextcloud Storage" then "Add to Places"
124-
#. (Optional) To customise the shortcut, right click the shortcut in the sidebar then "Edit..." and customise the icon and label as you please
123+
#. (Optional) To add this location as a shortcut in the sidebar, right-click "Nextcloud Storage", then click "Add to Places"
124+
#. (Optional) To customize the shortcut, right-click it in the sidebar, then click "Edit..." and customize the icon and label
125125

126126

127127
Creating WebDAV mounts on the Linux command line
@@ -251,7 +251,7 @@ Using this feature requires network connectivity. If you want to store your
251251
files offline, use the Desktop Client to sync all files on your
252252
Nextcloud to one or more directories of your local hard drive.
253253

254-
.. note:: Windows 10 now defaults to allow Basic Authentication if HTTPS is enabled before mapping your drive.
254+
.. note:: In Windows 10, Basic Authentication is allowed by default when HTTPS is enabled before mapping your drive.
255255

256256
On older versions of Windows, you must permit the use of Basic Authentication in the Windows Registry:
257257

@@ -318,7 +318,7 @@ To map a drive using Microsoft Windows Explorer:
318318
:scale: 80%
319319
:alt: Screenshot of mapping WebDAV on Windows Explorer
320320

321-
5. Click the ``Finish`` button.
321+
#. Click the ``Finish`` button.
322322

323323
Windows Explorer maps the network drive, making your Nextcloud instance available.
324324

@@ -412,15 +412,16 @@ service.
412412
Problem
413413
^^^^^^^
414414

415-
Adding a WebDAV drive on Windows via the above described steps does not display the correct size
416-
of in Nextcloud available space and instead shows the size of the C: drive with its available space.
415+
Adding a WebDAV drive on Windows with the steps above does not display the correct
416+
available Nextcloud space and instead shows the size and free space of the C: drive.
417417

418418
Answer
419419
^^^^^^
420420

421-
Unfortunately is this a limitation of WebDAV itself, because it does not provide a way for the client
422-
to get the available free space from the server. Windows automatically falls back to show the size of
423-
the C: drive with its available space instead. So unfortunately there is no real solution to this problem.
421+
Unfortunately, this is a limitation of WebDAV itself, because it does not provide a
422+
way for the client to retrieve available free space from the server. Windows automatically
423+
falls back to the size and free space of the C: drive. There is no direct solution
424+
for this limitation.
424425

425426
Problem
426427
^^^^^^^
@@ -439,7 +440,7 @@ Cannot map Nextcloud as a WebDAV drive in Windows using a self-signed certificat
439440
Solution
440441
^^^^^^^^
441442

442-
#. Access to your Nextcloud instance via your favorite Web browser.
443+
#. Access your Nextcloud instance in your preferred web browser.
443444
#. Click through until you get to the certificate error in the browser status
444445
line.
445446
#. View the certificate, then from the Details tab, select 'Copy to File'.
@@ -541,13 +542,17 @@ To get the properties of files in the root folder:
541542
542543
543544
Accessing files using WinSCP
544-
-------------------------------
545+
----------------------------
545546

546-
`WinSCP <https://winscp.net/eng/docs/introduction/>`_ is an open source free SFTP, FTP, WebDAV, S3, and SCP client for Windows. Its main function is file transfer between a local and a remote computer. Beyond this, WinSCP offers scripting and basic file management functionality.
547+
`WinSCP <https://winscp.net/eng/docs/introduction/>`_ is a free, open-source SFTP,
548+
FTP, WebDAV, S3, and SCP client for Windows. Its main function is file transfer
549+
between a local and a remote computer. WinSCP also offers scripting and basic file
550+
management functionality.
547551

548552
You can `download <https://winscp.net/eng/downloads.php/>`_ the portable version of WinSCP and run it on Linux through `Wine <https://wiki.winehq.org/Main_Page/>`_.
549553

550-
To run WinSCP on Linux, download wine through your distribution's package manager, then run it with the command: ``wine WinSCP.exe``.
554+
To run WinSCP on Linux, install Wine through your distribution's package manager,
555+
then run: ``wine WinSCP.exe``.
551556

552557
To connect to Nextcloud:
553558

@@ -567,7 +572,8 @@ To connect to Nextcloud:
567572
* Select the desired options and press the 'OK' button
568573
* Press the 'Login' button to connect to Nextcloud
569574

570-
.. note:: It is recommended to use an app password for the password if you use TOTP as WinSCP does not understand TOTP with Nextcloud at the time of writing (2022-11-07).
575+
.. note:: If you use TOTP, use an app password. At the time of writing (2022-11-07),
576+
WinSCP does not support TOTP with Nextcloud.
571577

572578

573579
.. _KB2668751: https://web.archive.org/web/20211008025539/https://support.microsoft.com/en-us/topic/you-cannot-download-more-than-50-mb-or-upload-large-files-when-the-upload-takes-longer-than-30-minutes-using-web-client-in-windows-7-8709ae9d-e808-c5a0-95d0-9a7143c50b11

0 commit comments

Comments
 (0)