mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #362 from nextcloud/stable11-361

Browse Source 
Fix english translation
This commit is contained in:
Morris Jobke 2017-02-20 10:57:51 -06:00 committed by GitHub
commit 552f52f3e5
14 changed files with 397 additions and 398 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
developer_manual/app/css.rst
View File

@ -140,6 +140,7 @@ To add actions that affect the current list element you can add a menu for secon
</div>
</li>
</ul>
</div>
The div with the class **app-navigation-entry-utils** contains only the button (class: **app-navigation-entry-utils-menu-button**) to display the menu but in many cases another entry is needed to display some sort of count (mails count, unread feed count, etc.). In that case add the **with-counter** class to the list entry to adjust the correct padding and text-oveflow of the entry's title.

224
user_manual/files/access_webdav.rst
View File

@ -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
<https://nextcloud.com/install/#install-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
<https://nextcloud.com/install/>`_.
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 <username>
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 <username>:<username> ~/.davfs2/secrets
chown <username>:<username> ~/.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/ <username> <password>
7. Add the mount information to ``/etc/fstab``::
example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<username>/nextcloud
example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<username>/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,31 +168,31 @@ 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
servercert /etc/davfs2/certs/mycertificate.pem
Accessing Files Using Mac OS X
------------------------------
.. note:: The Mac OS X Finder suffers from a `series of implementation problems
<http://sabre.io/dav/clients/finder/>`_ and should only be used if the
.. note:: The Mac OS X Finder suffers from a `series of implementation problems
<http://sabre.io/dav/clients/finder/>`_ 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
<http://docs.info.apple.com/article.html?path=Mac/10.6/en/8160.html>`_
For added details about how to connect to an external server using Mac OS X,
check the `vendor documentation
<http://docs.info.apple.com/article.html?path=Mac/10.6/en/8160.html>`_ .
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 <http://www.webdav.org/projects/>`_ .
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
@ -241,36 +241,36 @@ Nextcloud to one or more directories of your local hard drive.
Please follow the Knowledge Base article before proceeding, and follow the
Vista instructions if you run Windows 7.
.. _KB841215: http://support.microsoft.com/kb/841215
.. _KB841215: https://support.microsoft.com/kb/841215
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://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser
net use Z: https://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser
yourpassword
where <drive_path> 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
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
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 <https://cyberduck.io/?l=en>`_ is an open source FTP and SFTP,
WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on
`Cyberduck <https://cyberduck.io/?l=en>`_ 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.
@ -318,15 +318,15 @@ To use Cyberduck:
``example.com``
2. Specify the appropriate port. The port you choose depends on whether or not
2. Specify the appropriate port. The port you choose depends on whether or not
your Nextcloud server supports SSL. Cyberduck requires that you select a
different connection type if you plan to use SSL. For example:
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

164
user_manual/files/access_webgui.rst
View File

@ -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.

49
user_manual/files/deleted_file_management.rst
View File

