From d5d20265392c4d37ca60129c9e0af963ff9b1a19 Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Fri, 22 Mar 2019 08:07:26 -0500 Subject: [PATCH 1/6] Update access_webdav.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit There’s more explanation here than there are changes to the docs! But, in the interest of fully explaining *why*: I had a frustrating and time-consuming experience attempting to *unsuccessfully* get macOS 10.11.x-10.13.x to mount WebDAV shares. The opening “Note” of “Accessing files using macOS” re Finder’s “series of implementation problems” is valuable. While my rewrite does *not* employ stronger language to *dissuade* Mac users from wrestling Finder, I’m convinced it should. I understand that docs maintainers probably want to avoid negative commentary re product manufacturers for many reasons, but the alternative to tight-lipped disclosure is user disillusionment. The opening warning would serve Apple folk better if it more-plainly warned of the high likelihood of Finder failure and more-thoroughly offered, even recommended, alternative apps to successfully achieve WebDAV access. Though Cyberduck instructions follow *later* in the article, it benefits the Mac user *here* (and other users in their respective sections) as they will likely seek out and focus specifically, perhaps *only*, on these instructions which are so clearly titled for and targeted at them: “Accessing files using **macOS**.” Unfortunately — even though these steps *should* work — they probably will *not*. Readers, exacerbated, may only find the Cyberduck info later, after returning to the instructions for further illumination, feeling slighted it wasn’t there to begin with. Recommending the open source Cyberduck as a candidate to replace Finder’s failures is helpful. Understandably, there may be resistance to mentioning commercial apps at the risk of perceived endorsement, but I have. I also added another open source app. Arming readers with more knowledge, more details, and more tools *up front* secures a higher rate of informed execution and success. Nuts and bolts: I offer minor reordering of graphics and text to hopefully present a clearer flow of the existing steps. That includes changing example.com/nextcloud to cloud.nextcloud.com as most people who have registered domains can easily add subdomains. Subdomains can also efficiently by reverse proxied to internal servers *without* opening external ports visible to hackers. Call it subliminal security reinforcement. I optimized the original “osx_webdav1.png,” compressing it from 381K to 94K, with negligible visual loss. And I created a new screenshot to replace the existing osx_webdav2.png “Connect to Server” image which graphically matches the sample text URL. (The existing sample URL and its screenshot don’t match.) Finally, the original osx_webdav2.png dialog box had been reduced in size, introducing minor but visible blur. The new optimized version is actual-size-crisp and only 16K, vs the original’s 66K. (I don’t see where to attach these new graphics. I’m new to pull requests, and hope in subsequent steps I can.) --- user_manual/files/access_webdav.rst | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 7f4870978..92a0c02da 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -198,35 +198,26 @@ 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+**. +.. 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 `_ and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. To access files through the macOS Finder: -1. Choose **Go > Connect to Server**. - - The "Connect to Server" window opens. - -2. Specify the address of the server in the **Server Address** field. +1. From the Finder’s top menu bar, choose **Go > Connect to Server...** .. image:: ../images/osx_webdav1.png :alt: Screenshot of entering your Nextcloud server address on macOS - For example, the URL used to connect to the Nextcloud server - from the macOS Finder is:: - - https://example.com/nextcloud/remote.php/dav/files/USERNAME/ +2. The **Connect to Server...** window opens. .. image:: ../images/osx_webdav2.png + :alt: Screenshot: Enter Nextcloud server address in “Connect to Server” dialog box -3. Click **Connect**. +3. Enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: - The device connects to the server. + https://cloud.nextcloud.com/nextcloud/remote.php/dav/files/USERNAME/ + +4. Click **Connect**. The WebDAV server will appear on the Desktop as a shared disk drive. -For added details about how to connect to an external server using macOS, -check the `vendor documentation -`_ . Accessing files using Microsoft Windows --------------------------------------- @@ -310,7 +301,7 @@ To map a drive using the Microsoft Windows Explorer: Accessing files using Cyberduck ------------------------------- -`Cyberduck `_ is an open source FTP and SFTP, +`Cyberduck `_ is an open source FTP and SFTP, WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on macOS and Windows. From 82245ceb588a43b2f9926cf03c29b69aa8d8ebe1 Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Fri, 22 Mar 2019 08:26:40 -0500 Subject: [PATCH 2/6] Update access_webdav.rst --- user_manual/files/access_webdav.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 92a0c02da..f9175aca8 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -210,11 +210,11 @@ To access files through the macOS Finder: 2. The **Connect to Server...** window opens. .. image:: ../images/osx_webdav2.png - :alt: Screenshot: Enter Nextcloud server address in “Connect to Server” dialog box + :alt: Screenshot: Enter Nextcloud server address in “Connect to Server...” dialog box 3. Enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: - https://cloud.nextcloud.com/nextcloud/remote.php/dav/files/USERNAME/ + https://cloud.nextcloud.com/remote.php/dav/files/USERNAME/ 4. Click **Connect**. The WebDAV server will appear on the Desktop as a shared disk drive. From 7c32f13af325bc524edfd0d1ede217154389ca84 Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Fri, 22 Mar 2019 18:04:46 -0500 Subject: [PATCH 3/6] Update access_webdav.rst --- user_manual/files/access_webdav.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index f9175aca8..e6cdc5586 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -214,7 +214,7 @@ To access files through the macOS Finder: 3. Enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: - https://cloud.nextcloud.com/remote.php/dav/files/USERNAME/ + https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/ 4. Click **Connect**. The WebDAV server will appear on the Desktop as a shared disk drive. From a8c2ac7da451b82aa06077299eea6082f986d15b Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Fri, 22 Mar 2019 18:05:46 -0500 Subject: [PATCH 4/6] Update access_webdav.rst --- user_manual/files/access_webdav.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index e6cdc5586..99707dbc6 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -212,7 +212,7 @@ To access files through the macOS Finder: .. image:: ../images/osx_webdav2.png :alt: Screenshot: Enter Nextcloud server address in “Connect to Server...” dialog box -3. Enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: +3. As pictured above, enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/ From b8a6984215a2fe3ed37d0b6b34f2742b9a58b2bb Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Fri, 22 Mar 2019 18:15:04 -0500 Subject: [PATCH 5/6] Update access_webdav.rst --- user_manual/files/access_webdav.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 99707dbc6..6c04bbb4c 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -198,7 +198,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 `_ 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: @@ -216,7 +216,7 @@ To access files through the macOS Finder: https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/ -4. Click **Connect**. The WebDAV server will appear on the Desktop as a shared disk drive. +4. Click **Connect**. Your WebDAV server should appear on the Desktop as a shared disk drive. Accessing files using Microsoft Windows From f6fdd3c77ea5f3b51279ecd8c00f7b8a8b51a67f Mon Sep 17 00:00:00 2001 From: unamundan <37463152+unamundan@users.noreply.github.com> Date: Sat, 23 Mar 2019 22:06:32 -0500 Subject: [PATCH 6/6] Update access_webdav.rst --- user_manual/files/access_webdav.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 6c04bbb4c..12e64db04 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -207,16 +207,14 @@ To access files through the macOS Finder: .. image:: ../images/osx_webdav1.png :alt: Screenshot of entering your Nextcloud server address on macOS -2. The **Connect to Server...** window opens. +2. When the **Connect to Server...** window opens, enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: + + https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/ .. image:: ../images/osx_webdav2.png :alt: Screenshot: Enter Nextcloud server address in “Connect to Server...” dialog box -3. As pictured above, enter your Nexcloud server’s WebDAV address in the **Server Address:** field, ie: - - https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/ - -4. Click **Connect**. Your WebDAV server should appear on the Desktop as a shared disk drive. +3. Click **Connect**. Your WebDAV server should appear on the Desktop as a shared disk drive. Accessing files using Microsoft Windows