diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 6d44d14af..df7cec804 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -1,6 +1,6 @@ -================================================== -ownCloud Server Administration Manual Introduction -================================================== +============================================================ +ownCloud |version| Server Administration Manual Introduction +============================================================ Introduction ------------ diff --git a/admin_manual/installation/linux_installation.rst b/admin_manual/installation/linux_installation.rst index 04239e30e..049e26d49 100644 --- a/admin_manual/installation/linux_installation.rst +++ b/admin_manual/installation/linux_installation.rst @@ -16,7 +16,8 @@ ownCloud Enterprise Subscription. Supported Distribution Packages ------------------------------- -Installing ownCloud on Linux from the `openSUSE Build Service`_ packages is the +Installing ownCloud Server (the free community edition) on Linux from the +`openSUSE Build Service`_ packages is the preferred method. These are maintained by ownCloud engineers, and you can use your package manager to keep your ownCloud server up-to-date. Ready-to-use packages are available at the ownCloud repository for a variety of Linux diff --git a/user_manual/contents.rst b/user_manual/contents.rst index adf9872f2..9c880053d 100644 --- a/user_manual/contents.rst +++ b/user_manual/contents.rst @@ -1,17 +1,13 @@ .. _contents: -==================== -ownCloud User Manual -==================== +================= +Table of Contents +================= .. toctree:: - :hidden: - + :maxdepth: 2 + index - -.. toctree:: - :maxdepth: 3 - whats_new webinterface files/index @@ -19,4 +15,4 @@ ownCloud User Manual documents bookmarks userpreferences - external_storage/google_drive \ No newline at end of file + external_storage/index \ No newline at end of file diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst new file mode 100644 index 000000000..4e1e7930f --- /dev/null +++ b/user_manual/external_storage/external_storage.rst @@ -0,0 +1,11 @@ +============================ +Configuring External Storage +============================ + +The External Storage application allows you to mount external storage services, +such as Google Drive, Dropbox, Amazon S3, SMB/CIFS fileservers, and FTP servers +in ownCloud. Your ownCloud server administrator controls which of these are +available to you. Please see `Configuring External Storage (GUI) +`_ in the ownCloud Administrator's +manual for configuration howtos and examples. diff --git a/user_manual/external_storage/google_drive.rst b/user_manual/external_storage/google_drive.rst deleted file mode 100644 index eef2afe3c..000000000 --- a/user_manual/external_storage/google_drive.rst +++ /dev/null @@ -1,13 +0,0 @@ -Configuring External Storage -============================ - -The External Storage application allows you to mount external storage services, such as Google -Drive, Dropbox, Amazon S3, SMB/CIFS fileservers, and FTP servers in ownCloud. Your -ownCloud server administrator controls which of these are available to you. Please see -``Configuring External Storage (GUI)`` in the ownCloud Administrator's manual for -configuration howtos and example: - -`Configuring External Storage (GUI) -`_ -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/external_storage/index.rst b/user_manual/external_storage/index.rst new file mode 100644 index 000000000..6c03ec1b4 --- /dev/null +++ b/user_manual/external_storage/index.rst @@ -0,0 +1,10 @@ +================ +External Storage +================ + +.. toctree:: + :maxdepth: 1 + + external_storage + sharepoint_connecting + \ No newline at end of file diff --git a/user_manual/external_storage/sharepoint_connecting.rst b/user_manual/external_storage/sharepoint_connecting.rst new file mode 100644 index 000000000..cceb23665 --- /dev/null +++ b/user_manual/external_storage/sharepoint_connecting.rst @@ -0,0 +1,70 @@ +======================== +Connecting to SharePoint +======================== + +Native SharePoint support has been added to ownCloud Enterprise Subscription as +a secondary storage location for SharePoint 2007, 2010 and 2013. To the user, +these appear as normal ownCloud mounts, with bi-directional updates in any +ownCloud client: desktop, mobile, or Web. There is one difference, and that is +ownCloud sharing is intentionally disabled for SharePoint mountpoints in order +to preserve SharePoint access controls, and to ensure that content is properly +accessed as per SharePoint rules. + +Your ownCloud admin may optionally allow users to mount their own SharePoint +libraries. + +Accessing SharePoint Folders +---------------------------- + +When you first log in to ownCloud, the Web interface shows a gray bar behind all +SharePoint folders. The gray bar disappears when the mountpoint is verified by +the server. If you see a red error bar, you'll see either an hourglass that +indicates a connection error, or a key to indicate that authentication is +required. + +Your ownCloud admin has the option to configure SharePoint credentials so that +you are authenticated automatically, or you may be required to enter your +credentials. If you have to enter your credentials, click the red bar and you'll +get a login window. You should only have to do this once, as ownCloud will store +your credentials. + +If your SharePoint login ever changes, go to your Personal page to update it in +the ``Sharepoint Personal Configuration`` section. + +Personal Page +------------- + +You can manage your SharePoint connections in the ``Sharepoint Personal +Configuration`` section of your ownCloud Personal page. You'll see two sections: +the ``Admin added mount points`` section lists SharePoint mounts controlled by +your ownCloud admin. If users have permissions to mount their own SharePoint +libraries you'll also see a ``Personal mount points`` section. + +There are two types of authentication available to you. If you have multiple +SharePoint libraries that use the same authentication, enter your credentials +in ``Sharepoint Personal Configuration``. Then follow these steps to add your +libraries: + +* Enter the name of your local mountpoint in the ``Local Folder Name`` column. + This can be an existing folder, or automatically create a new one. + +* Enter your SharePoint server URL. + +* Click the little refresh icon to the left of the ``Document Library`` field. + If your credentials and URL are correct you'll get a dropdown list of SharePoint + libraries to choose from. + +* Select the document library you want to mount. + +* Select "Use user credentials". + +* Click the ``Save`` button, and you're done + +.. figure:: ../images/sharepoint-drive-config-user.png + +You may elect to use different authentication credentials for some of your +SharePoint libraries. For these, you must first select ``use custom +credentials``, and then fill in the mountpoint and SharePoint site URL. Then +ownCloud can authenticate you, and you can click the refresh icon to see your +libraries. Then select the library you want to mount and click the ``Save`` +button. diff --git a/user_manual/files/files.rst b/user_manual/files/access_webdav.rst similarity index 99% rename from user_manual/files/files.rst rename to user_manual/files/access_webdav.rst index 10b116d6f..a2240763b 100644 --- a/user_manual/files/files.rst +++ b/user_manual/files/access_webdav.rst @@ -1,3 +1,4 @@ +===================================== Accessing ownCloud Files Using WebDAV ===================================== diff --git a/user_manual/files/filesweb.rst b/user_manual/files/access_webgui.rst similarity index 87% rename from user_manual/files/filesweb.rst rename to user_manual/files/access_webgui.rst index 4dae07dfb..fe8116c93 100644 --- a/user_manual/files/filesweb.rst +++ b/user_manual/files/access_webgui.rst @@ -1,5 +1,6 @@ -Accessing your Files Using the Web Interface -============================================ +===================================================== +Accessing your Files Using the ownCloud Web Interface +===================================================== You can access your ownCloud files with the ownCloud web interface and create, preview, edit, delete, share, and re-share files. Your ownCloud administrator @@ -8,10 +9,13 @@ system ask your server administrator. .. figure:: ../images/users-files.png -ownCloud version 7 can display thumbnail previews for image files, MP3 covers, +ownCloud 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. + Pencil icon Rename a file or folder. This does not alter the filename on the original document. @@ -69,10 +73,10 @@ Public link shares are marked with a chain link. Un-shared folders are blank. .. figure:: ../images/users-overlays.png -If your ownCloud server is the Enterprise edition, you may also have access to -Sharepoint and Windows Network Drive file shares. These also have special -overlay icons, and a red plugin means you have to enter a login to -get access to the share. +If your ownCloud server is the Enterprise Subscription, you may also have access +to Sharepoint and Windows Network Drive file shares. These also have special +overlay icons, and a red plugin means you have to enter a login to get access to +the share. .. figure:: ../images/users-overlays-win-net-drive.png @@ -133,6 +137,9 @@ You can click on any of the filter options to view the files as follows: All files The default view; displays all files that you have access to. + +Favorites + Files or folders marked with the yellow star. Shared with you Displays all files shared with you by another user or group. @@ -161,14 +168,6 @@ with a local user, group, or any person online with a public link. Shared files and folders are labeled with the triangular share icon, and the status *Shared* in the file or folder row. - -.. Note:: The Shared folder has been removed from new installations of ownCloud - 7. Shares now appear in the top level of your file tree on your Files page. - If you are upgrading from older ownCloud versions you will still have your - old Shared folder. Your server administrator has the option to change this in - the server's ``config.php`` file with the ``'share_folder' =>`` directive. - - To create a local share with other users or groups on your ownCloud server: 1. Hover your cursor over an item on the Files page @@ -198,8 +197,8 @@ name of the file owner. When you want to revoke a share, simply click the Trashcan icon next to the name of the appropriate user or group in the Shared dialog. -Creating a Public Share ------------------------ +Creating a Public Link Share +---------------------------- You can share files outside of your organization with people who are not users on your ownCloud server by creating a public share link. Open the Share dialog @@ -221,3 +220,12 @@ In older versions of ownCloud, 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 Federated Cloud Sharing Link +-------------------------------------------------------- + +Federated Cloud Sharing, introduced in ownCloud 7 as Server-to-Server sharing, +allows you to mount file shares from remote ownCloud servers, and manage them +just like a local share. In ownCloud 8 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. diff --git a/user_manual/files/configuring_big_file_upload.rst b/user_manual/files/configuring_big_file_upload.rst deleted file mode 100644 index f9c8f31a9..000000000 --- a/user_manual/files/configuring_big_file_upload.rst +++ /dev/null @@ -1,21 +0,0 @@ -Managing Big Files -================== - -There are a few default configuration settings that you will want to change to -enable ownCloud to operate more effectively as a self-hosted file sync and -share server. - -When uploading through the web client, ownCloud is governed by PHP and Apache. -By default, PHP is configured for only 2 megabyte uploads. As this default -upload limit is not entirely useful, we recommend that you increase the -ownCloud variables to the sizes you want to support on your server. - -Modifying certain ownCloud 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 - `_ - that describes how to configure for big files. diff --git a/user_manual/files/deletedfiles.rst b/user_manual/files/deleted_file_management.rst similarity index 96% rename from user_manual/files/deletedfiles.rst rename to user_manual/files/deleted_file_management.rst index 41abb546d..13f8b3b4d 100644 --- a/user_manual/files/deletedfiles.rst +++ b/user_manual/files/deleted_file_management.rst @@ -1,6 +1,6 @@ -====================== -Managing Deleted Files -====================== +======================= +Deleted File Management +======================= ownCloud maintains a copy of deleted files in case you need them again. To ensure that individual users do not run out of storage space, the Files app manages diff --git a/user_manual/files/desktop_mobile_sync.rst b/user_manual/files/desktop_mobile_sync.rst new file mode 100644 index 000000000..0fc849d95 --- /dev/null +++ b/user_manual/files/desktop_mobile_sync.rst @@ -0,0 +1,30 @@ +================================== +Desktop and Mobile Synchronization +================================== + +For synchronizing files with your desktop computer, we recommend using the +`ownCloud Sync Client`_ for Windows, Mac OS X and Linux. + +The ownCloud Desktop Sync Client enables you to connect to your private +ownCloud Server. +You can create folders in your home directory, and keep the contents of those +folders synced with your ownCloud server. Simply copy a file into the directory +and the ownCloud 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. +You will always +have your latest files with you wherever you are. + +Its usage is documented separately in the `ownCloud Desktop Client Manual`_. + +.. _ownCloud Sync Client: https://owncloud.org/sync-client/ +.. _ownCloud Desktop Client Manual: https://doc.owncloud.org/ + +Mobile Clients +-------------- + +Visit your Personal page in your ownCloud Web interface to find download links +for Android and iOS mobile sync clients. Or, visit the `ownCloud download page +`_. + +Visit the `ownCloud documentation page `_ to read +the mobile apps user manuals. diff --git a/user_manual/files/encryption.rst b/user_manual/files/encrypting_files.rst similarity index 98% rename from user_manual/files/encryption.rst rename to user_manual/files/encrypting_files.rst index 1aeb2e2ae..ababe9f8d 100644 --- a/user_manual/files/encryption.rst +++ b/user_manual/files/encrypting_files.rst @@ -1,3 +1,4 @@ +============================== Encrypting Your ownCloud Files ============================== @@ -47,8 +48,8 @@ files you have, and then you are returned to your default ownCloud page. .. note:: You must never lose your ownCloud password, because you will lose access to your files. Though there is an optional recovery option that your - ownCloud administrator may enable; see the Recovery Key Password section to - learn about this. + ownCloud administrator may enable; see the Recovery Key Password section + (below) to learn about this. Sharing Encrypted Files ----------------------- @@ -92,7 +93,7 @@ If your files decrypt successfully, you can click the ``Delete encryption keys`` button. There is no reason to save them after disabling decryption, because if encryption is enabled again you'll generate a new set of keys. Your keys are preserved in case something goes wrong with the decryption and you -need your keys to access your files. Which is not likely to happen. +need your keys to access your files. Files Not Encrypted ------------------- diff --git a/user_manual/files/server_to_server_using.rst b/user_manual/files/federated_cloud_sharing.rst similarity index 71% rename from user_manual/files/server_to_server_using.rst rename to user_manual/files/federated_cloud_sharing.rst index 0c107e896..5fe330a3c 100644 --- a/user_manual/files/server_to_server_using.rst +++ b/user_manual/files/federated_cloud_sharing.rst @@ -1,25 +1,22 @@ -Using Server-to-Server Sharing -============================== +============================= +Using Federated Cloud Sharing +============================= -ownCloud 7 introduces a powerful new feature, server-to-server sharing. With -just a few clicks you can easily access shares from other ownCloud 7 servers, -link them to your account, and create your own shares. This feature enables you -to: +Federated Cloud Sharing, introduced in ownCloud 7 as Server-to-Server sharing, +allows you to mount file shares from remote ownCloud servers, and manage them +just like a local share. This feature enables you to: * Selectively share files or directories. * Combine two private clouds into a single public cloud. * Eliminate the need to create user accounts on multiple ownCloud servers. * View files in a Web browser or ownCloud client. -.. note:: Server-to-server sharing requires that both servers are running - versions of ownCloud that support this feature; currently this is ownCloud 7. - Creating a New Share ------------------------- +-------------------- -Server-to-server sharing is enabled on new or upgraded ownCloud 7 installations -by default. (See "Configuring Server-to-Server Sharing" in the Administrators -Manual.) Follow these steps to create a new share: +Federated Cloud Sharing is enabled on new or upgraded ownCloud installations +by default. (See "Configuring Federated Cloud Sharing" in the ownCloud Server +Administration Manual.) Follow these steps to create a new share: 1. Go to your ``Files`` page and hover your cursor over the file or directory you want to share to expose your administration options. Check the ``Share @@ -28,7 +25,9 @@ Link`` checkbox to create the share, and to expose all of your sharing options. 2. Set any options that you want to apply to your new share: send an email notification, add password protection, allow users to upload files to the share, or set an expiration date. If you check **Allow Public Upload** then other -users can overwrite, rename and delete files in the share. +users can overwrite, rename and delete files in the share. If you do not send +an email notification, you will need to figure out some other way to share the +link. .. figure:: ../images/s2s-create_public_share.png @@ -37,7 +36,6 @@ link. If you do not protect it with a password, it is visible to anyone who has the URL. (ownCloud server admins have the option of requiring users to set passwords on shares in ``Admin > Sharing.``) - Connecting to a Remote Share ----------------------------- diff --git a/user_manual/files/index.rst b/user_manual/files/index.rst index 5f3b21e25..5354ea834 100644 --- a/user_manual/files/index.rst +++ b/user_manual/files/index.rst @@ -5,12 +5,12 @@ Files & Synchronization .. toctree:: :maxdepth: 1 - files - filesweb - sync - encryption - configuring_big_file_upload - deletedfiles + access_webgui + access_webdav + deleted_file_management + desktop_mobile_sync + encrypting_files + federated_cloud_sharing + large_file_upload quota - server_to_server_using - versioncontrol + version_control diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst new file mode 100644 index 000000000..8f6de0c33 --- /dev/null +++ b/user_manual/files/large_file_upload.rst @@ -0,0 +1,20 @@ +================== +Large File Uploads +================== + +When uploading files through the web client, ownCloud 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 ownCloud admin increase the ownCloud variables to sizes appropriate for +users. + +Modifying certain ownCloud 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 + `_ that describes how to manage file + upload size limits. diff --git a/user_manual/files/sync.rst b/user_manual/files/sync.rst deleted file mode 100644 index faa94eb63..000000000 --- a/user_manual/files/sync.rst +++ /dev/null @@ -1,22 +0,0 @@ -Desktop Synchronization -======================== - -For synchronizing files with your desktop computer, we recommend using the -`ownCloud Client`_ for Windows, Mac OS X and Linux. - -The ownCloud Desktop Client enables you to connect to your private ownCloud Server. -You can create folders in your home directory, and keep the contents of those -folders synced with your ownCloud server. Simply copy a file into the directory -and the ownCloud 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. Always -have your latest files with you wherever you are. - -Its usage is documented separately in the `ownCloud Desktop Client Manual`_. - -Furthermore, it is possible to synchronize your ownCloud calendar and your address book -with a variety of different operating systems and devices. It is also possible to -mount your ownCloud storage via WebDAV, which is also documented in the next chapters. - - -.. _ownCloud Client: http://owncloud.org/sync-client/ -.. _ownCloud Desktop Client Manual: http://doc.owncloud.org/desktop diff --git a/user_manual/files/version_control.rst b/user_manual/files/version_control.rst new file mode 100644 index 000000000..69bc3b6a2 --- /dev/null +++ b/user_manual/files/version_control.rst @@ -0,0 +1,37 @@ +=============== +Version Control +=============== + +ownCloud supports simple version control system for files. Versioning creates +backups of files which are accessible via the Versions link. This link 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. + +To restore a specific version of a file, hover your cursor over a file and click +the *Versions* link. If any version is available, you should see a list like +the image below: + +.. figure:: ../images/files_versioning.png + +Clicking on *Restore* next to any version will revert the file to that +version back. + +The versioning app expires old versions automatically to make sure that +the user doesn't run out of space. This pattern is used to delete +old versions: + +* For the first second we keep one version +* For the first 10 seconds ownCloud keeps one version every 2 seconds +* For the first minute ownCloud keeps one version every 10 seconds +* For the first hour ownCloud keeps one version every minute +* For the first 24 hours ownCloud keeps one version every hour +* For the first 30 days ownCloud keeps one version every day +* After the first 30 days ownCloud keeps one version every week + +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, ownCloud deletes the oldest +versions until it meets the disk space limit again. diff --git a/user_manual/files/versioncontrol.rst b/user_manual/files/versioncontrol.rst deleted file mode 100644 index be3f818ed..000000000 --- a/user_manual/files/versioncontrol.rst +++ /dev/null @@ -1,36 +0,0 @@ -Version Control -=============== - -ownCloud supports simple version control for files. Versioning creates backups -of files which are accessible via the Versions link. This link 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, -and made accessible using the above pages. - -To restore a specific version of a file, hover your cursor on a file and click -*Versions* link. If any version is available, you should see a list like the image -below: - -.. figure:: ../images/files_versioning.png - -Clicking on *Restore* next to any version will revert the file to that -version back. - -The versioning app expires old versions automatically to make sure that -the user doesn't run out of space. Following pattern is used to delete -old versions: - -* For the first second we keep one version -* For the first 10 seconds ownCloud keeps one version every 2 seconds -* For the first minute ownCloud keeps one version every 10 seconds -* For the first hour ownCloud keeps one version every minute -* For the first 24 hours ownCloud keeps one version every hour -* For the first 30 days ownCloud keeps one version every day -* After the first 30 days ownCloud keeps one version every week - -The versions are adjusted along this pattern every time a new version gets -created. - -Beside that the version app takes care to never use more that 50% of the users -currently available free space. If the stored versions exceed this limit, ownCloud -deletes the oldest versions until it meets the disk space limit again. diff --git a/user_manual/images/oc_main_web_labelled.png b/user_manual/images/oc_main_web_labelled.png index 96791a07b..88d039b2f 100644 Binary files a/user_manual/images/oc_main_web_labelled.png and b/user_manual/images/oc_main_web_labelled.png differ diff --git a/user_manual/images/sharepoint-drive-config-user.png b/user_manual/images/sharepoint-drive-config-user.png new file mode 100644 index 000000000..1a332a0cf Binary files /dev/null and b/user_manual/images/sharepoint-drive-config-user.png differ diff --git a/user_manual/images/users-files.png b/user_manual/images/users-files.png index f0c8f7eb2..88d039b2f 100644 Binary files a/user_manual/images/users-files.png and b/user_manual/images/users-files.png differ diff --git a/user_manual/index.rst b/user_manual/index.rst index f779fc1b2..71b3c6fc6 100644 --- a/user_manual/index.rst +++ b/user_manual/index.rst @@ -1,102 +1,28 @@ .. _index: -===================================== -ownCloud |version| User Documentation -===================================== +=========================================== +ownCloud |version| User Manual Introduction +=========================================== **Welcome to ownCloud: your self-hosted file sync and share solution.** ownCloud is open source file sync and share software for everyone from -individuals operating the free ownCloud Community Edition, to large enterprises -and service providers operating the ownCloud Enterprise Edition. ownCloud +individuals operating the free ownCloud Server edition, to large enterprises +and service providers operating the ownCloud Enterprise Subscription. ownCloud provides a safe, secure, and compliant file synchronization and sharing solution on servers that you control. -With ownCloud you can share one or more files and folders on your computer, and -synchronize them with your ownCloud server. Place files in your local shared -directories, and those files are immediately synchronized to the server and to -other devices using the ownCloud Desktop Client. Not near a device running a -desktop client? No problem! Simply log in using the ownCloud web client and -manage your files from there. The ownCloud Android and iOS mobile applications -enable you to browse, download, and upload photos and videos. On Android, you -can also create, download, edit, and upload any other files, as long as the -correct software is installed. +You can share one or more files and folders on your computer, and synchronize +them with your ownCloud server. Place files in your local shared directories, +and those files are immediately synchronized to the server and to other devices +using the ownCloud Desktop Sync Client, Android app, or iOS app. To learn more +about the ownCloud desktop and mobile clients, please refer to their respective +manuals: -Whether you are using a mobile device, a workstation, or a web client, ownCloud -provides the ability to put the right files in the right hands at the right -time on any device with one simple-to-use, secure, private and controlled -solution. After all, with ownCloud, it’s Your Cloud, Your Data, Your Way. +* `ownCloud Desktop Client`_ +* `ownCloud Android App`_ +* `ownCloud iOS App`_ -Web Interface -============= -How to access ownCloud from a Web browser. - -* :doc:`webinterface` - -Desktop Sync Client -=================== - -The ownCloud desktop sync client keeps your files synchronized between your PC -and your ownCloud server. Download the `desktop sync client for Mac OS X, -Linux, and Windows `_, and you may -wish to refer to the `ownCloud Desktop Client Manual -`_ to learn how to set up your -account, select which files or folders to synchronize or exclude, limit -bandwidth, and how to use other features. - -File Access and Management -========================== -The following topics contain information about file access and management. - -* :doc:`files/files` -* :doc:`files/filesweb` -* :doc:`files/sync` -* :doc:`files/encryption` -* :doc:`files/configuring_big_file_upload` -* :doc:`files/deletedfiles` -* :doc:`files/quota` -* :doc:`files/server_to_server_using` -* :doc:`files/versioncontrol` - -Contacts and Calendar -===================== -The following topics provide information about the **Contacts** and -**Calendar** applications, including usage instructions as well as how to -export, import, and synchronization the ownCloud calendar application with -different operating system calendars: - -* :doc:`pim/calendar` -* :doc:`pim/contacts` -* :doc:`pim/sync_ios` -* :doc:`pim/sync_kde` -* :doc:`pim/sync_osx` - -Documents -========= -The following topic describes how to use the **Documents** application to -enable multiple users to collaboratively edit rich-text documents -simultaneously. - -* :doc:`documents` - -Bookmarks -========= -The following topic describes how to use the ownCloud **Bookmarks** application -to manage your bookmarks: - -* :doc:`bookmarks` - -External storage -================ -Please see ``Configuring External Storage (GUI)`` in the ownCloud -Administrator's manual: - -`Configuring External Storage (GUI) -`_ - -.. TODO ON RELEASE: Update version number above on release - -.. Indices and tables -.. ================== - -.. * :ref:`genindex` +.. _`ownCloud Desktop Client`: http://doc.owncloud.org/ +.. _`ownCloud Android App`: http://doc.owncloud.org/ +.. _`ownCloud iOS App`: http://doc.owncloud.org/ \ No newline at end of file diff --git a/user_manual/pim/contacts.rst b/user_manual/pim/contacts.rst index c9fb40d74..85b2425b4 100755 --- a/user_manual/pim/contacts.rst +++ b/user_manual/pim/contacts.rst @@ -1,3 +1,4 @@ +====================== Using the Contacts App ====================== @@ -323,7 +324,7 @@ ownCloud provides the following alternative synchronization options: find this app `here `_. Special CardDAV URLs -------------------- +-------------------- Additionally, the Contacts app is providing an URL for special functions: diff --git a/user_manual/webinterface.rst b/user_manual/webinterface.rst index 6b153eb56..0555c7047 100644 --- a/user_manual/webinterface.rst +++ b/user_manual/webinterface.rst @@ -1,132 +1,73 @@ +========================== The ownCloud Web Interface ========================== -You can connect to your ownCloud server using any web browser. To access the -ownCloud server using a web browser, specify the uniform resource link (URL) -address of the server in the browser navigation bar. This can be the URL -address of your personal ownCloud setup or a URL address that you have received -from your company or your service provider. - -.. note:: If you are administering the server yourself, we recommend that you - read the `ownCloud Administrators Guide - `_. -.. TODO ON RELEASE: Update version number above on release - -Accessing the ownCloud Web Interface ------------------------------------- - -To access the ownCloud web interface: - -1. Enter the URL address of the ownCloud server into your browser navigation -bar. - - The ownCloud login window opens. +You can connect to your ownCloud server using any Web browser; just point it to +your ownCloud server and enter your username and password. .. figure:: images/oc_connect.png :scale: 75% **ownCloud login window** -2. Enter your valid username and password. - - The username and password combination can be those that you set up yourself - when creating your ownCloud server setup or those provided by your company or - your service provider. - - If you have set up the server yourself or are administering the server, you - can add additional users by configuring a user backend (for example, LDAP). - -3. Click the :guilabel:`Log in` button. - - The ownCloud main interface opens. - - .. figure:: images/oc_main_web.png - - **ownCloud main user interface** - - Navigating the Main User Interface ------------------------------------ +By default, the ownCloud Web interface opens to your Files page. Once you have accessed the ownCloud Server main web interface you can add files, remove 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/oc_main_web_labelled.png + .. figure:: images/oc_main_web_labelled.png + :scale: 75% **Navigating the main user interface** The ownCloud Main User Interface contains the following fields and functions: -* **Apps Selection Menu**: Located in the upper left corner of the user - interface, this bar contains apps that are configured on the ownCloud server. - The icons in this bar enable you to launch the different apps available and - navigate between them within the ownCloud user interface. +* **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 + that you have shared with others. You'll see different items for other apps. -.. note:: ownCloud supports a number of apps that can be installed and used for - various features and functions. Not all apps are installed and enabled by - default. For example, the :guilabel:`Apps` button is visible only to - administrators. This button allows administrators to enable or disable - installed applications. - -* **Apps Information** field: Located in the left side bar, this field provides - filters and tasks associated with the chosen app. For example, using the - Files app, you can use the filters in the apps information field to view only - files that have been shared with you, files that you have shared with others, - files that you have shared through the use of a link, or an option to delete - files. Other app-specific information fields might provide tasks for creating - new documents or modifying calendar entries. - -* **Application View**: The main, central field in the ownCloud user interface. - This field displays the contents or user features of the app selected in the - Navigation Bar. By default, this field shows the files and directory - ("Files" view) of your user account. +* **Application View**: The main central field in the ownCloud user interface. + This field displays the contents or user features of your selected app. * **Navigation Bar**: Located over the main viewing window (the Application View), this bar provides a type of breadcrumbs navigation that enables you to - migrate to higher levels of the folder hierarchy up to the root level (home) - of your ownCloud instance. + migrate to higher levels of the folder hierarchy up to the root level (home). -* **New** button: Located in the Navigation Bar, the :guilabel:`New` button +* **New** button: Located in the Navigation Bar, the ``New`` button enables you to create new files, new folders, or upload existing files from a specified link. -.. note:: You can also drag and drop files from your file manager (e.g. Windows - Explorer or your Mac OS X Finder) into the ownCloud Files Application - View to upload them to ownCloud. +.. note:: You can also drag and drop files from your file manager into the + ownCloud Files Application View to upload them to ownCloud. -* **Upload** button: Located next to the :guilabel:`New` button in the - Navigation Bar, the :guilabel:`Upload` button enables you to upload files - from your system to the ownCloud server. Clicking this button launches a - file picker (e.g. Windows Explorer or Mac OS X Finder) window with which you - can choose files for uploading. +* **Upload** button: Located next to the ``New`` button in the + Navigation Bar, the ``Upload`` button opens a file picker for + uploading files from your system to the ownCloud server. -* **Search** field: Residing in the upper right hand corner of the Main User - Interface window, the Search field enables you to search for files and - folders stored in ownCloud. The ownCloud search function provides a full text - search. However, for searching to function, administrators must enable the app - in the search app settings. +* **Search** field: The Search field is in the upper right hand corner of + your Web interface, for searching for files. -* **Personal Settings** menu: Located to the right of the Search field, the - Personal Settings dropdown menu provides access to your personal settings - page and the ability to log out of your ownCloud user session. The personal - settings page provides access to the following: +* **Personal Settings** menu: Click on your ownCloud 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: - * Activity notifications + * Links to download desktop and mobile apps + * Re-run the First Run Wizard * Server usage and space availability * Password management * Name, email, and profile picture settings * Interface language settings - * WebDAV URL for receiving files using WebDAV (see next chapter). - * Mozilla Sync information for creating a synchronization to a Mozilla - (Firefox) account. + * Manage notifications + * SSL certificate manager * ownCloud Version information - You can see :doc:`userpreferences` section to learn more about those settings. - -In addition to these standard settings, administrators have access to user -management (:guilabel:`Users`), apps settings (:guilabel:`Apps`), and -administrative settings (:guilabel:`Admin`) including access to the ownCloud -log files. - + See :doc:`userpreferences` section to learn more about those settings. diff --git a/user_manual/whats_new.rst b/user_manual/whats_new.rst index 7f0c453bb..b7502b5d5 100644 --- a/user_manual/whats_new.rst +++ b/user_manual/whats_new.rst @@ -17,13 +17,13 @@ Users can now assign a favorite icon to files and folders. Look for improvements in this feature in future ownCloud editions to make finding and managing files even easier. -Improved Server-to-Server Sharing ---------------------------------- +Improved Federated Cloud Sharing +-------------------------------- -Server-to-Server Sharing, introduced in ownCloud 7, allows you to mount file -shares from remote ownCloud servers, and create a "cloud of ownClouds". In -ownCloud 8 the process for creating a new Server-to-Server link is easier and more -streamlined. +Federated Cloud Sharing, introduced in ownCloud 7 as Server-to-Server sharing, +allows you to mount file shares from remote ownCloud servers, and create a +"cloud of ownClouds". In ownCloud 8 the process for creating a new +sharing link is easier and more streamlined. Improved Search ---------------