@ -2,56 +2,55 @@
Managing Deleted Files
======================
When you delete a file in Nextcloud, it is not immediately deleted permanently.
Instead, it is moved into the trash bin. It is not permanently deleted until
you manually delete it, or when the Deleted Files app deletes it to make room
When you delete a file in Nextcloud, it is not immediately deleted permanently.
Instead, it is moved into the trash bin. It is not permanently deleted until
you manually delete it, or when the Deleted Files app deletes it to make room
for new files.
Find your deleted files by clicking on the **Deleted files**
button on the Files page of the Nextcloud Web interface. You'll have options to
Find your deleted files by clicking on the **Deleted files**
button on the Files page of the Nextcloud Web interface. You'll have options to
either restore or permanently delete files.
Quotas
------
Deleted files are not counted against your storage quota. Only files that
originate with users count against their quotas, not files
shared with them that originate from other users. (See :doc:`quota` to learn
more about quotas.)
Deleted files are not counted against your storage quota. Only your personal
files count against your quota, not files which were shared with you.
(See :doc:`quota` to learn more about quotas.)
What Happens When Shared Files Are Deleted
------------------------------------------
Deleting files gets a little complicated when they are shared files, as this
Deleting files gets a little complicated when they are shared files, as this
scenario illustrates:
1. User1 shares a folder "test" with User2 and User3
2. User2 (the recipient) deletes a file/folder "sub" inside of "test"
3. The folder "sub" will be moved to the trashbin of both User1 (owner) and
3. The folder "sub" will be moved to the trashbin of both User1 (owner) and
User2 (recipient)
4. But User3 will not have a copy of "sub" in her trash bin
When User1 deletes "sub" then it is moved to User1's trash bin. It is
When User1 deletes "sub" then it is moved to User1's trash bin. It is
deleted from User2 and User3, but not placed in their trash bins.
When you share files, other users may copy, rename, move, and share them with
other people, just as they can for any computer files; Nextcloud does not have
When you share files, other users may copy, rename, move, and share them with
other people, just as they can for any computer files; Nextcloud does not have
magic powers to prevent this.
How the Deleted Files app Manages Storage Space
-----------------------------------------------
To ensure that users do not run over their storage quotas, the Deleted Files
app allocates a maximum of 50% of their currently available free space to
deleted files. If your deleted files exceed this limit, Nextcloud deletes the
oldest files (files with the oldest timestamps from when they were deleted)
To ensure that users do not run over their storage quotas, the Deleted Files
app allocates a maximum of 50% of their currently available free space to
deleted files. If your deleted files exceed this limit, Nextcloud deletes the
oldest files (files with the oldest timestamps from when they were deleted)
until it meets the memory usage limit again.
Nextcloud checks the age of deleted files every time new files are added to the
deleted files. By default, deleted files stay in the trash bin for 180 days. The
Nextcloud server administrator can adjust this value in the ``config.php`` file
by setting the ``trashbin_retention_obligation`` value. Files older than the
``trashbin_retention_obligation`` value will be deleted permanently.
Additionally, Nextcloud calculates the maximum available space every time a new
file is added. If the deleted files exceed the new maximum allowed space
Nextcloud checks the age of deleted files every time new files are added to the
deleted files. By default, deleted files stay in the trash bin for 180 days. The
Nextcloud server administrator can adjust this value in the ``config.php`` file
by setting the ``trashbin_retention_obligation`` value. Files older than the
``trashbin_retention_obligation`` value will be deleted permanently.
Additionally, Nextcloud calculates the maximum available space every time a new
file is added. If the deleted files exceed the new maximum allowed space
Nextcloud will expire old deleted files until the limit is met once again.

11
user_manual/files/desktop_mobile_sync.rst
View File

@ -7,26 +7,25 @@ For synchronizing files with your desktop computer, we recommend using the
Sync Client will be released..
The Nextcloud Desktop Sync Client enables you to connect to your private
Nextcloud Server.
The Nextcloud Desktop Sync Client enables you to connect to your Nextcloud Server.
You can create folders in your home directory, and keep the contents of those
folders synced with your Nextcloud server. Simply copy a file into the directory
and the Nextcloud desktop client does the rest. Make a change to the files on one
computer, it will flow across the others using these desktop sync clients.
computer, it will flow across the others using these desktop sync clients.
You will always
have your latest files with you wherever you are.
Its usage is documented separately in the `Nextcloud Desktop Client Manual`_.
.. _Nextcloud Sync Client: https://nextcloud.com/install/
.. _Nextcloud Desktop Client Manual: https://docs.nextcloud.org/
.. _Nextcloud Desktop Client Manual: https://docs.nextcloud.org/
Mobile Clients
--------------
Visit your Personal page in your Nextcloud Web interface to find download links
for Android and iOS mobile sync clients. Or, visit the `Nextcloud download page
for Android and iOS mobile sync clients. Or, visit the `Nextcloud download page
<https://nextcloud.com/install/>`_.
Visit the `Nextcloud documentation page <https://docs.nextcloud.org/>`_ to read
Visit the `Nextcloud documentation page <https://docs.nextcloud.org/>`_ to read
the user manuals.

104
user_manual/files/encrypting_files.rst
View File

