diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 8d5ffb70c..7558f0cc0 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -2,47 +2,47 @@ Accessing Nextcloud Files Using WebDAV ====================================== -Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize -with your Nextcloud files over WebDAV. In this chapter you will learn how to -connect Linux, Mac OS X, Windows, and mobile devices to your Nextcloud server via -WebDAV. Before we get into configuring WebDAV, let's take a quick look at the +Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize +with your Nextcloud files over WebDAV. In this chapter you will learn how to +connect Linux, Mac OS X, Windows, and mobile devices to your Nextcloud server via +WebDAV. Before we get into configuring WebDAV, let's take a quick look at the recommended way of connecting client devices to your Nextcloud servers. Nextcloud Desktop and Mobile Clients ------------------------------------ -The recommended method for keeping your desktop PC synchronized with your +The recommended method for keeping your desktop PC synchronized with your Nextcloud server is by using the `Nextcloud/ownCloud sync clients `_. You can configure the client -to save files in any local directory you want, and you choose which directories -on the Nextcloud server to sync with. The client displays the current connection -status and logs all activity, so you always know which remote files have been -downloaded to your PC, and you can verify that files created and updated on your +to save files in any local directory you want, and you choose which directories +on the Nextcloud server to sync with. The client displays the current connection +status and logs all activity, so you always know which remote files have been +downloaded to your PC, and you can verify that files created and updated on your local PC are properly synchronized with the server. -The recommended method for syncing your Nextcloud server with Android and -Apple iOS devices is by using the `mobile apps +The recommended method for syncing your Nextcloud server with Android and +Apple iOS devices is by using the `mobile apps `_. -To connect to your Nextcloud server with the mobile apps, use the +To connect to your Nextcloud server with the mobile apps, use the base URL and folder only:: example.com/nextcloud -In addition to the mobile apps provided by Nextcloud or Nextcloud, you can use other apps to -connect to Nextcloud from your mobile device using WebDAV. `WebDAV Navigator`_ is +In addition to the mobile apps provided by Nextcloud or ownCloud, you can use other apps to +connect to Nextcloud from your mobile device using WebDAV. `WebDAV Navigator`_ is a good (proprietary) app for `Android devices`_ and `iPhones`_. The URL to use on these is:: example.com/nextcloud/remote.php/dav/files/USERNAME/ - + WebDAV Configuration -------------------- -If you prefer, you may also connect your desktop PC to your Nextcloud server by -using the WebDAV protocol rather than using a special client application. Web -Distributed Authoring and Versioning (WebDAV) is a Hypertext Transfer Protocol -(HTTP) extension that makes it easy to create, read, and edit files on Web -servers. With WebDAV you can access your Nextcloud shares on Linux, Mac OS X and +If you prefer, you may also connect your desktop PC to your Nextcloud server by +using the WebDAV protocol rather than using a special client application. Web +Distributed Authoring and Versioning (WebDAV) is a Hypertext Transfer Protocol +(HTTP) extension that makes it easy to create, read, and edit files on Web +servers. With WebDAV you can access your Nextcloud shares on Linux, Mac OS X and Windows in the same way as any remote network share, and stay synchronized. .. note:: In the following examples, You must adjust **example.com/** to the @@ -56,12 +56,12 @@ You can access files in Linux operating systems using the following methods. Nautilus File Manager ^^^^^^^^^^^^^^^^^^^^^ -Use the ``davs://`` protocol to connect the Nautilus file manager to your +Use the ``davs://`` protocol to connect the Nautilus file manager to your Nextcloud share:: davs://example.com/nextcloud/remote.php/dav/files/USERNAME/ -.. note:: If your server connection is not HTTPS-secured, use `dav://` instead +.. note:: If your server connection is not HTTPS-secured, use `dav://` instead of `davs://`. .. image:: ../images/webdav_gnome3_nautilus.png @@ -70,7 +70,7 @@ Nextcloud share:: Accessing Files with KDE and Dolphin File Manager ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -To access your Nextcloud files using the Dolphin file manager in KDE, use +To access your Nextcloud files using the Dolphin file manager in KDE, use the ``webdav://`` protocol:: webdav://example.com/nextcloud/remote.php/dav/files/USERNAME/ @@ -90,73 +90,73 @@ You can create a permanent link to your Nextcloud server: * Name: The name you want to see in the **Places** bookmark, for example Nextcloud. * User: The Nextcloud username you used to log in, for example admin. - - * Server: The Nextcloud domain name, for example **example.com** (without + + * Server: The Nextcloud domain name, for example **example.com** (without **http://** before or directories afterwards). * Folder -- Enter the path ``nextcloud/remote.php/dav/files/USERNAME/``. -#. (Optional) Check the "Create icon checkbox" for a bookmark to appear in the +#. (Optional) Check the "Create icon checkbox" for a bookmark to appear in the Places column. -#. (Optional) Provide any special settings or an SSL certificate in the "Port & +#. (Optional) Provide any special settings or an SSL certificate in the "Port & Encrypted" checkbox. Creating WebDAV Mounts on the Linux Command Line ------------------------------------------------ -You can create WebDAV mounts from the Linux command line. This is useful if you -prefer to access Nextcloud the same way as any other remote filesystem mount. -The following example shows how to create a personal mount and have it mounted +You can create WebDAV mounts from the Linux command line. This is useful if you +prefer to access Nextcloud the same way as any other remote filesystem mount. +The following example shows how to create a personal mount and have it mounted automatically every time you log in to your Linux computer. -1. Install the ``davfs2`` WebDAV filesystem driver, which allows you to mount - WebDAV shares just like any other remote filesystem. Use this command to +1. Install the ``davfs2`` WebDAV filesystem driver, which allows you to mount + WebDAV shares just like any other remote filesystem. Use this command to install it on Debian/Ubuntu:: - + apt-get install davfs2 - + 2. Use this command to install it on CentOS, Fedora, and openSUSE:: - yum install davfs2 + yum install davfs2 3. Add yourself to the ``davfs2`` group:: usermod -aG davfs2 -3. Then create an ``nextcloud`` directory in your home directory for the +3. Then create an ``nextcloud`` directory in your home directory for the mountpoint, and ``.davfs2/`` for your personal configuration file:: - + mkdir ~/nextcloud mkdir ~/.davfs2 - -4. Copy ``/etc/davfs2/secrets`` to ``~/.davfs2``:: - cp /etc/davfs2/secrets ~/.davfs2/secrets - +4. Copy ``/etc/davfs2/secrets`` to ``~/.davfs2``:: + + cp /etc/davfs2/secrets ~/.davfs2/secrets + 5. Set yourself as the owner and make the permissions read-write owner only:: - + chown : ~/.davfs2/secrets chmod 600 ~/.davfs2/secrets - -6. Add your Nextcloud login credentials to the end of the ``secrets`` file, + +6. Add your Nextcloud login credentials to the end of the ``secrets`` file, using your Nextcloud server URL and your Nextcloud username and password:: example.com/nextcloud/remote.php/dav/files/USERNAME/ 7. Add the mount information to ``/etc/fstab``:: - example.com/nextcloud/remote.php/dav/files/USERNAME/ /home//nextcloud + example.com/nextcloud/remote.php/dav/files/USERNAME/ /home//nextcloud davfs user,rw,auto 0 0 -8. Then test that it mounts and authenticates by running the following +8. Then test that it mounts and authenticates by running the following command. If you set it up correctly you won't need root permissions:: mount ~/nextcloud - + 9. You should also be able to unmount it:: - + umount ~/nextcloud - -Now every time you login to your Linux system your Nextcloud share should -automatically mount via WebDAV in your ``~/nextcloud`` directory. If you prefer + +Now every time you login to your Linux system your Nextcloud share should +automatically mount via WebDAV in your ``~/nextcloud`` directory. If you prefer to mount it manually, change ``auto`` to ``noauto`` in ``/etc/fstab``. Known Issues @@ -168,22 +168,22 @@ Resource temporarily unavailable Solution ^^^^^^^^ -If you experience trouble when you create a file in the directory, +If you experience trouble when you create a file in the directory, edit ``/etc/davfs2/davfs2.conf`` and add:: use_locks 0 Problem -^^^^^^^ +^^^^^^^ Certificate warnings Solution -^^^^^^^^ +^^^^^^^^ -If you use a self-signed certificate, you will get a warning. To -change this, you need to configure ``davfs2`` to recognize your certificate. -Copy ``mycertificate.pem`` to ``/etc/davfs2/certs/``. Then edit -``/etc/davfs2/davfs2.conf`` and uncomment the line ``servercert``. Now add the +If you use a self-signed certificate, you will get a warning. To +change this, you need to configure ``davfs2`` to recognize your certificate. +Copy ``mycertificate.pem`` to ``/etc/davfs2/certs/``. Then edit +``/etc/davfs2/davfs2.conf`` and uncomment the line ``servercert``. Now add the path of your certificate as in this example:: servercert /etc/davfs2/certs/mycertificate.pem @@ -191,8 +191,8 @@ path of your certificate as in this example:: Accessing Files Using Mac OS X ------------------------------ -.. note:: The Mac OS X Finder suffers from a `series of implementation problems - `_ and should only be used if the +.. note:: The Mac OS X 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+**. To access files through the Mac OS X Finder: @@ -206,7 +206,7 @@ To access files through the Mac OS X Finder: .. image:: ../images/osx_webdav1.png :alt: Screenshot of entering your Nextcloud server address on Mac OS X - For example, the URL used to connect to the Nextcloud server + For example, the URL used to connect to the Nextcloud server from the Mac OS X Finder is:: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ @@ -217,9 +217,9 @@ To access files through the Mac OS X Finder: The device connects to the server. -For added details about how to connect to an external server using Mac OS X, -check the `vendor documentation -`_ +For added details about how to connect to an external server using Mac OS X, +check the `vendor documentation +`_ . Accessing Files Using Microsoft Windows --------------------------------------- @@ -227,12 +227,12 @@ Accessing Files Using Microsoft Windows It is best to use a suitable WebDAV client from the `WebDAV Project page `_ . -If you must use the native Windows implementation, you can map Nextcloud to a new -drive. Mapping to a drive enables you to browse files stored on an Nextcloud +If you must use the native Windows implementation, you can map Nextcloud to a new +drive. Mapping to a drive enables you to browse files stored on an Nextcloud server the way you would files stored in a mapped network drive. -Using this feature requires network connectivity. If you want to store your -files offline, use the Desktop Client to sync all files on your +Using this feature requires network connectivity. If you want to store your +files offline, use the Desktop Client to sync all files on your Nextcloud to one or more directories of your local hard drive. .. note:: Prior to mapping your drive, you must permit the use of Basic @@ -246,31 +246,31 @@ Nextcloud to one or more directories of your local hard drive. Mapping Drives With the Command Line ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The following example shows how to map a drive using the command line. To map +The following example shows how to map a drive using the command line. To map the drive: 1. Open a command prompt in Windows. -2. Enter the following line in the command prompt to map to the computer Z +2. Enter the following line in the command prompt to map to the computer Z drive:: - net use Z: https:///remote.php/dav/files/USERNAME/ /user:youruser + net use Z: https:///remote.php/dav/files/USERNAME/ /user:youruser yourpassword where is the URL to your Nextcloud server. -For example: ``net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ +For example: ``net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword`` The computer maps the files of your Nextcloud account to the drive letter Z. .. note:: Though not recommended, you can also mount the Nextcloud server using HTTP, leaving the connection unencrypted. If you plan to use HTTP - connections on devices while in a public place, we strongly recommend using a + connections on devices while in a public place, we strongly recommend using a VPN tunnel to provide the necessary security. An alternative command syntax is:: - net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser + net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser yourpassword Mapping Drives With Windows Explorer @@ -279,10 +279,10 @@ Mapping Drives With Windows Explorer To map a drive using the Microsoft Windows Explorer: 1. Migrate to your computer in Windows Explorer. -2. Right-click on **Computer** entry and select **Map network drive...** from +2. Right-click on **Computer** entry and select **Map network drive...** from the drop-down menu. 3. Choose a local network drive to which you want to map Nextcloud. -4. Specify the address to your Nextcloud instance, followed by +4. Specify the address to your Nextcloud instance, followed by **/remote.php/dav/files/USERNAME/**. For example:: @@ -290,8 +290,8 @@ To map a drive using the Microsoft Windows Explorer: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ .. note:: For SSL protected servers, check **Reconnect at logon** to ensure - that the mapping is persistent upon subsequent reboots. If you want to - connect to the Nextcloud server as a different user, check **Connect using + that the mapping is persistent upon subsequent reboots. If you want to + connect to the Nextcloud server as a different user, check **Connect using different credentials**. .. figure:: ../images/explorer_webdav.png @@ -300,14 +300,14 @@ To map a drive using the Microsoft Windows Explorer: 5. Click the ``Finish`` button. - Windows Explorer maps the network drive, making your Nextcloud instance + Windows Explorer maps the network drive, making your Nextcloud instance available. Accessing Files Using Cyberduck ------------------------------- -`Cyberduck `_ is an open source FTP and SFTP, -WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on +`Cyberduck `_ is an open source FTP and SFTP, +WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on Mac OS X and Windows. .. note:: This example uses Cyberduck version 4.2.1. @@ -323,10 +323,10 @@ your Nextcloud server supports SSL. Cyberduck requires that you select a different connection type if you plan to use SSL. For example: 80 (for WebDAV) - + 443 (for WebDAV (HTTPS/SSL)) -3. Use the 'More Options' drop-down menu to add the rest of your WebDAV URL into +3. Use the 'More Options' drop-down menu to add the rest of your WebDAV URL into the 'Path' field. For example: ``remote.php/dav/files/USERNAME/`` @@ -355,17 +355,17 @@ Windows does not connect using HTTPS. Solution 1 ^^^^^^^^^^ -The Windows WebDAV Client might not support Server Name Indication (SNI) on -encrypted connections. If you encounter an error mounting an SSL-encrypted -Nextcloud instance, contact your provider about assigning a dedicated IP address +The Windows WebDAV Client might not support Server Name Indication (SNI) on +encrypted connections. If you encounter an error mounting an SSL-encrypted +Nextcloud instance, contact your provider about assigning a dedicated IP address for your SSL-based server. Solution 2 ^^^^^^^^^^ -The Windows WebDAV Client might not support TSLv1.1 / TSLv1.2 connections. If -you have restricted your server config to only provide TLSv1.1 and above the -connection to your server might fail. Please refer to the WinHTTP_ documentation +The Windows WebDAV Client might not support TSLv1.1 / TSLv1.2 connections. If +you have restricted your server config to only provide TLSv1.1 and above the +connection to your server might fail. Please refer to the WinHTTP_ documentation for further information. .. _WinHTTP: https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925.aspx#WinHTTP_5.1_Features @@ -373,19 +373,19 @@ for further information. Problem ^^^^^^^ -You receive the following error message: **Error 0x800700DF: The file size +You receive the following error message: **Error 0x800700DF: The file size exceeds the limit allowed and cannot be saved.** Solution ^^^^^^^^ -Windows limits the maximum size a file transferred from or to a WebDAV share -may have. You can increase the value **FileSizeLimitInBytes** in -**HKEY_LOCAL_MacHINE\\SYSTEM\\CurrentControlSet\\Services\\WebClient\\Parameters -** by clicking on **Modify**. +Windows limits the maximum size a file transferred from or to a WebDAV share +may have. You can increase the value **FileSizeLimitInBytes** in +**HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\WebClient\\Parameters** +by clicking on **Modify**. -To increase the limit to the maximum value of 4GB, select **Decimal**, enter a -value of **4294967295**, and reboot Windows or restart the **WebClient** +To increase the limit to the maximum value of 4GB, select **Decimal**, enter a +value of **4294967295**, and reboot Windows or restart the **WebClient** service. Problem @@ -397,7 +397,7 @@ Solution ^^^^^^^^ Known problems and their solutions are documented in the KB2123563_ article. - + Problem ^^^^^^^ Cannot map Nextcloud as a WebDAV drive in Windows using self-signed certificate. @@ -406,31 +406,31 @@ Solution ^^^^^^^^ #. Go to the your Nextcloud instance via your favorite Web browser. - #. Click through until you get to the certificate error in the browser status + #. Click through until you get to the certificate error in the browser status line. #. View the cert, then from the Details tab, select Copy to File. - #. Save to the desktop with an arbitrary name, for example ``myNextcloud.cer``. + #. Save to the desktop with an arbitrary name, for example ``myNextcloud.pem``. #. Start, Run, MMC. - #. File, Add/Remove Snap-In. + #. File, Add/Remove Snap-In. #. Select Certificates, Click Add, My User Account, then Finish, then OK. #. Dig down to Trust Root Certification Authorities, Certificates. #. Right-Click Certificate, Select All Tasks, Import. #. Select the Save Cert from the Desktop. #. Select Place all Certificates in the following Store, Click Browse, - #. Check the Box that says Show Physical Stores, Expand out Trusted Root - Certification Authorities, and select Local Computer there, click OK, + #. Check the Box that says Show Physical Stores, Expand out Trusted Root + Certification Authorities, and select Local Computer there, click OK, Complete the Import. - #. Check the list to make sure it shows up. You will probably need to Refresh + #. Check the list to make sure it shows up. You will probably need to Refresh before you see it. Exit MMC. #. Open Browser, select Tools, Delete Browsing History. #. Select all but In Private Filtering Data, complete. #. Go to Internet Options, Content Tab, Clear SSL State. #. Close browser, then re-open and test. - + Problem ^^^^^^^ -You cannot download more than 50 MB or upload large Files when the upload takes +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. Solution @@ -443,7 +443,7 @@ Accessing Files Using cURL -------------------------- Since WebDAV is an extension of HTTP cURL can be used to script file operations. - + To create a folder with the current date as name: .. code-block:: bash diff --git a/user_manual/files/access_webgui.rst b/user_manual/files/access_webgui.rst index d53319814..d0a18d46b 100644 --- a/user_manual/files/access_webgui.rst +++ b/user_manual/files/access_webgui.rst @@ -2,132 +2,132 @@ Accessing your Files Using the Nextcloud Web Interface ====================================================== -You can access your Nextcloud files with the Nextcloud Web interface and create, -preview, edit, delete, share, and re-share files. Your Nextcloud administrator -has the option to disable these features, so if any of them are missing on your +You can access your Nextcloud files with the Nextcloud Web interface and create, +preview, edit, delete, share, and re-share files. Your Nextcloud administrator +has the option to disable these features, so if any of them are missing on your system ask your server administrator. .. figure:: ../images/files_page.png :alt: The Files view screen. - + Tagging Files ------------- -You can assign tags to files. To create tags, open a file to the Details view. -Then type your tags. To enter more than one tag press the return key after -creating each tag. All tags are system tags, and are shared by all users on your +You can assign tags to files. To create tags, open a file to the Details view. +Then type your tags. To enter more than one tag press the return key after +creating each tag. All tags are system tags, and are shared by all users on your Nextcloud server. .. figure:: ../images/files_page-7.png :alt: Creating file tags. - + Then use the Tags filter on the left sidebar to filter files by tags. .. figure:: ../images/files_page-8.png :alt: Viewing file tags. - + Comments -------- - -Use the Details view to add and read comments on any file or folder. Comments + +Use the Details view to add and read comments on any file or folder. Comments are visible to everyone who has access to the file. .. figure:: ../images/file_menu_comments_2.png :alt: Creating and viewing comments. - + Video Player ------------ -You can play videos in Nextcloud with the Video Player app by simply clicking on -the file. Video streaming by the native Nextcloud video player depends on your Web browser -and the video format. If your Nextcloud administrator has enabled video -streaming, and it doesn't work in your Web browser, it may be a browser issue. See https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#Browser_compatibility for supported multimedia formats in Web browsers. +You can play videos in Nextcloud with the Video Player app by simply clicking on +the file. Video streaming by the native Nextcloud video player depends on your Web browser +and the video format. If your Nextcloud administrator has enabled video +streaming, and it doesn't work in your Web browser, it may be a browser issue. See https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#Browser_compatibility for supported multimedia formats in Web browsers. .. figure:: ../images/video_player_2.png :alt: Watching a movie. - + File Controls ------------- - -Nextcloud can display thumbnail previews for image files, MP3 covers, -and text files, if this enabled by your server administrator. Hover your cursor + +Nextcloud can display thumbnail previews for image files, MP3 covers, +and text files, if this enabled by your server administrator. Hover your cursor over a file or folder to expose the controls for the following operations: Favorites - Click the star to the left of the file icon to mark it as a favorite, and - quickly find all of your favorites with the Favorites filter on the left + Click the star to the left of the file icon to mark it as a favorite, and + quickly find all of your favorites with the Favorites filter on the left sidebar. - + .. figure:: ../images/files_page-1.png :alt: Marking Favorite files. - -Share - Share the file or folder with a group or other users, and create public - shares with hyperlinks. You can also see who you have shared with already, - and revoke shares by clicking the trash can icon. - -.. note:: New in 9.0, you can see all re-shares of your original file shares. - If username auto-completion - is enabled, when you start typing the user or group name Nextcloud will - automatically complete it for you. If your administrator has enabled email - notifications, you can send an email notification of the new share from the +Share + Share the file or folder with a group or other users, and create public + shares with hyperlinks. You can also see who you have shared with already, + and revoke shares by clicking the trash can icon. + +.. note:: Since version 9.0, you can see all re-shares of your original file shares. + + If username auto-completion + is enabled, when you start typing the user or group name Nextcloud will + automatically complete it for you. If your administrator has enabled email + notifications, you can send an email notification of the new share from the sharing screen. - + .. figure:: ../images/files_page-2.png :alt: Sharing files. - + You have five share permissions: - + * Can share; allows the users you share with to re-share. * Can edit; allows the users you share with to edit your shared files, and to collaborate using the Documents app. * Create; allows the users you share with to create new files and add them to the share. * Change; allows uploading a new version of a shared file and replacing it. * Delete; allows the users you share with to delete shared files. -Overflow Menu - The Overflow menu (three dots) displays file details, and allows you to +Overflow Menu + The Overflow menu (three dots) displays file details, and allows you to rename, download, or delete files. - + .. figure:: ../images/files_page-3.png :alt: Overflow menu. - - The Details view shows Activities, Sharing, and Versions information. - + + The Details view shows Activities, Sharing, and Versions information. + .. figure:: ../images/files_page-4.png - :alt: Details screen. - -The **Settings** gear icon at the lower left allows you to show or hide hidden -files in your Nextcloud Web interface. These are also called dotfiles, because -they are prefixed with a dot, e.g. ``.mailfile``. The dot tells your operating -system to hide these files in your file browsers, unless you choose to display -them. Usually these are configuration files, so having the option to hide them + :alt: Details screen. + +The **Settings** gear icon at the lower left allows you to show or hide hidden +files in your Nextcloud Web interface. These are also called dotfiles, because +they are prefixed with a dot, e.g. ``.mailfile``. The dot tells your operating +system to hide these files in your file browsers, unless you choose to display +them. Usually these are configuration files, so having the option to hide them reduces clutter. .. figure:: ../images/hidden_files.png - :alt: Hiding or displaying hidden files. - + :alt: Hiding or displaying hidden files. + Previewing Files ---------------- -You can display uncompressed text files, OpenDocument files, videos, and image -files in the Nextcloud embedded viewers by clicking on the file name. There may -be other file types you can preview if your Nextcloud administrator has enabled -them. If Nextcloud cannot display a file, it starts a download process and -downloads the file to your computer. +You can display uncompressed text files, OpenDocument files, videos, and image +files in the Nextcloud embedded viewers by clicking on the file name. There may +be other file types you can preview if your Nextcloud administrator has enabled +them. If Nextcloud cannot display a file, it starts a download process and +downloads the file to your computer. Navigating Inside Your Nextcloud -------------------------------- -Navigating through folders in Nextcloud is as simple as clicking on a folder to -open it and using the back button on your browser to move to a previous level. -Nextcloud also provides a navigation bar at the top of the Files field for quick +Navigating through folders in Nextcloud is as simple as clicking on a folder to +open it and using the back button on your browser to move to a previous level. +Nextcloud also provides a navigation bar at the top of the Files field for quick navigation. Sharing Status Icons -------------------- -Any folder that has been shared is marked with the ``Shared`` overlay icon. +Any folder that has been shared is marked with the ``Shared`` overlay icon. Public link shares are marked with a chain link. Un-shared folders are blank. .. figure:: ../images/files_page-5.png @@ -136,7 +136,7 @@ Public link shares are marked with a chain link. Un-shared folders are blank. Creating or Uploading Files and Directories ------------------------------------------- -Upload or create new files or folders directly in an Nextcloud folder by clicking +Upload or create new files or folders directly in an Nextcloud folder by clicking on the *New* button in the Files app. .. figure:: ../images/files_page-6.png @@ -145,24 +145,24 @@ on the *New* button in the Files app. The *New* button provides the following options: Up arrow - Upload files from your computer into Nextcloud. You can also upload files by + Upload files from your computer into Nextcloud. You can also upload files by dragging and dropping them from your file manager. Text file Creates a new text file and adds the file to your current folder. - + Folder Creates a new folder in the current folder. - + Selecting Files or Folders -------------------------- -You can select one or more files or folders by clicking on their checkboxes. To -select all files in the current directory, click on the checkbox located at the +You can select one or more files or folders by clicking on their checkboxes. To +select all files in the current directory, click on the checkbox located at the top of the files listing. -When you select multiple files, you can delete all of them, or download them as -a ZIP file by using the ``Delete`` or ``Download`` buttons that appear at the +When you select multiple files, you can delete all of them, or download them as +a ZIP file by using the ``Delete`` or ``Download`` buttons that appear at the top. .. note:: If the ``Download`` button is not visible, the administrator has @@ -171,14 +171,14 @@ top. Filtering the Files View ------------------------ -The right sidebar on the Files page contains several filters for quickly sorting +The left sidebar on the Files page contains several filters for quickly sorting and managing your files. All files The default view; displays all files that you have access to. - + Favorites - Files or folders marked with the yellow star. + Files or folders marked with the yellow star. Shared with you Displays all files shared with you by another user or group. @@ -188,9 +188,9 @@ Shared with others Shared by link Displays all files that are shared by you via public link. - -External Storage - Files that you have access to on external storage devices and services such + +External Storage (optional) + Files that you have access to on external storage devices and services such as Dropbox, Google, and Amazon S3. Moving Files @@ -202,16 +202,16 @@ You can move files and folders by dragging and dropping them into any directory. Change in Share Expiration Date ------------------------------- -In older versions of Nextcloud, you could set an expiration date on both local -and public shares. Now you can set an expiration date only on public shares, -and local shares do not expire when public shares expire. The only way to +In older versions of Nextcloud, you could set an expiration date on both local +and public shares. Now you can set an expiration date only on public shares, +and local shares do not expire when public shares expire. The only way to "expire" a local share is to click the trash can icon to un-share your files. Creating or Connecting to a Federation Share Link ------------------------------------------------- -Federated Cloud Sharing allows you to mount file shares from remote Nextcloud -servers, and manage them just like a local share. In Nextcloud 9 the process for -creating a new sharing link is easier and more streamlined. See -:doc:`federated_cloud_sharing` to learn to how to create and connect to new +Federated Cloud Sharing allows you to mount file shares from remote Nextcloud +servers, and manage them just like a local share. In Nextcloud 9 the process for +creating a new sharing link is easier and more streamlined. See +:doc:`federated_cloud_sharing` to learn to how to create and connect to new Federated Cloud shares.