mifr/subsurface
1
0
Fork 0
mirror of https://github.com/subsurface/subsurface.git synced 2025-01-31 21:23:24 +00:00
Code Issues Projects Releases Packages Wiki Activity

User manual update: Cloud services

Browse source 
This ammends the existing text on cloud services.

Signed-off-by: Willem Ferguson <willemferguson@zoology.up.ac.za>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Willem Ferguson 2015-09-14 20:55:06 +02:00 • committed by Dirk Hohndel
parent d0b26c6e57
commit 2dd52b4921
1 changed files with 45 additions and 34 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

79
Documentation/user-manual.txt
View file

@ -2481,51 +2481,62 @@ reason, facilities such as _divelogs.de_ and _Diving Log_ offer to store
dive log information on the Internet.
_Subsurface_ includes access to a transparently integrated cloud storage
backend that is available to all Subsurface users. In order to use the
_Subsurface cloud storage_ the users need to follow these steps
backend that is available to all Subsurface users. Storing and retrieving a dive log
from the cloud is no more difficult than accessing the dives on the local hard disk.
The only requirement is that one should first register as a user on the cloud.
To use _Subsurface cloud storage_ , follow these steps:
* Create a cloud storage account:
=== Create a cloud storage account
** Open the _Preferences_
** Under _Defaults_, in the _Subsurface cloud storage_ section, enter
their email address and a password
** Click _Apply_ or _Done_ to send email address and password to the
server
** The server will respond with an email to the given address that
contains a verification PIN
** Enter the PIN in the corresponding field in the _Preferences_ dialog
(this field is only visible while the backend server is waiting for email
** Open the *Network Preferences* by selecting _File_ -> _Preferences_ -> _Network_.
** In the section headed _Subsurface cloud storage_, enter an email address that
_Su bsurface can use for user registration.
** Enter a novel password that_Subsurface_ will use to store the
dive log in the cloud.
** Click _Apply_ to send the above email address and password to the
(remote) cloud server. The server responds by sending a verification PIN to
the above email address (This is the *only* occasion that _Subsurface_ uses the
email address provided above). The *Network Preferences* dialog now has a new PIN text
box, not visible previously.
** Enter the PIN in the corresponding text box in the *Network Preferences* dialog
(this field is only visible while the server is waiting for email
address confirmation)
** Click _Apply_ or _Done_ again, the _Subsurface cloud storage_ account
will be marked as verified and the _Subsurface cloud storage_ service can
be used
** Click _Apply_ again. The _Subsurface cloud storage_ account
will be marked as verified and the _Subsurface cloud storage_ service is initialised for use.
* Use _Subsurface cloud storage_
=== Using _Subsurface cloud storage_
** From the _File_ menu users can load and save data to the _Subsurface
cloud storage_ server
** In the _Preferences_, users can select to use the _Subsurface cloud
storage_ data as their default data file which means that the data from
the _Subsurface cloud storage_ will be displayed when _Subsurface_ starts.
** Once the cloud storage has been initialised, two new items appear in the
_File_ menu of the main menu system: _Open cloud storage_ and _Save to cloud storage_.
These options allow the user to load and save data to the _Subsurface
cloud storage_ server.
** In the _Defaults Preferences_ tab, one can select to use the _Subsurface cloud
storage_ data as one's default data file by checking the check box marked _Cloud storage default file_.
This means that the data from
the _Subsurface cloud storage_ is loaded when _Subsurface_ starts ans saved there when one closes _Subsurface_.
_Subsurface_ keeps a local copy of the data and _Subsurface_ stays fully
functional if used while offline. _Subsurface_ will simply synchronize the
data with the backend serer the next time it is used while the computer is
online.
** _Subsurface_ keeps a local copy of the data and the cloud facility remains fully
functional even if used while disconnected to the Internet. _Subsurface_ simply synchronises the
data with the cloud server the next time ithe program is used while the computer is
connected to the Internet.
* Web access to _Subsurface cloud storage_
=== Web access to _Subsurface cloud storage_
One of the nice side benefits of using _Subsurface cloud storage_ is that
you can also access your dive data from any web browser. Simply open
https://cloud.subsurface-divelog.org[https://cloud.subsurface-divelog.org],
one can also access one's dive data from any web browser. Simply open
https://cloud.subsurface-divelog.org[_https://cloud.subsurface-divelog.org_],
log in with the same email and password, and you can see an HTML export of
the latest dive data that was synced to the _Subsurface cloud storage_.
the last dive data that was synced to the _Subsurface cloud storage_. The dive information
that is shown is only the contents of the recorded dive logs, NOT the calculated values
shown in the *Profile* panel,
including some cylinder pressures, deco ceilings and O~2~/He/N~2~ partial pressures.
If you prefer not to use the integrated cloud storage of dive logs (and
don't need the web access to your data), it is also simple to store your
=== Other cloud services
If one prefers not to use the integrated cloud storage of dive logs (and
don't need the web access), it is also simple to store
dive logs in the cloud using several of the existing facilities on the
Internet.
For instance
http://www.dropbox.com/[_Dropbox_]
offers a free application that allows
@ -2548,9 +2559,9 @@ involved for this service. Dropbox (Windows, Mac
and Linux) can be installed by accessing the
http://www.dropbox.com/install[_Install Page on the Dropbox website_]
. Alternatively one can use _Dropbox_ as a mechanism to backup one's dive log. To
Store a dive log in the Cloud, select _File -> Save as_ from the _Subsurface_ main menu,
Store a dive log on _Dropbox_, select _File -> Save as_ from the _Subsurface_ main menu,
navigate to the _Dropbox_ folder and select the _Save_ button. To access the dive log
in the Cloud, select _File -> Open Logbook_ from the _Subsurface_
in _Dropbox_, select _File -> Open Logbook_ from the _Subsurface_
main menu and navigate to the dive log file in the _Dropbox_ folder and select the
_Open_ button.