diff options
author | Guillaume GARDET <guillaume.gardet@free.fr> | 2016-03-12 14:04:51 +0100 |
---|---|---|
committer | Dirk Hohndel <dirk@hohndel.org> | 2016-03-12 06:46:03 -0800 |
commit | c8df5625d4ed8fd687a64a5c4f12480612f84982 (patch) | |
tree | 629cc28a1600782689aa7f9ae60805793f3cbdcd /Documentation/mobile-manual_fr.txt | |
parent | 343e8e3df6ab284433a70f0c9c39dbaedc0f0a86 (diff) | |
download | subsurface-c8df5625d4ed8fd687a64a5c4f12480612f84982.tar.gz |
Documentation: add mobile user manual to POT/PO management and update french translation of user-manual and mobile-manual
Signed-off-by: Guillaume GARDET <guillaume.gardet@free.fr>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Diffstat (limited to 'Documentation/mobile-manual_fr.txt')
-rw-r--r-- | Documentation/mobile-manual_fr.txt | 299 |
1 files changed, 299 insertions, 0 deletions
diff --git a/Documentation/mobile-manual_fr.txt b/Documentation/mobile-manual_fr.txt new file mode 100644 index 000000000..c8b75b02a --- /dev/null +++ b/Documentation/mobile-manual_fr.txt @@ -0,0 +1,299 @@ +:icons: +:toc: +:toc-placement: manual +:numbered: + +image::mobile-images/banner.jpg["Banner", align="center"] + +[big]#Subsurface-mobile pour Android: MANUEL UTILISATEUR# + +*Manual author*: Willem Ferguson + +toc::[] + +[blue]#_Version 1.0, Mars 2016_# + +Welcome as a user of _Subsurface_, advanced dive logging software with +extensive infrastructure to describe, organize, interpret and print scuba +and free dives. _Subsurface_ offers many advantages over other similar +software solutions, including compatibility with Windows, Mac-OS/X, Linux +(many distributions) and Android (iOS under development). In addition, +_Subsurface_ is open-source software that allows downloading dive +information from most dive computers. + +Introducing Subsurface-mobile +----------------------------- + +_Subsurface-mobile_ is an extension of _Subsurface_ on laptop and tabletop +computers. It runs on Android smartphone and tablet devices and is a tool +for viewing or sharing dive information at dive sites where a larger +computer is not useful. _Subsurface-mobile_ also allows the gathering of GPS +locations where dives are performed. + +A version of _Subsurface-mobile_ for iOS is under development but not yet +ready for testing. + +While _Subsurface-mobile_ allows one to enter and save dive information +using an Android device, users of _Subsurface-mobile_ typically use the +mobile app as an extension of the laptop/desktop version of _Subsurface_. +This allows the storage of dive logs on the Internet and which can be shared +by the Android version as well as the desktop version. While the desktop +version of _Subsurface_ shows much more detailed information for each dive, +the mobile version allows one to have a more accessible dive log on a dive +trip, useful for proving dive experience to dive shops or to review previous +dives. + +_Subsurface-mobile_ allows one to: + +- Download existing dive log information from the Internet. +- View this information on an Android device. +- Edit many of the dive log data fields, e.g. divemaster, buddy, equipment or + notes about a dive. +- Create and add new dive records to one's dive log. +- Store the updated dive log on the Internet. +- Record, store and apply GPS positions of dives. +- View the localities of recorded GPS positions and of dives on a map. + +These items are discussed in greater detail in the following text. What +_Subsurface-mobile_ does not support (at this time) is downloading dive data +directly from a dive computer. That still has to happen with _Subsurface_ on +a desktop or laptop computer. We are investigating ways to support +downloading from a subset of the supported dive computers on Android +devices, but this is not yet ready for testing. + +== Installing _Subsurface-mobile_ on an Android device + +Find _Subsurface-mobile_ in the _Google Play Store_. Search for +_Subsurface-mobile_ and install it. + +== Using _Subsurface-mobile_ for the first time + +Upon starting _Subsurface-mobile_ for the first time, a Subsurface splash +screen is shown while the program loads. On some devices this may take +several seconds. After loading, the _Cloud Credentials screen_ appears (see +image below). + +image::mobile-images/landingscreen.jpg["FIGURE: Mobile landing screen", align="center"] + +Since _Subsurface_ is largely dependent on a dive log saved on the Internet, +provide a user-ID and password for access to the _Subsurface Cloud_. These +credentials are obtained by opening the desktop version of _Subsurface_ and +by clicking _File -> Preferences -> Network_, explained in detail in the +user manual for the _Subsurface_ desktop version. Once the account has +been created and verified using the desktop version one can use _Subsurface-mobile_. + +When entering a password, it is possible to check a checkbox that enables +the text of the password to be shown. Checking the check box labelled +"Remember" allows _Susburface-mobile_ to keep the credentials for subsequent +logins (see image above). Having entered the credentials, tap the disk icon +at the bottom of the screen. _Subsurface-mobile_ attempts to download the +existing dive log from the_Subsurface_ cloud server. Appropriate messages +are shown onscreen. Finally a list of dives are shown. + + +== Local copy of the dive log and synchronisation with Internet + +Once the dive list has been downloaded from the Internet, +_Subsurface-mobile_ keeps a local copy on the mobile device. This means +that, if there is no Internet connection at a dive site, one can still +access the local copy and view and manipulate dive information. If there is +Internet connectivity, _Subsurface-mobile_ accesses the Internet-based dive +log to verify that the local copy is still the same as the Internet-stored +copy. If not, the local copy and the copy on the server are synchronised. + +== A Few Remarks About The User Interface + +At the bottom of many Subsurface-mobile screens is a round button that +provides for several actions and which allows the selection of the main +affirmative action (see image above and image below). On Android devices, +use the Android Back button for "cancel", "discard" or "back" actions. For +example, when editing dive information, tapping the action button saves the +changes, the Android back button can be used to cancel the edit without +saving changes. + +image::mobile-images/actionbutton.jpg["FIGURE: Action Button", align="center"] + +Instead of the more traditional "hamburger" menu button in the top left or +right corner of the screen to open menus, _Subsurface-mobile_ uses a +different user interaction philosophy based on the Kirigami framework +developed by the Plasma developers. To open the main menu one has three +options: + +- Tap on the right-arrow symbol in the lower left corner of the screen (easy + to reach for hand held devices) +- Swipe towards the right across the left edge of the screen +- Drag the action button visible on most screens with the main action to the + right + +image::mobile-images/menu.jpg["FIGURE: Dive management subpanel", align="center"] + +The images above indicate some of the important features of the menu +system. On the left is the main menu that is activated as described +above. In the middle is the menu that opens if one taps the _GPS_ option on +the main menu. On the right is the menu that opens if one taps the _Manage +Dives_ option on the main menu. + +Similarly, the context menu (currently only available on the dive details +screen) can be opened one of these three ways: + +- Tap on the left-arrow symbol in the lower right corner of the screen +- Swipe to the left across the right edge of the screen +- Drag the action button to the left + +== Viewing the Dive List + +Most of the actions of _Subsurface-mobile_ center around the dives on the +dive list. While the dive list is loading from the cloud, a message appears +at the bottom of the screen, indicating that the cloud is being accessed +(see image on left, below). Once the list is loaded one can scroll up and +down. Tapping a dive on the list brings up a display of _Details View_ for +that dive (see image on right below). This includes the dive profile as +well as additional information and notes. + +image::mobile-images/divelist.jpg["FIGURE: Dive list screen", align="center"] + +One can view other dives by swiping the _Details view_ to the right (for the +previous dive) or to the left (following dive). + +== Editing dive details. + +At the bottom of the dive details screen the _Action Button_ contains a +pencil (image on right, above). Tapping the button brings up a panel with +edit boxes that allows one to change the existing dive information, +e.g. adding text to the dive notes or changing the names or values of some +of the information (see image below). It may be necessary to scroll the +window to access all the information. At the bottom of the edit screen is a +_Save_ action button. Tap this to save the new information. Having saved the +data, the dive list screen is updated and shown. To cancel any edits, tap +the Android Back Button. + +image::mobile-images/editdive.jpg["FIGURE: Dive edit screen", align="center"] + +== Adding a new dive to the dive list + +It is also possible to add an additional dive to the existing dive list. On +the main menu tap _Manage dives -> Add dive manually_. This opens a screen +that is identical to the editing screen discussed above. When a dive is +added manually, one cannot directly add a dive profile from a dive +computer. However, if one does not use a dive computer, the duration, depth +and several other bits of information about the new dive can be entered. The +_Action button_ at the bottom of the screen contains a disk symbol. Tap this +to save the new dive. To cancel any edits, tap the Android Back Button. The +left-hand image below shows a screenshot of a dive being created and the +right-hand image shows the same dive in _Details View_. + +image::mobile-images/createdive.jpg["FIGURE: Dive edit screen", align="center"] + +== Deleting a dive + +The _details view_ of a dive has a context menu on the right-hand side that +can be activated as described above (e.g. by tapping the arrow icon at the +bottom right of the screen or by dragging the _Action Button_ to the left). +The context menu has a single item: "Delete dive". If this option is tapped, +the dive shown in the _Details View_ is deleted. One has a brief opportunity +to undo the delete by tapping the _undo_ message that appears at the bottom +of the screen. If the _undo_ message is not tapped, the dive is deleted. + +== Dive log management + +A central part of _Subsurface-mobile_ is the ability to store the dive +log using the _Subsurface_ cloud storage. +This provides security against loss or damage to the dive information caintained in a local copy of +the dive log and allows the desktop version of _Subsurface_ to +access changes made using the mobile device. This ability is accessed +throug the main menu (by dragging the Action Button to the right, or +alternatively tap the right angle button at the bottom left of the screen). + Tap the option _Manage dives_, enabling a number of options: + +=== Add new dive manually + +This is described above under the section dealing with the dive list. + +=== Upload dive log to the _Subsurface_ cloud storage + +One can upload the dives contained on the mobile device to the _Subsurface_ +cloud storage by tapping the option _Upload to cloud_. This synchronizes +the local changes to the dive log with the cloud storage. + +=== Download dive log from the cloud storage + +In the dive management subpanel, tap the option _Refresh_, causing the local +divelog to be refreshed from the cloud so that the cloud and local versions +are synchronised. + +=== Changing the login credentials on the _Subsurface_ cloud + +It may be necessary to change one's login credentials, for instance if one's +email address (initially used as a credential) has changed. To change the +credentials, open the main menu and tap _Cloud credentials_. This opens the +setup screen for specifying new credentials. + + +== Recording dive locations using GPS. + +The fact that most smartphones have GPS facilities allows one to record the +locations of dives. One can take the smartphone on the dive boat during a +dive and locations will be automatically recorded at regular intervals. +These locations can then be applied to dives in the dive list. Here is how +it's done: + +=== Setting up the GPS + +Open the main menu and tap _GPS -> Preferences_. Now specify the way in +which GPS data need to be automatically collected (image on right, +below). One can specify that data are collected at regular intervals, +e.g. every 10 minutes, or at regular distances, e.g. after the boat has +moved more than 200m, or a combination of both of the above +approaches. Provide the appropriate information and tap the _Save_ action +button. The program is now ready to collect GPS positions. + +image::mobile-images/gpssetup.jpg["FIGURE: GPS setup screen", align="center"] + +=== Collecting GPS positions + +Ensure that the GPS on the Android device has been activated. At the bottom +of the GPS submenu is a check box _Run location service_ (image on left, +above). Check this box and _Subsurface-mobile_ starts to collect GPS +locations automatically, following the preferences specified as described +above. After the dive one can deactivate the collection of GPS data by +de-activating the same check box at the bottom of the main menu. + +=== Storing the GPS data on the _Subsurface_ cloud + +Activate the main menu and select the _GPS_ option that brings up the +submenu of GPS-related actions (image on left, above). Tap _Upload GPS data_ +that saves the GPS data on the _Subsurface_ cloud server. These GPS data are +saved *separately* from the other dive log data. All collected GPS data are +kept on the Android device, independent of whether they have been uploaded +or not. + +=== Downloading GPS data from the _Subsurface_ cloud + +Download the GPS data that have been saved on the cloud by selecting +_Download GPS Data_ from the GPS subpanel. + +=== Viewing GPS data + +From the GPS submenu (image on left, above) select _Show GPS fixes_. This +brings up a list of GPS positions obtained using the location service (image +on left, below). Two actions are possible for each of the locations, enabled +if one taps the handle (the three horisontal stripes on the right, see image +on left, below) and then drags the specific item to the left (image on +right, below). This exposes two options. Tapping the dustbin deletes this +particular GPS location. Tapping the teardrop-shaped icon (actually a Google +Maps pin) opens up Google Maps with a pin indicating the exact map position +of the GPS record being viewed. The two above options can be hidden by +drawing the GPS record to the right, again using the handle. + +image::mobile-images/gpsmanagement.jpg["FIGURE: GPS management", align="center"] + +=== Applying GPS data to dives in the dive log + +Assuming that all the dives have been entered into the dive log or have been +downloaded from the _Subsurface_ cloud, one can apply the GPS positions to +these dives. GPS positions can therefore only be applied to dives in the +dive list. From the GPS subpanel, tap _Apply GPS fixes_. The dive list +contains the start and end times of each dive. Now, _Subsurface-mobile_ +applies the first GPS position that falls within the dive period of each +dive. This results in a GPS position for each dive that is saved as part of +the dive list. |