fix #87 text formatting (#88)

fix #87

Author: alex-cit

src/howto/contribute.md

@@ -2,8 +2,7 @@
 
 How to contribute to the project? 
 
-We are happy to help to promote work or co-author and place on our websites or give 
-special offer for Mergin Maps Cloud for project contributors.
+We are happy to help to promote work or co-author and place on our websites or give special offer for Mergin Maps Cloud for project contributors.
 
 <CommunityJoin />
 
@@ -43,8 +42,7 @@ or for other subprojects
 
 ## Develop
 
-Software developer? Code and prepare a pull request. We will help you with setup of the development 
-environment and answer your questions.
+Software developer? Code and prepare a pull request. We will help you with setup of the development environment and answer your questions.
 
  - <GitHubRepo id="lutraconsulting/input" desc="Mergin Maps Input" />
  - <GitHubRepo id="lutraconsulting/mergin" desc="Mergin Maps Cloud" />

src/howto/customapp.md

@@ -2,23 +2,12 @@
 
 <PublicImage src="input.svg" />
 
-The [Input app](https://inputapp.io/) is a great companion to Mergin as it 
-provides seamless synchronisation of data between your phone/tablet and 
-Mergin service. We know that sometimes people want a mobile app optimised 
-for a specific use case rather than just using a general purpose app like Input.
+The [Input app](https://inputapp.io/) is a great companion to Mergin as it provides seamless synchronisation of data between your phone/tablet and Mergin service. We know that sometimes people want a mobile app optimised for a specific use case rather than just using a general purpose app like Input.
 
-The good news is that Input is licensed as open source software and therefore 
-it is possible to build custom apps off it. Maybe you just want to change the 
-branding or disable some functionality - or maybe you want a bigger overhaul 
-of the user interface - anything is possible with a bit of development.
+The good news is that Input is licensed as open source software and therefore it is possible to build custom apps off it. Maybe you just want to change the branding or disable some functionality - or maybe you want a bigger overhaul of the user interface - anything is possible with a bit of development. 
 
 ## GitHub
 
-If you are interested in building a custom app, you can start by going to 
-<GitHubRepo id="lutraconsulting/input" desc="Input App repository" /> on GitHub and 
-building it for your platform. 
-The <GitHubRepo id="lutraconsulting/input-sdk" desc="Input SDK repository" />
-provides all the dependencies for various platforms (Android, iOS, macOS, Windows).
+If you are interested in building a custom app, you can start by going to <GitHubRepo id="lutraconsulting/input" desc="Input App repository" /> on GitHub and building it for your platform. The <GitHubRepo id="lutraconsulting/input-sdk" desc="Input SDK repository" /> provides all the dependencies for various platforms (Android, iOS, macOS, Windows).
 
-For the Input source code and developers' documentation, you can visit 
-<GitHubRepo id="lutraconsulting/input" />.
+For the Input source code and developers' documentation, you can visit <GitHubRepo id="lutraconsulting/input" />.

src/howto/dbsync.md

@@ -1,8 +1,3 @@
 # PostgreSQL DB Sync
 
-Integrating with other databases is an important feature provided by the DB sync tool, 
-hosted in <GitHubRepo id="lutraconsulting/mergin-db-sync" />
-repository. It takes care of synchronisation of changes between a Mergin project and a PostgreSQL 
-database. The synchronisation works both ways: it pushes changes from PostgreSQL to Mergin and 
-it also pulls changes from Mergin to PostgreSQL. Please see the project page for more details.
-
+Integrating with other databases is an important feature provided by the DB sync tool, hosted in <GitHubRepo id="lutraconsulting/mergin-db-sync" /> repository. It takes care of synchronisation of changes between a Mergin project and a PostgreSQL database. The synchronisation works both ways: it pushes changes from PostgreSQL to Mergin and it also pulls changes from Mergin to PostgreSQL. Please see the project page for more details.

src/howto/exif_metadata.md

@@ -1,8 +1,9 @@
 # Exif Metadata
+[[toc]]
 
 Input comes with predefined default value expression functions which can be used to read an image EXIF metadata.
 
-## Functions
+## Supported functions
 
 Following functions are supported:
 
@@ -15,25 +16,23 @@ Following functions are supported:
 - `read_exif_longitude('<ABSOLUTE_PATH_TO_IMAGE>')` 
     - returning decimal number
 
+## Allowing location tags
 Note that **location tags have to be allowed** in a camera settings. You can find the option as following:
 
-## Android
+### Android
 Open Camera app -> Camera settings -> Location tags. 
 ![photos](./android_geo_tags.jpg)
 
-## iOS
+### iOS
 Open Settings -> Privacy -> Location Services -> Camera (app).
 ![photos](./ios_geo_tags.png)
 
 ## Use it with Photo widget
-The parameter `<ABSOLUTE_PATH_TO_IMAGE>` can be set with an expression using value of another field. 
-Therefore you can use a value from a text field of an attachment type as a parameter for Input's EXIF functions as following:
+The parameter `<ABSOLUTE_PATH_TO_IMAGE>` can be set with an expression using value of another field. Therefore you can use a value from a text field of an attachment type as a parameter for Input's EXIF functions as following:
 
 `read_exif(@project_home + '/' + "photo", 'GPSImgDirection')`
 
-You can use both `Take a photo` or `From gallery` actions of the attachment widget. While capturing a photo with a camera, 
-GPS EXIF data are added to the photo metadata. Make sure that location permissions are allowed in Input and also 
-for your camera app.
+You can use both `Take a photo` or `From gallery` actions of the attachment widget. While capturing a photo with a camera, GPS EXIF data are added to the photo metadata. Make sure that location permissions are allowed in Input and also for your camera app.
 
 For further examples you can check fields definitions of project <MerginMapsProject id="lutraconsulting/test_exif" /> accessible on Mergin.
 

src/howto/input_features.md

@@ -15,39 +15,29 @@ To be able to transfer your data to your mobile/tablet device, share your projec
 - You can sign in to your Mergin account
 
 ## Accessing projects
-You can install Input from Google Play Store. Once you open the
-application for the first time, it will take you to **Home** screen.
-This screen displays all the projects stored locally (under
-/sdcard/INPUT folder).
+You can install Input from Google Play Store. Once you open the application for the first time, it will take you to **Home** screen. This screen displays all the projects stored locally (under /sdcard/INPUT folder).
 
 ![MY PROJECTS screen in Input](./input_projects_home.png)
 
-To access your projects or those shared with you through Mergin, select
-**My projects** or **Shared with me**  tabs respectively. You will need your log in details to sign in to
-Mergin:
+To access your projects or those shared with you through Mergin, select **My projects** or **Shared with me**  tabs respectively. You will need your log in details to sign in to Mergin:
 
 ![Mergin sign in screen in Input](./input_mergin_signin.png)
 
-Once logged in, you can download your project to work on it locally by
-pressing download button to the right of the project:
+Once logged in, you can download your project to work on it locally by pressing download button to the right of the project:
 
 ![My projects screen in Input](./input_projects_my_projects.png)
 
-The project will be available for loading in Input after you download it locally.
-Select **Home** and you should be able to see your downloaded
-project:
+The project will be available for loading in Input after you download it locally. Select **Home** and you should be able to see your downloaded project:
 
 ![Home screen in Input](./input_projects_home_updated.png)
 
 Selecting a project under **Home** will open it in INPUT.
 
 ## Adding/editing features
 
-To add a feature, select the record button from the lower panel. When you tap on the record button, it will list all the
-layers, you can edit. In Input, you have two modes to capture feature:
+To add a feature, select the record button from the lower panel. When you tap on the record button, it will list all the layers, you can edit. In Input, you have two modes to capture feature:
 
   - GPS location or streaming (if you are capturing lines/areas)
-
   - Free hand: by adding points or nodes to lines or areas
 
 ### Capturing points
@@ -65,27 +55,20 @@ If your survey layer is a line or area, the panel at the bottom changes to a fig
 You can:
 
 - Use **Add point** to define the shape of your line or area manually by navigating through the map
-
 - If you want to **stream** the GPS to shape your line or area, press and hold **GPS** button on the bottom left corner.
 
 Once finished, press **Done**. If your feature is an area, it will join the last point to the first point to close the shape.
 
 ## Viewing/deleting existing data
-You can view the existing data by tapping on them on the map. It will
-open a preview panel (according to Display settings in QGIS - see
-project preparation section). To edit the form related to an existing
-feature, you can press the pencil within the preview panel.
+You can view the existing data by tapping on them on the map. It will open a preview panel (according to Display settings in QGIS - see project preparation section). To edit the form related to an existing feature, you can press the pencil within the preview panel.
 
 For point layers, you can also change the location (geometry) of your layer, by pressing **Edit geometry**. Similar to capturing a new point, a map will appear with a cross-hair at your GPS location. You can adjust the location of the cross-hair by panning the map and press **Confirm**.
 
-If you want to delete the item, you can press the recycle bin from the lower panel
-in the form edit.
+If you want to delete the item, you can press the recycle bin from the lower panel in the form edit.
 
 ## Synchronisation of data/ projects
 You can upload your changes through the Mergin service, once you have network connectivity. Select Project from the lower panel and then tap on **My projects** (or **Shared with me** if you have write access to the shared project). Input should automatically flag changed projects with a synchronise icon.
 
 ![My projects screen with updated local project](./input_my_projects_upload.png)
 
-Pressing sync button to the right of the project will send the updated
-data to the Mergin service. Similarly, if a project and its data has been updated
-through the Mergin service, you will be notified to synchronise the changes to your local copy.
+Pressing sync button to the right of the project will send the updated data to the Mergin service. Similarly, if a project and its data has been updated through the Mergin service, you will be notified to synchronise the changes to your local copy.

src/howto/input_ui.md

@@ -17,35 +17,24 @@ You can **Search** for projects using the search bar on the top. To access your
 ![Projects screen](./input_screen.jpg)
 
 ## GPS
-By default, the map centred around the project extent. Pressing
-and holding GPS icon, will turn on the GPS auto-centre mode.
+By default, the map centred around the project extent. Pressing and holding GPS icon, will turn on the GPS auto-centre mode.
 
-GPS signal colour on the map denotes the accuracy threshold set by user
-within the Input settings (See Settings section).
+GPS signal colour on the map denotes the accuracy threshold set by user within the Input settings (See Settings section).
 
 ## Record
-This option will allow user to capture the position of the GPS and save it
-as point or line vertices. Pressing the **Record**  button will
-list all the survey layers (point and line layers within the project not
-marked as read-only in the QGIS project properties). User can then
-select a layer.
+This option will allow user to capture the position of the GPS and save it as point or line vertices. Pressing the **Record**  button will list all the survey layers (point and line layers within the project not marked as read-only in the QGIS project properties). User can then select a layer.
 
-If a point layer is selected, a point geometry will be recorded at the
-location of the GPS. A form (attribute table) for the point will appear
-for user to fill in.
+If a point layer is selected, a point geometry will be recorded at the location of the GPS. A form (attribute table) for the point will appear for user to fill in.
 
-If a line layer is selected, a path will be generated from the GPS track
-until the record button is pressed again. The form for the recorded line
-will appear accordingly.
+If a line layer is selected, a path will be generated from the GPS track until the record button is pressed again. The form for the recorded line will appear accordingly.
 
 Pressing and holding **Record** button will allow you to set the default survey layer. This option is also available under the **Settings** section.
 
 ## Zoom to project
 This is a shortcut to zoom the extent of all visible layers within the project.
 
 ## Map themes
-Themes generated from QGIS project will be listed here. User can switch
-between different map themes using this option.
+Themes generated from QGIS project will be listed here. User can switch between different map themes using this option.
 
 ## Settings
 Input specific configuration can be accessed through settings.
@@ -54,17 +43,12 @@ Input specific configuration can be accessed through settings.
 
 ### Mergin
 
-Displays the current user signed in to Mergin. To clear the log in,
-users can tap on their name.
+Displays the current user signed in to Mergin. To clear the log in, users can tap on their name.
 
 ### GPS
 
-**Follow GPS with map** will pan the map so the GPS point can be seen on the
-map.
+**Follow GPS with map** will pan the map so the GPS point can be seen on the map.
 
-**GPS accuracy** colours show the current strength of the signal based on the
-Accuracy threshold. If the signal falls within the the threshold, the
-colour will be green. If it is outside, it will be orange. The indicator
-will be red in case there is no GPS position fix available.
+**GPS accuracy** colours show the current strength of the signal based on the Accuracy threshold. If the signal falls within the the threshold, the colour will be green. If it is outside, it will be orange. The indicator will be red in case there is no GPS position fix available.
 
-**Line rec. interval** when streaming GPS position for capturing lines, you can set the intervals at which the GPS location will be used as vertices of the line.
+**Line rec. interval** when streaming GPS position for capturing lines, you can set the intervals at which the GPS location will be used as vertices of the line.

src/howto/integration.md

@@ -1,15 +1,12 @@
 # Integrate Mergin 
 
-Mergin is an open platform that aims to be developer friendly, 
-and it has been designed to allow easy integration with other software.
+Mergin is an open platform that aims to be developer friendly, and it has been designed to allow easy integration with other software.
 
 ## Python Client
 
 ### Installation 
 
-The easiest way to use Mergin programmatically is to use the Python 
-client module. It is available in the PyPI repository and so it can 
-be installed with `pip`:
+The easiest way to use Mergin programmatically is to use the Python client module. It is available in the PyPI repository and so it can be installed with `pip`:
 
 ```
 pip3 install mergin-client
@@ -26,35 +23,28 @@ mc = MerginClient(login='john', password='pass')
 mc.download_project('john/project1', '/home/john/mergin/project1')
 ```
 
-You can of course also get project status, push/pull changes, create/delete projects 
-and more.
+You can of course also get project status, push/pull changes, create/delete projects and more.
 
 The source code of the Python client is available on GitHub in <GitHubRepo id="lutraconsulting/mergin-py-client" /> repository.
 
 ### Command Line Interface
 
-For those who prefer using terminal, there is `mergin` command line tool 
-shipped with the Python client.
-With several built-in commands, it is possible to download Mergin projects, 
-push/pull changes, create or delete projects and more.
+For those who prefer using terminal, there is `mergin` command line tool shipped with the Python client. With several built-in commands, it is possible to download Mergin projects, push/pull changes, create or delete projects and more.
 
 For example, to download a Mergin project to a local directory:
 ```
 mergin download john/project1 ~/mergin/project1
 ```
 
-Please see <GitHubRepo id="lutraconsulting/mergin-py-client" /> repository for
-more information on the usage.
+Please see <GitHubRepo id="lutraconsulting/mergin-py-client" /> repository for more information on the usage.
 
 ## C++ Standalone Client
 
-C++ Client has advantage over Python that is is completely 
-without any dependencies. 
+C++ Client has advantage over Python that is is completely without any dependencies. 
 
 ### Installation 
 
-Just  <GitHubRepo id="lutraconsulting/mergin-cpp-client/releases" desc="download"/> binary for your platform and 
-use it from command line.
+Just  <GitHubRepo id="lutraconsulting/mergin-cpp-client/releases" desc="download"/> binary for your platform and use it from command line.
 
 ### Usage 
 ```bash 
@@ -75,10 +65,8 @@ Commands:
   remove         Remove project from server.
 ```
 
-Please see <GitHubRepo id="lutraconsulting/mergin-cpp-client" /> repository 
-for more information on the usage.
+Please see <GitHubRepo id="lutraconsulting/mergin-cpp-client" /> repository for more information on the usage.
 
 ### C++ Mergin API Core Library 
 
-Client is based on the Qt-based <GitHubRepo id="lutraconsulting/input/tree/master/core" desc="mergin api core library" />
-used by the [Input App](https://inputapp.io) to sync the projects in the mobile application
+Client is based on the Qt-based <GitHubRepo id="lutraconsulting/input/tree/master/core" desc="mergin api core library" /> used by the [Input App](https://inputapp.io) to sync the projects in the mobile application.

src/howto/mergince.md

@@ -2,15 +2,10 @@
 
 <PublicImage src="Mergin.svg" />
 
-The [Mergin](https://public.cloudmergin.com) is a great companion to Input as it 
-provides seamless synchronisation of data between your phone/tablet, 
-Mergin service and QGIS Desktop.
+The [Mergin](https://public.cloudmergin.com) is a great companion to Input as it provides seamless synchronisation of data between your phone/tablet, Mergin service and QGIS Desktop.
 
-The good news is that Mergin CE is licensed as open source software and therefore 
-it is possible to do your custom deployments.
+The good news is that Mergin CE is licensed as open source software and therefore it is possible to do your custom deployments.
 
 ## GitHub
 
-If you are interested in deploying Mergin CE, you can start by going to 
-<GitHubRepo id="lutraconsulting/mergin" /> on GitHub and 
-read instructions how to deploy it for your platform.
+If you are interested in deploying Mergin CE, you can start by going to <GitHubRepo id="lutraconsulting/mergin" /> on GitHub and read instructions how to deploy it for your platform.