Browse Source

Update owncloud documentation

Bob Mottram 9 years ago
parent
commit
d446a8984f
2 changed files with 16 additions and 51 deletions
  1. 6
    12
      doc/EN/usage.org
  2. 10
    39
      website/EN/usage.html

+ 6
- 12
doc/EN/usage.org View File

88
 
88
 
89
 Subsequently even if dynamic DNS isn't working you may still be able to administer your system. Using the onion address also gives you some degree of protection against corporate or government metadata analysis, since it becomes more difficult to passively detect which systems are communicating.
89
 Subsequently even if dynamic DNS isn't working you may still be able to administer your system. Using the onion address also gives you some degree of protection against corporate or government metadata analysis, since it becomes more difficult to passively detect which systems are communicating.
90
 * Syncing to the Cloud
90
 * Syncing to the Cloud
91
-** Initial install
92
-Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
93
-
94
-You will also need to enter database details:
91
+Owncloud provides an easy way to sync files across multiple systems (desktop, laptop and mobile), and is a good way to wean people off of the proprietary systems such as [[http://www.drop-dropbox.com/][Dropbox]]. It can also do many other things, such as acting as a jukebox or a collaborative document editing system. Owncloud servers can also [[https://www.youtube.com/watch?v=b1F-N3QXN2s][federate together]] to make it easy for independent installs to share files.
95
 
92
 
96
-| Owncloud database user     | owncloudadmin       |
97
-| Owncloud database password | See the [[Readme]] file |
98
-| Owncloud database name     | owncloud            |
99
-
100
-After creating an administrator account then create a user account via the Users dropdown menu entry on the right hand side and log the details in a password manager. Give the user a quota suitable for the size of your microSD card or other storage.
93
+** Initial install
94
+On first visiting your owncloud domain it will ask for an password, then select *Finish*. The password can be anything, but it's a good idea to follow the usual guidelines of using a random password generated by a password manager.
101
 
95
 
102
-Log out from the administrator account and then log back in as the user you just created.
96
+You may wish to add extra apps, such as calendar, music and document editing.
103
 ** On Android
97
 ** On Android
104
 Within F-droid search for *owncloud* and install the client. Also install *CalDAV Sync Adapter*.
98
 Within F-droid search for *owncloud* and install the client. Also install *CalDAV Sync Adapter*.
105
 
99
 
113
 
107
 
114
 You will also be prompted to enter login details. Your Android and Owncloud calendars should now be synchronised.
108
 You will also be prompted to enter login details. Your Android and Owncloud calendars should now be synchronised.
115
 ** On Linux
109
 ** On Linux
116
-Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
110
+It's best to use an [[https://owncloud.com/products/desktop-clients/][officially supported client]] from the Owncloud site, rather than one which may be packaged by your distro. It's more lilkely that the official client will be up to date. [[https://software.opensuse.org/download/package?project=isv:ownCloud:desktop&package=owncloud-client][Packages are available]] for Debian and other distros.
117
 
111
 
118
-You can now drag files into the *~/owncloud* directory and they will automatically sync to your server. It's that easy.
112
+Once the client is installed then open it and log in. After sychronisation you can then drag and drop files into *ownCloud* in your home directory.
119
 * Play Music
113
 * Play Music
120
 ** With the DLNA service
114
 ** With the DLNA service
121
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "/Music/" on a USB thumb drive and then insert it into from socket on the Beaglebone.
115
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "/Music/" on a USB thumb drive and then insert it into from socket on the Beaglebone.

+ 10
- 39
website/EN/usage.html View File

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2016-02-28 Sun 11:27 -->
6
+<!-- 2016-03-12 Sat 21:56 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
329
 <div id="outline-container-orgheadline4" class="outline-2">
329
 <div id="outline-container-orgheadline4" class="outline-2">
330
 <h2 id="orgheadline4">Syncing to the Cloud</h2>
330
 <h2 id="orgheadline4">Syncing to the Cloud</h2>
331
 <div class="outline-text-2" id="text-orgheadline4">
331
 <div class="outline-text-2" id="text-orgheadline4">
332
-</div><div id="outline-container-orgheadline11" class="outline-3">
333
-<h3 id="orgheadline11">Initial install</h3>
334
-<div class="outline-text-3" id="text-orgheadline11">
335
 <p>
332
 <p>
336
-Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
333
+Owncloud provides an easy way to sync files across multiple systems (desktop, laptop and mobile), and is a good way to wean people off of the proprietary systems such as <a href="http://www.drop-dropbox.com/">Dropbox</a>. It can also do many other things, such as acting as a jukebox or a collaborative document editing system. Owncloud servers can also <a href="https://www.youtube.com/watch?v=b1F-N3QXN2s">federate together</a> to make it easy for independent installs to share files.
337
 </p>
334
 </p>
335
+</div>
338
 
336
 
337
+<div id="outline-container-orgheadline11" class="outline-3">
338
+<h3 id="orgheadline11">Initial install</h3>
339
+<div class="outline-text-3" id="text-orgheadline11">
339
 <p>
340
 <p>
340
-You will also need to enter database details:
341
-</p>
342
-
343
-<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
344
-
345
-
346
-<colgroup>
347
-<col  class="org-left" />
348
-
349
-<col  class="org-left" />
350
-</colgroup>
351
-<tbody>
352
-<tr>
353
-<td class="org-left">Owncloud database user</td>
354
-<td class="org-left">owncloudadmin</td>
355
-</tr>
356
-
357
-<tr>
358
-<td class="org-left">Owncloud database password</td>
359
-<td class="org-left">See the <a href="#orgheadline1">Readme</a> file</td>
360
-</tr>
361
-
362
-<tr>
363
-<td class="org-left">Owncloud database name</td>
364
-<td class="org-left">owncloud</td>
365
-</tr>
366
-</tbody>
367
-</table>
368
-
369
-<p>
370
-After creating an administrator account then create a user account via the Users dropdown menu entry on the right hand side and log the details in a password manager. Give the user a quota suitable for the size of your microSD card or other storage.
341
+On first visiting your owncloud domain it will ask for an password, then select <b>Finish</b>. The password can be anything, but it's a good idea to follow the usual guidelines of using a random password generated by a password manager.
371
 </p>
342
 </p>
372
 
343
 
373
 <p>
344
 <p>
374
-Log out from the administrator account and then log back in as the user you just created.
345
+You may wish to add extra apps, such as calendar, music and document editing.
375
 </p>
346
 </p>
376
 </div>
347
 </div>
377
 </div>
348
 </div>
405
 <h3 id="orgheadline13">On Linux</h3>
376
 <h3 id="orgheadline13">On Linux</h3>
406
 <div class="outline-text-3" id="text-orgheadline13">
377
 <div class="outline-text-3" id="text-orgheadline13">
407
 <p>
378
 <p>
408
-Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
379
+It's best to use an <a href="https://owncloud.com/products/desktop-clients/">officially supported client</a> from the Owncloud site, rather than one which may be packaged by your distro. It's more lilkely that the official client will be up to date. <a href="https://software.opensuse.org/download/package?project=isv:ownCloud:desktop&amp;package=owncloud-client">Packages are available</a> for Debian and other distros.
409
 </p>
380
 </p>
410
 
381
 
411
 <p>
382
 <p>
412
-You can now drag files into the <b>~/owncloud</b> directory and they will automatically sync to your server. It's that easy.
383
+Once the client is installed then open it and log in. After sychronisation you can then drag and drop files into <b>ownCloud</b> in your home directory.
413
 </p>
384
 </p>
414
 </div>
385
 </div>
415
 </div>
386
 </div>