diff --git a/user_manual/connecting/index.rst b/user_manual/connecting_browser.rst similarity index 100% rename from user_manual/connecting/index.rst rename to user_manual/connecting_browser.rst diff --git a/user_manual/connecting/webdav.rst b/user_manual/connecting_webdav.rst similarity index 100% rename from user_manual/connecting/webdav.rst rename to user_manual/connecting_webdav.rst diff --git a/user_manual/contacts.rst b/user_manual/contacts.rst index 019de2da3..cf1f9c676 100644 --- a/user_manual/contacts.rst +++ b/user_manual/contacts.rst @@ -16,10 +16,10 @@ Importing ~~~~~~~~~ So first well check out how to import all the VCF files as they are a lot -more faster way of creating contacts in this wonderful app. +more faster way of creating contacts. Just below the contact list, 3 buttons: The middle one let you upload files. -.. figure:: images/contact_bottombar.jpg +.. image:: images/contact_bottombar.jpg Once you've clicked it, the upload window let you choose your files. @@ -27,17 +27,17 @@ We can upload the files one by one or upload all of them at one go. Let me demonstrate. Open the directory in which you store all the files and then do the following -Keep pressing ctrl and select the files to upload. +Keep pressing CTRL and select the files to upload. After you are done just click on the open button After the upload it should look something like this in which all the names and contacts will be sorted alphabetically -.. figure:: images/contact_vcfpick.jpg +.. image:: images/contact_vcfpick.jpg Then, the interface ask you where to put your imported contacts. You have the ability to choose an existing addressbook or to create a new one. -Then click on "Ok" and that's all for the import of contacts. +Then click on "OK" and that's all for the import of contacts. -.. figure:: images/contact_import.jpg +.. image:: images/contact_import.jpg Create contacts manually ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -50,7 +50,7 @@ the name, the address, the e-mail, the telephone nr, ... Just click on a field and start typing the information. You can use the "Add Field" button to add another types of information for this contact. -.. figure:: images/contact_emptycontact.jpg +.. image:: images/contact_emptycontact.jpg When you want to remove an information of your contact, just click on little delete icon at the right of the field you want to remove. @@ -61,7 +61,7 @@ Adding picture to the contact There are two methods in which you can give a picture id to the specific contact -.. figure:: images/contact_picture.jpg +.. image:: images/contact_picture.jpg 1) **Direct upload** 2) **Select pics already uploaded in ownCloud files.** @@ -69,7 +69,7 @@ There are two methods in which you can give a picture id to the specific contact After you have selected the picture for the contact you get an option to crop the picture to suit your requirements -.. figure:: images/contact_crop.jpg +.. image:: images/contact_crop.jpg You can crop the picture however you wish and then press OK. @@ -85,7 +85,7 @@ When you click on the third button of the bottom bar, you will have access to the application's settings. Then, press on the "More button" to access the options of your Addressbooks. -.. figure:: images/contact_del_ab.jpg +.. image:: images/contact_del_ab.jpg You have there the ability to add, delete, download or share your addressbooks. Hover your cursor on every icon to see what they mean. @@ -105,7 +105,7 @@ Syncing with Android 4) After the app has checked your login details you may just select- Sync server to phone option 5) That's it there is nothing else to do for Android :) -.. figure:: images/contact_syncopt.jpg +.. image:: images/contact_syncopt.jpg Syncing your IOS device ~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/user_manual/files.rst b/user_manual/files.rst new file mode 100644 index 000000000..9c3e6d63e --- /dev/null +++ b/user_manual/files.rst @@ -0,0 +1,52 @@ +Accessing your Files +==================== + + +Desktop +------- + +Your ownCloud instance can be accessed on every platform via the web interface. There are also options to integrate it with your desktop: + +In most cases, accessing ownCloud using your file manager will be +sufficient: + +- *Connect to Server …* `in your file manager`_: + ``webdav://ADDRESS/files/webdav.php`` + +- Change the protocol to ``dav://`` in Nautilus or ``http://`` in + Finder + +However, some applications only allow you to save to a local folder. To +get around this issue, you can: + ++ `Sync your ownCloud folders and local folders`_ + ++ `Mount ownCloud to a local folder without sync`_ + +The +Desktop Syncing Client called Mirall is now released for Linux and +Windows. You can follow the current changes at the `ownCloud Mirall +repository`_. We work on porting this to Mac OS and packaging for all +major linux distributions. + +Mobile +------- + +There are apps in development for both `Android`_ and `webOS`_. Feel +free to `contribute, if you can`_! Right now you can use other apps to +connect to ownCloud from your phone via WebDAV. `WebDAV Navigator`_ is a +good (proprietary) app for `Android App`_ , `iPhone`_ & `BlackBerry`_. + + + +.. _in your file manager: http://en.wikipedia.org/wiki/Webdav#Implementations +.. _Sync your ownCloud folders and local folders: http://owncloud.org/documentation/sync-clients/ +.. _Mount ownCloud to a local folder without sync: http://owncloud.org/use/webdav/ +.. _ownCloud Mirall repository: https://gitorious.org/owncloud/mirall +.. _Android: http://gitorious.org/owncloud/android +.. _webOS: http://gitorious.org/owncloud/webos +.. _contribute, if you can: /contribute/ +.. _WebDAV Navigator: http://seanashton.net/webdav/ +.. _Android App: http://market.android.com/details?id=com.schimera.webdavnavlite +.. _iPhone: http://itunes.apple.com/app/webdav-navigator/id382551345 +.. _BlackBerry: http://appworld.blackberry.com/webstore/content/46279 diff --git a/user_manual/images/calender.png b/user_manual/images/calender.png new file mode 100644 index 000000000..720c86c59 Binary files /dev/null and b/user_manual/images/calender.png differ diff --git a/user_manual/images/calender1.png b/user_manual/images/calender1.png new file mode 100644 index 000000000..2ae85a0e0 Binary files /dev/null and b/user_manual/images/calender1.png differ diff --git a/user_manual/images/calender2.png b/user_manual/images/calender2.png new file mode 100644 index 000000000..b0b6568c9 Binary files /dev/null and b/user_manual/images/calender2.png differ diff --git a/user_manual/images/calender3.png b/user_manual/images/calender3.png new file mode 100644 index 000000000..b321fa369 Binary files /dev/null and b/user_manual/images/calender3.png differ diff --git a/user_manual/images/calender4.png b/user_manual/images/calender4.png new file mode 100644 index 000000000..acc00e5a8 Binary files /dev/null and b/user_manual/images/calender4.png differ diff --git a/user_manual/images/calender5.png b/user_manual/images/calender5.png new file mode 100644 index 000000000..8d1133287 Binary files /dev/null and b/user_manual/images/calender5.png differ diff --git a/user_manual/connecting/images/explorer_webdav.png b/user_manual/images/explorer_webdav.png similarity index 100% rename from user_manual/connecting/images/explorer_webdav.png rename to user_manual/images/explorer_webdav.png diff --git a/user_manual/images/kdes.png b/user_manual/images/kdes.png new file mode 100644 index 000000000..1d231c9af Binary files /dev/null and b/user_manual/images/kdes.png differ diff --git a/user_manual/images/kdes1.png b/user_manual/images/kdes1.png new file mode 100644 index 000000000..8a9f12d0b Binary files /dev/null and b/user_manual/images/kdes1.png differ diff --git a/user_manual/images/kdes2.png b/user_manual/images/kdes2.png new file mode 100644 index 000000000..62a85011d Binary files /dev/null and b/user_manual/images/kdes2.png differ diff --git a/user_manual/images/kdes3.png b/user_manual/images/kdes3.png new file mode 100644 index 000000000..9c3b0985a Binary files /dev/null and b/user_manual/images/kdes3.png differ diff --git a/user_manual/images/kdes4.png b/user_manual/images/kdes4.png new file mode 100644 index 000000000..6b82a89e9 Binary files /dev/null and b/user_manual/images/kdes4.png differ diff --git a/user_manual/images/kdes5.png b/user_manual/images/kdes5.png new file mode 100644 index 000000000..9ef780ce7 Binary files /dev/null and b/user_manual/images/kdes5.png differ diff --git a/user_manual/images/kdes6.png b/user_manual/images/kdes6.png new file mode 100644 index 000000000..fd2420624 Binary files /dev/null and b/user_manual/images/kdes6.png differ diff --git a/user_manual/images/kdes7.png b/user_manual/images/kdes7.png new file mode 100644 index 000000000..5393cb9d3 Binary files /dev/null and b/user_manual/images/kdes7.png differ diff --git a/user_manual/images/kdes9.png b/user_manual/images/kdes9.png new file mode 100644 index 000000000..e885d20cd Binary files /dev/null and b/user_manual/images/kdes9.png differ diff --git a/user_manual/images/mediaplayer.png b/user_manual/images/mediaplayer.png new file mode 100644 index 000000000..6e7f5615c Binary files /dev/null and b/user_manual/images/mediaplayer.png differ diff --git a/user_manual/connecting/images/nautilus_webdav.png b/user_manual/images/nautilus_webdav.png similarity index 100% rename from user_manual/connecting/images/nautilus_webdav.png rename to user_manual/images/nautilus_webdav.png diff --git a/user_manual/index.rst b/user_manual/index.rst index e62860939..2eaf82a38 100644 --- a/user_manual/index.rst +++ b/user_manual/index.rst @@ -7,10 +7,17 @@ Contents :maxdepth: 2 introduction - connecting/index - connecting/webdav + connecting_browser + connecting_webdav + files contacts bookmarks + sync + sync_kde + sync_osx + sync_ios + mediaplayer + versioncontrol .. add more chapters diff --git a/user_manual/mediaplayer.rst b/user_manual/mediaplayer.rst new file mode 100644 index 000000000..ceeafa3f3 --- /dev/null +++ b/user_manual/mediaplayer.rst @@ -0,0 +1,27 @@ +Native Media Player Support +=========================== + +.. image:: images/mediaplayer.png + +You can access your music stored in ownCloud with every +Ampache-compatible media player. You can find the URL for your specific +ownCloud installation in your personal settings, or replace ADDRESS with +the URL of your ownCloud installation yourself. + +``Ampache-URL: http://ADDRESS/apps/media/`` + +Ampache-compatible players that work with ownCloud include: + +- `amaroK`_, standard KDE music player +- `tomahawk`_, cross platform player +- `justplayer`_, music player for android + +You can find more information about Ampache and other players at the +`Ampache wikipedia article`_ + +The current maintainer of the Media Player is Robin Appelman. + +.. _amaroK: http://amarok.kde.org/ +.. _tomahawk: http://www.tomahawk-player.org/ +.. _justplayer: http://justplayer-dev.blogspot.com/ +.. _Ampache wikipedia article: http://en.wikipedia.org/wiki/Ampache diff --git a/user_manual/sync.rst b/user_manual/sync.rst new file mode 100644 index 000000000..e4913cd2d --- /dev/null +++ b/user_manual/sync.rst @@ -0,0 +1,14 @@ +Desktop Synchronisation +======================== + +For synchronizing files with your desktop computer, we recommend using the +`ownCloud Client`_ for Windows, Mac OS X and Linux. Its usage is documented +separately in the `ownCloud Desktop Client Manual`_. + +Furthermore, It is possible to synchronize your ownCloud calendar and 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.com/desktop/1.1/ diff --git a/user_manual/sync_ios.rst b/user_manual/sync_ios.rst new file mode 100644 index 000000000..94f7705f6 --- /dev/null +++ b/user_manual/sync_ios.rst @@ -0,0 +1,59 @@ +iOS – Synchronize iPhone/iPad +============================= + + + + +Synchronizing the Calendar +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +#. Open the settings application. +#. Select Mail, Contacts, Calendars. +#. Select Add Account. +#. Select Other as account type. +#. Select Add CalDAV account. +#. For server, type ``ADDRESS/remote.php/caldav/principals/username`` +#. Enter your user name and password. +#. Select Next. +#. If your server does not support SSL, a warning will be displayed. + Select Continue. +#. If the iPhone is unable to verify the account information perform the + following: + + - Select OK. + - Select advanced settings. + - Make sure Use SSL is set to OFF. + - Change port to 80. + - Go back to account information and hit Save. + +Your calendar should now be visible in the Calendar application + +Synchronizing the Address book +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +#. Open the settings application. +#. Select Mail, Contacts, Calendars. +#. Select Add Account. +#. Select Other as account type. +#. Select Add CardDAV account. +#. For server, type ``ADDRESS/remote.php/carddav/principals/username`` +#. Enter your user name and password. +#. Select Next. +#. If your server does not support SSL, a warning will be displayed. + Select Continue. +#. If the iPhone is unable to verify the account information perform the + following: + + - Select OK. + - Select advanced settings. + - Make sure Use SSL is set to OFF. + - Change port to 80. + - Go back to account information and hit Save. + +Now should now find your contacts in the address book of your +iPhone.Problems have been reported for iOS 4.X. A possible solution is +at the `forum`_. + + + +.. _forum: http://forum.owncloud.org/viewtopic.php?f=3&t=71&p=2211#p2197 \ No newline at end of file diff --git a/user_manual/sync_kde.rst b/user_manual/sync_kde.rst new file mode 100644 index 000000000..6497ff1a0 --- /dev/null +++ b/user_manual/sync_kde.rst @@ -0,0 +1,60 @@ +Synchronizing with KDE SC +========================= + + + +.. image:: /images/kdes1.png + +From KDE SC 4.8 and forward setting up ownCloud is very easy.From System +Settings Personal Information/Akonadi Resources Configuration select DAV +Groupware resource. + + +.. image:: /images/kdes2.png + +Enter your ownCloud username and password and click “Next”.\ + + +.. image:: /images/kdes3.png + +Select ownCloud in the drop down list and click “Next”.\ + + + +.. image:: /images/kdes4.png + +Enter the host name and installation path. If you do not use SSL +remember to de-select “Use secure connection”.\ + + +.. image:: /images/kdes5.png + +Test the connection. If everything went well you should see a message +like the one below.\ +.. raw:: html + + +.. image:: /images/kdes6.png + +Click “Finish” and you will be able to change the display name and +refresh interval.\ + + +.. image:: /images/kdes7.png + +Now you should see the Akonadi resource doing the first +synchronization.\ + + + +.. image:: /images/kdes8.png + +You can find the Contacts and Calendars in Kontact (or +KOrganizer/KAddressbook if you run the programs separately.) + + + +.. image:: /images/kdes9.png + +.. image:: /images/kdes.png + diff --git a/user_manual/sync_osx.rst b/user_manual/sync_osx.rst new file mode 100644 index 000000000..9739059b6 --- /dev/null +++ b/user_manual/sync_osx.rst @@ -0,0 +1,53 @@ +Synchronizing with OS X +======================= + +To use ownCloud with iCal you will need to use the following URL: + + http://ADDRESS/remote.php/caldav/principals/username/ + +In principle the setup is the same as with iOS using the path +``ADDRESS/remote.php/caldav/principals/username/`` to sync with +ownCloud. For OS X 10.7 Lion and 10.8 Mountain Lion everything works +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 Command + Q to terminate it. +#. Navigate to ``/Users/YOUR\_USERNAME/Library/Application + Support/AddressBook/Sources``. If you have all ready some kind of + address book setup, 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 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 + address book will be added. +#. Close Address-Book 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 it’s name. +#. Navigate to the newly created folder and edit the + ``Configuration.plist`` with your favorite text editor. +#. Search for a section looking like this: + + ``servername http://:0(null) username Whatever_you_entered_before`` + +8. Make it look like this. Please note the :80 after **YOUR_DOMAIN** – + it is important: + + + ``servernamehttp://YOUR_DOMAIN:80/owncloud/remote.php/carddav/principals/username usernameusername`` + +9. Save the file and open Address Book again. It won’t work yet. + +10. Open the preferences for your ownCloud Carddav-Account and enter your password. + +11. You may have to restart Address Book once more. After this, it should work. + +I know that this is incredibly painful from an end-users perspective. On +iPhones / iPads it is far less painful. Therefore, I’d like to blame +this issue on Address Book for Mac OS X Snow Leopard for now.There is +also an easy `HOWTO`_ in the forum. + + +.. _HOWTO: http://forum.owncloud.org/viewtopic.php?f=3&t=132 diff --git a/user_manual/versioncontrol.rst b/user_manual/versioncontrol.rst new file mode 100644 index 000000000..9eb3a84cd --- /dev/null +++ b/user_manual/versioncontrol.rst @@ -0,0 +1,10 @@ +Version Control +=============== + + +ownCloud supports simple version control for files. Versioning is +enabled by default, and creates backups of files which are accessible +via the history tab. This tab also links to the history page, 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.