@ -2,38 +2,38 @@
Encrypting Your Nextcloud Files
===============================
Nextcloud includes an Encryption app, and when it is enabled by your Nextcloud
administrator all of your Nextcloud data files are automatically encrypted.
Encryption is server-wide, so when it is enabled you cannot choose to keep your
files unencrypted. You don't have to do anything special, as it uses your
Nextcloud login as the password for your unique private encryption key. Just log
in and out and manage and share your files as you normally do, and you can
Nextcloud includes an Encryption app, and when it is enabled by your Nextcloud
administrator all of your Nextcloud data files are automatically encrypted.
Encryption is server-wide, so when it is enabled you cannot choose to keep your
files unencrypted. You don't have to do anything special, as it uses your
Nextcloud login as the password for your unique private encryption key. Just log
in and out and manage and share your files as you normally do, and you can
still change your password whenever you want.
Its main purpose is to encrypt files on remote storage services that are
connected to your Nextcloud server, such as Dropbox and Google Drive. This is an
easy and seamless way to protect your files on remote storage. You can share
your remote files through Nextcloud in the usual way, however you cannot share
your encrypted files directly from Dropbox, Google Drive, or whatever remote
service you are using, because the encryption keys are stored on your Nextcloud
server, and are never exposed to outside service providers.
Its main purpose is to encrypt files on remote storage services that are
connected to your Nextcloud server, such as Dropbox and Google Drive. This is an
easy and seamless way to protect your files on remote storage. You can share
your remote files through Nextcloud in the usual way, however you cannot share
your encrypted files directly from Dropbox, Google Drive, or whatever remote
service you are using, because the encryption keys are stored on your Nextcloud
server, and are never exposed to outside service providers.
If your Nextcloud server is not connected to any remote storage services, then
it is better to use some other form of encryption such as file-level or whole
disk encryption. Because the keys are kept on your Nextcloud server, it is
possible for your Nextcloud admin to snoop in your files, and if the server is
compromised the intruder may get access to your files. (Read
`How Nextcloud uses encryption to protect your data
<https://owncloud.org/blog/how-owncloud-uses-encryption-to-protect-your-data/>`_
If your Nextcloud server is not connected to any remote storage services, then
it is better to use some other form of encryption such as file-level or whole
disk encryption. Because the keys are kept on your Nextcloud server, it is
possible for your Nextcloud admin to snoop in your files, and if the server is
compromised the intruder may get access to your files. (Read
`How Nextcloud uses encryption to protect your data
<https://owncloud.org/blog/how-owncloud-uses-encryption-to-protect-your-data/>`_
to learn more.)
Encryption FAQ
--------------
How Can Encryption Be Disabled?
How Can Encryption Be Disabled?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The only way to disable encryption is to run the :ref:`"decrypt all" <encryption_label>`
The only way to disable encryption is to run the :ref:`"decrypt all" <encryption_label>`
script, which decrypts all files and disables encryption.
Is It Possible To Disable Encryption With The Recovery Key?
@ -49,9 +49,9 @@ Can Encryption Be Disabled Without The User’s Password?
If you don't have the users password or :ref:`file recovery key
<enable-file-recovery-key>` then there is no way to decrypt all files. What's
more, running it on login would be dangerous, because you would most likely run
into timeouts.
into timeouts.
Is It Planned To Move This To The Next User Login Or A Background Job?
Is It Planned To Move This To The Next User Login Or A Background Job?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If we did that, then we would need to store your login password in the database.
@ -66,52 +66,52 @@ works with the master key.
Using Encryption
----------------
Nextcloud encryption is pretty much set it and forget it, but you have a few
options you can use.
Nextcloud encryption is pretty much set it and forget it, but you have a few
options you can use.
When your Nextcloud admin enables encryption for the first time, you must log
out and then log back in to create your encryption keys and encrypt your files.
When encryption has been enabled on your Nextcloud server you will see a yellow
When your Nextcloud admin enables encryption for the first time, you must log
out and then log back in to create your encryption keys and encrypt your files.
When encryption has been enabled on your Nextcloud server you will see a yellow
banner on your Files page warning you to log out and then log back in.
.. figure:: ../images/encryption1.png
When you log back in it takes a few minutes to work, depending on how many
When you log back in it takes a few minutes to work, depending on how many
files you have, and then you are returned to your default Nextcloud page.
.. figure:: ../images/encryption2.png
.. note:: You must never lose your Nextcloud password, because you will lose
access to your files. Though there is an optional recovery option that your
Nextcloud administrator may enable; see the Recovery Key Password section
.. note:: You must never lose your Nextcloud password, because you will lose
access to your files. Though there is an optional recovery option that your
Nextcloud administrator may enable; see the Recovery Key Password section
(below) to learn about this.
Sharing Encrypted Files
-----------------------
Only users who have private encryption keys have access to shared encrypted
files and folders. Users who have not yet created their private encryption keys
will not have access to encrypted shared files; they will see folders and
filenames, but will not be able to open or download the files. They will see a
yellow warning banner that says "Encryption App is enabled but your keys are not
Only users who have private encryption keys have access to shared encrypted
files and folders. Users who have not yet created their private encryption keys
will not have access to encrypted shared files; they will see folders and
filenames, but will not be able to open or download the files. They will see a
yellow warning banner that says "Encryption App is enabled but your keys are not
initialized, please log-out and log-in again."
Share owners may need to re-share files after encryption is enabled; users
trying to access the share will see a message advising them to ask the share
owner to re-share the file with them. For individual shares, un-share and
re-share the file. For group shares, share with any individuals who can't access
the share. This updates the encryption, and then the share owner can remove the
Share owners may need to re-share files after encryption is enabled; users
trying to access the share will see a message advising them to ask the share
owner to re-share the file with them. For individual shares, un-share and
re-share the file. For group shares, share with any individuals who can't access
the share. This updates the encryption, and then the share owner can remove the
individual shares.
Recovery Key Password
~~~~~~~~~~~~~~~~~~~~~
If your Nextcloud administrator has enabled the recovery key feature, you can
choose to use this feature for your account. If you enable "Password recovery"
the administrator can read your data with a special password. This feature
enables the administrator to recover your files in the event you lose your
Nextcloud password. If the recovery key is not enabled, then there is no way to
If your Nextcloud administrator has enabled the recovery key feature, you can
choose to use this feature for your account. If you enable "Password recovery"
the administrator can read your data with a special password. This feature
enables the administrator to recover your files in the event you lose your
Nextcloud password. If the recovery key is not enabled, then there is no way to
restore your files if you lose your login password.
.. figure:: ../images/encryption3.png
@ -119,7 +119,7 @@ restore your files if you lose your login password.
Files Not Encrypted
-------------------
Only the data in your files is encrypted, and not the filenames or folder
Only the data in your files is encrypted, and not the filenames or folder
structures. These files are never encrypted:
- Old files in the trash bin.
@ -128,7 +128,7 @@ structures. These files are never encrypted:
- The search index from the full text search app.
- Third-party app data
There may be other files that are not encrypted; only files that are exposed to
There may be other files that are not encrypted; only files that are exposed to
third-party storage providers are guaranteed to be encrypted.
Change Private Key Password
@ -136,7 +136,7 @@ Change Private Key Password
This option is only available if your log-in password, but not your encryption
password, was changed by your administrator. This can occur if your Nextcloud
provider uses a external user back-end (for example, LDAP) and changed your
provider uses an external user back-end (for example, LDAP) and changed your
login password using that back-end configuration. In this case, you can set
your encryption password to your new login password by providing your old and
new login password. The Encryption app works only if your login password and

18
user_manual/files/file_drop.rst
View File

@ -5,7 +5,7 @@ Making Anonymous Uploads
You may create your own special upload directories so that other people can upload
files to you without having to log in to the server, and without being an Nextcloud
user.
They will not be allowed to see the contents of this directory, or to make any
They will not be allowed to see the contents of this directory, or to make any
changes. This is an excellent alternative to sending large attachments via email,
using an FTP server, or using commercial file-sharing services.
@ -18,25 +18,25 @@ made to.
.. image:: ../images/anonym_click_sharing.png
Check Share Link, Allow editing, Hide file listing.
.. image:: ../images/anonym_hide_file_listing.png
Now you can send the link to the uploadfolder manualy or by using the
Now you can send the link to the upload folder manually or by using the
Nextcloud send function, if your administrator has enabled it.
Uploading Files
---------------
Using the anonymous upload function is simple. You receive a link to the upload
folder, click the link, and then you'll see an Nextcloud page with a **Click to
Using the anonymous upload function is simple. You receive a link to the upload
folder, click the link, and then you'll see an Nextcloud page with a **Click to
upload** button.
.. image:: ../images/anonym_upload.png
This opens a file picker, and you select the file or directory you want to
upload. You're also able to just drop files into the window.
This opens a file picker, and you select the file or directory you want to
upload. You're also able to just drop files into the window.
When your upload is completed, the filenames are listed:
.. image:: ../images/anonym_uploaded_files.png

128
user_manual/files/gallery_app.rst
View File

@ -2,22 +2,22 @@
Gallery App
===========
The Pictures app has been rewritten and improved, and is now called the Gallery
app. It supports more image formats, sorting, zoom, and scrolling. It also
The Pictures app has been rewritten and improved, and is now called the Gallery
app. It supports more image formats, sorting, zoom, and scrolling. It also
supports advanced customizations via a simple text file.
On your main Nextcloud Files page, click the little icon at the top right,
underneath your username, to open your Gallery. The Gallery app automatically
finds all images in your Nextcloud folders, and overlays the thumbnails with the
folder names. Click on the folder thumbnails to open the folders. At the top
On your main Nextcloud Files page, click the little icon at the top right,
underneath your username, to open your Gallery. The Gallery app automatically
finds all images in your Nextcloud folders, and overlays the thumbnails with the
folder names. Click on the folder thumbnails to open the folders. At the top
left you have two sorting options, alphabetical and by date.
.. figure:: ../images/gallery-1.png
:alt: Gallery folder thumbnails.
After entering any folder, click on any image to open it in slideshow mode.
This has the following features: a download button at the top center, forward
and back buttons at the right and left sides, an automatic slideshow button at
After entering any folder, click on any image to open it in slideshow mode.
This has the following features: a download button at the top center, forward
and back buttons at the right and left sides, an automatic slideshow button at
the bottom right, and a close button at the top right.
.. figure:: ../images/gallery-2.png
@ -25,13 +25,13 @@ the bottom right, and a close button at the top right.
Custom Configuration
--------------------
You may customize a Gallery album with a simple text file named
**gallery.cnf**, which contains parameters structured using the
`Yaml <https://en.wikipedia.org/wiki/YAML>`_ markup language. You may have
multiple **gallery.cnf** files; you need one in your own root Nextcloud folder
(your Home folder) that defines global features, and then you may have
individual per-album **gallery.cnf** files if you want to define different
You may customize a Gallery album with a simple text file named
**gallery.cnf**, which contains parameters structured using the
`Yaml <https://en.wikipedia.org/wiki/YAML>`_ markup language. You may have
multiple **gallery.cnf** files; you need one in your own root Nextcloud folder
(your Home folder) that defines global features, and then you may have
individual per-album **gallery.cnf** files if you want to define different
behaviors in different albums.
Features
@ -53,20 +53,20 @@ The following album features are currently implemented:
The following slideshow features are currently implemented:
* Showing a button which lets you pick which background, either black or
white, to use for the picture you are currently viewing (for images with
* Showing a button which lets you pick which background, either black or
white, to use for the picture you are currently viewing (for images with
transparent backgrounds).
Setup
^^^^^
The configuration file has to be named **gallery.cnf**. You may have multiple
per-album **gallery.cnf** files. To enable global features, place one in your
top-level folder, which is symbolised in the Web GUI by the home icon. (This
puts it in ``data/<user>/files/``.) See :ref:`an example below
The configuration file has to be named **gallery.cnf**. You may have multiple
per-album **gallery.cnf** files. To enable global features, place one in your
top-level folder, which is symbolised in the Web GUI by the home icon. (This
puts it in ``data/<user>/files/``.) See :ref:`an example below
<supported_variables_label>` in the **Global features** section.
.. note:: You need to refresh your browser after changing your configuration to
.. note:: You need to refresh your browser after changing your configuration to
see your changes.
Format
@ -77,13 +77,13 @@ UTF-8, **without BOM**. A file created from within the Nextcloud Web GUI works.
Structure
^^^^^^^^^
You should include a comment in the file, so that people stumbling upon
You should include a comment in the file, so that people stumbling upon
the file know what it's for. Comments start with #.
Spacing is created using 2 spaces. **Do not use tabs.**
Take a look at the `YAML Format documentation
<http://symfony.com/doc/current/components/yaml/yaml_format.html>`_ if you are
Take a look at the `YAML Format documentation
<https://symfony.com/doc/current/components/yaml/yaml_format.html>`_ if you are
getting error messages.
Here is an example `gallery.cnf`::
@ -98,10 +98,10 @@ Here is an example `gallery.cnf`::
background: "#ff9f00"
inherit: yes
information:
description: This is an **album description** which is only shown if there
description: This is an **album description** which is only shown if there
is no `description_link`
description_link: readme.md
copyright: Copyright 2003-2016 [interfaSys sàrl](http://www.interfasys.ch),
copyright: Copyright 2003-2016 [interfaSys sàrl](https://www.interfasys.ch),
Switzerland
copyright_link: copyright.md
inherit: yes
@ -109,8 +109,8 @@ Here is an example `gallery.cnf`::
type: date
order: des
inherit: yes
.. _supported_variables_label:
.. _supported_variables_label:
Supported Variables
^^^^^^^^^^^^^^^^^^^
@ -119,77 +119,77 @@ Supported Variables
Place this in your root Nextcloud folder, which is your Home folder.
* **external_shares**: Set to **yes** in your root configuration file if you
want to load images stored on external locations, when using the
* **external_shares**: Set to **yes** in your root configuration file if you
want to load images stored on external locations, when using the
**files_external** app.
* **native_svg**: Set to **yes** in your root configuration file to enable
rendering SVG images in your browser. This may represent a security risk if
* **native_svg**: Set to **yes** in your root configuration file to enable
rendering SVG images in your browser. This may represent a security risk if
you can't fully trust your SVG files.
* **background_colour_toggle**: Set to **yes** in your root configuration file
to enable a button that toggles between black and white backgrounds on
* **background_colour_toggle**: Set to **yes** in your root configuration file
to enable a button that toggles between black and white backgrounds on
transparent images.
.. note:: External shares are 20-50 times slower than local shares. Be prepared
to wait a long time before being able to see all the images contained in a
.. note:: External shares are 20-50 times slower than local shares. Be prepared
to wait a long time before being able to see all the images contained in a
shared album.
**Album Configuration**
Each album can be individually configured using the following configuration
sections. Use the **inherit** parameter to pass configurations on to
Each album can be individually configured using the following configuration
sections. Use the **inherit** parameter to pass configurations on to
sub-albums.
**Design**
* **background**: Defines the colour of the background of the photowall
using the RGB hexadecimal representation of that colour. For example:
**"#ffa033"**. You must use quotes around the value or it will
be ignored. It is strongly recommended to use a custom theme, with a CSS
loading spinner if you intend to use this feature. You can use `this colour
* **background**: Defines the colour of the background of the photowall
using the RGB hexadecimal representation of that colour. For example:
**"#ffa033"**. You must use quotes around the value or it will
be ignored. It is strongly recommended to use a custom theme, with a CSS
loading spinner if you intend to use this feature. You can use `this colour
wheel <http://paletton.com/>`_ to find a colour you like.
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
the configuration.
**Album Presentation**
* **description**: A markdown-formatted string which will be displayed in the
* **description**: A markdown-formatted string which will be displayed in the
info box. It can spread over multiple lines using the Yaml markers.
* **description_link**: A markdown file located within the album which will
* **description_link**: A markdown file located within the album which will
be parsed and displayed in the info box instead of the description.
* **copyright**: A markdown-formatted string. This supports links to external
* **copyright**: A markdown-formatted string. This supports links to external
resources.
* **copyright_link**: Any file (e.g. copyright.html), in the album itself,
* **copyright_link**: Any file (e.g. copyright.html), in the album itself,
which will be downloaded when the user clicks on the link
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
the configuration.
See `<http://www.markitdown.net/markdown>`_ for the markdown syntax.
.. note:: Do not add links to your `copyright` string if you use the
.. note:: Do not add links to your `copyright` string if you use the
**copyright_link** variable.
**Sorting**
* **sorting**: **date** or **name**. **date** only works for files.
* **sort_order**: **asc** or **des** (Ascending or descending).
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
* **inherit**: Set to **yes** if you want sub-folders to inherit this part of
the configuration.
Notes
-----
* When only the sort **type** variable has been set, the default sort order
* When only the sort **type** variable has been set, the default sort order
will be used.
* When only the sort **order** variable has been found, the sort configuration
will be ignored and the script will keep looking for a valid configuration in
* When only the sort **order** variable has been found, the sort configuration
will be ignored and the script will keep looking for a valid configuration in
upper folders.
* To enable a feature such as native SVG in a public share, you need to create
* To enable a feature such as native SVG in a public share, you need to create
in that folder a configuration file containing that feature.
* If you share a folder publicly, don't forget to add all the files you link to
(e.g. ``description.md`` or ``copyright.md``) inside the shared folder as
* If you share a folder publicly, don't forget to add all the files you link to
(e.g. ``description.md`` or ``copyright.md``) inside the shared folder as
the user won't have access to files stored in the parent folder.
* Since people can download a whole folder as an archive, it's usually best to
include all files within a shared folder, rather than adding text directly
* Since people can download a whole folder as an archive, it's usually best to
include all files within a shared folder, rather than adding text directly
in the configuration file.
Examples
@ -204,8 +204,8 @@ Applies to the current folder only::
type: date
order: asc
Short description and link to copyright document, applies to the current folder
and all of its sub-folders. This also shows you the syntax you can use to
Short description and link to copyright document, applies to the current folder
and all of its sub-folders. This also shows you the syntax you can use to
spread a description over multiple lines::
# Gallery configuration file
@ -236,7 +236,7 @@ You can add standard configuration items to the same configuration file::
# Gallery configuration file
features:
native_svg: yes
Possible Future Extensions
--------------------------

14
user_manual/files/large_file_upload.rst
View File

@ -2,21 +2,21 @@
Large File Uploads
==================
When uploading files through the web client, Nextcloud is limited by PHP and
Apache configurations. By default, PHP is configured for only 2 megabyte
uploads. As this default upload limit is not entirely useful, we recommend that
your Nextcloud admin increase the Nextcloud variables to sizes appropriate for
When uploading files through the web client, Nextcloud is limited by PHP and
Apache configurations. By default, PHP is configured for only 2 megabyte
uploads. As this default upload limit is not entirely useful, we recommend that
your Nextcloud admin increase the Nextcloud variables to sizes appropriate for
users.
Modifying certain Nextcloud variables requires administrative access. If you
Modifying certain Nextcloud variables requires administrative access. If you
require larger upload limits than have been provided by the default (or already
set by your administrator):
* Contact your administrator to request an increase in these variables
* Refer to the section in the `Admin Documentation
* Refer to the section in the `Admin Documentation
<https://docs.nextcloud.org/server/11/admin_manual/configuration_files/
big_file_upload_configuration.html>`_ that describes how to manage file
big_file_upload_configuration.html>`_ that describes how to manage file
upload size limits.
.. TODO ON RELEASE: Update version number above on release

16
user_manual/files/version_control.rst
View File

@ -2,15 +2,15 @@
Version Control
===============
Nextcloud supports simple version control system for files. Versioning creates
backups of files which are accessible via the Versions tab on the Details
sidebar. This tab contains the history of the file where you can roll back a
file to any previous version. Changes made at intervals greater than two minutes
are saved in data/[user]/versions.
Nextcloud supports simple version control system for files. Versioning creates
backups of files which are accessible via the Versions tab on the Details
sidebar. This tab contains the history of the file where you can roll back a
file to any previous version. Changes made at intervals greater than two minutes
are saved in **data/[user]/versions**.
.. figure:: ../images/files_versioning.png
To restore a specific version of a file, click the circular arrow to the left.
To restore a specific version of a file, click the circular arrow to the left.
Click on the timestamp to download it.
The versioning app expires old versions automatically to make sure that
@ -28,6 +28,6 @@ old versions:
The versions are adjusted along this pattern every time a new version gets
created.
The version app never uses more that 50% of the user's currently available free
space. If the stored versions exceed this limit, Nextcloud deletes the oldest
The version app never uses more that 50% of the user's currently available free
space. If the stored versions exceed this limit, Nextcloud deletes the oldest
versions until it meets the disk space limit again.

8
user_manual/pim/sync_osx.rst
View File

@ -10,17 +10,17 @@ to sync with Nextcloud. For OS X 10.7 Lion and 10.8 Mountain Lion everything wor
fine, but OS X 10.6 (Snow Leopard) and older needs some fiddling to work. A user
contributed the following:
#. Make sure, addressbook is not running. If it is, select the windows and press
#. Make sure, "Addressbook" is not running. If it is, select the windows and press
Command + Q to terminate it.
#. Navigate to **/Users/YOUR\_USERNAME/Library/Application Support/AddressBook/Sources**.
If you already have some kind of addressbook setup, it is likely you will see
If you already have some kind of addressbook set up, it is likely you will see
some folders named like this **BEA92826-FBF3-4E53-B5C6-ED7C2B454430**.
Note down what folders there are now and leave the window open.
#. Open addressbook and try to add a new CardDav addressbook. At this point, it
#. Open "Addressbook" and try to add a new CardDav addressbook. At this point, it
does not matter what information you enter. It will come up with the same error
message you mentioned before when you click "Create". Ignore it and click "Create"
again. A non-functional addressbook will be added.
#. Close addressbook again using Command + Q
#. Close "Addressbook" again using Command + Q
#. Go back to the folder window from step 2. You will now see a newly created folder
with another long string as its name.
#. Navigate to the newly created folder and edit the **Configuration.plist** with

8
user_manual/pim/sync_thunderbird.rst
View File

@ -4,10 +4,10 @@ Thunderbird - Synchronize Addressbook
Addressbook
-----------
As someone who is new to Nextcloud, New to SoGo Connector, and new to Thunderbird Addressbook... here is what you need in excruciating pithy detail to make this work (for all the other lost souls out there):
As someone who is new to Nextcloud, new to SoGo Connector, and new to Thunderbird Addressbook... here is what you need in excruciating pithy detail to make this work (for all the other lost souls out there):
#. `Thunderbird <http://www.mozilla.org/en-US/thunderbird/>`_ for your OS unless it comes with your OS distribution (Linux)
#. `Sogo Connector <http://www.sogo.nu/downloads/frontends.html>`_ (latest release)
#. `Thunderbird <https://www.mozilla.org/en-US/thunderbird/>`_ for your OS unless it comes with your OS distribution (Linux)
#. `Sogo Connector <https://sogo.nu/download.html#/frontends>`_ (latest release)
#. `Lightning <https://addons.mozilla.org/en-US/thunderbird/addon/lightning/>`_ (a Thunderbird calendar add-on. At the time (Aug 14), syncing your contacts only works with this add-on installed.)
With an installed Thunderbird mailtool, an installed SoGo Connector, and an installed Lightning add-on:
@ -21,7 +21,7 @@ With an installed Thunderbird mailtool, an installed SoGo Connector, and an inst
.. image:: ../images/contact_thunderbird-Symbol_Gear.jpg
in the -bottom left- of the Contacts View (same symbol as found in the -top right- in the Calendar view). Then look for a little impeller symbol
in the bottom left of the Contacts View (same symbol as found in the top right in the Calendar view). Then look for a little impeller symbol
.. image:: ../images/contact_thunderbird-Symbol_Impeller.jpg

10
user_manual/userpreferences.rst
View File

@ -20,16 +20,16 @@ To access your personal settings:
.. figure:: images/personal_settings.png
:alt: screenshot of user's Personal settings page
.. note:: If you are an administrator, you can also manage users and administer
.. note:: If you are an administrator, you can also manage users and administer
the server. These links do not appear to a non-admin user.
The options listed in the Personal Settings Page depend on the applications that
are enabled by the administrator. Some of the features you will see
The options listed in the Personal Settings Page depend on the applications that
are enabled by the administrator. Some of the features you will see
include the following.
* Usage and available quota
* Usage and available quota.
* Manage your profile picture.
* Full name. You can make this anything you want, as it is separate from your
* Full name. You can make this anything you want, as it is separate from your
Nextcloud login name, which is unique and cannot be changed.
* Email address.
* Lists your Group memberships.

40
user_manual/webinterface.rst
View File

@ -2,8 +2,8 @@
The Nextcloud Web Interface
===========================
You can connect to your Nextcloud server using any Web browser; just point it to
your Nextcloud server and enter your username and password. Supported Web
You can connect to your Nextcloud server using any Web browser; just point it to
your Nextcloud server and enter your username and password. Supported Web
browsers are:
* Firefox 14+
@ -15,14 +15,14 @@ browsers are:
.. figure:: images/oc_connect.png
:alt: Nextcloud login screen.
.. note:: Some apps like ``files_external`` or ``encryption`` will disable
.. note:: Some apps like ``files_external`` or ``encryption`` will disable
the **Stay logged in** checkbox.
Navigating the Main User Interface
----------------------------------
By default, the Nextcloud Web interface opens to your Files page. You can add,
remove, and share files, and make changes based on the access privileges set by
By default, the Nextcloud Web interface opens to your Files page. You can add,
remove, and share files, and make changes based on the access privileges set by
you (if you are administering the server) or by your server administrator.
.. figure:: images/files_page.png
@ -31,13 +31,13 @@ you (if you are administering the server) or by your server administrator.
The Nextcloud user interface contains the following fields and functions:
* **Apps Selection Menu**: Located in the upper left corner, click the arrow to
* **Apps Selection Menu**: Located in the upper left corner, click the arrow to
open a dropdown menu to navigate to your various available apps.
* **Apps Information** field: Located in the left sidebar, this provides
filters and tasks associated with your selected app. For example, when you
are using the Files apps you have a special set of filters for quickly
finding your files, such as files that have been shared with you, and files
* **Apps Information** field: Located in the left sidebar, this provides
filters and tasks associated with your selected app. For example, when you
are using the Files apps you have a special set of filters for quickly
finding your files, such as files that have been shared with you, and files
that you have shared with others. You'll see different items for other apps.
* **Application View**: The main central field in the Nextcloud user interface.
@ -50,19 +50,19 @@ The Nextcloud user interface contains the following fields and functions:
* **New** button: Located in the Navigation Bar, the ``New`` button
enables you to create new files, new folders, or upload files.
.. note:: You can also drag and drop files from your file manager into the
Nextcloud Files Application View to upload them to Nextcloud. Currently,
the only Web browsers that support drag-and-drop folders are Chrome and
.. note:: You can also drag and drop files from your file manager into the
Nextcloud Files Application View to upload them to Nextcloud. Currently,
the only Web browsers that support drag-and-drop folders are Chrome and
Chromium.
* **Search** field: Click on the magnifier in the upper right hand corner of
* **Search** field: Click on the magnifier in the upper right hand corner of
to search for files.
* **Gallery** button. This looks like four little squares, and takes you
directly to your image gallery.
* **Personal Settings** menu: Click on your Nextcloud username, located to the
right of the Search field, to open your Personal Settings dropdown menu. Your
* **Gallery** button. This looks like four little squares, and takes you
directly to your image gallery.
* **Personal Settings** menu: Click on your Nextcloud username, located to the
right of the Search field, to open your Personal Settings dropdown menu. Your
Personal page provides the following settings and features:
* Links to download desktop and mobile apps