Forms refactoring (#707)

* restructure forms

* sidebar formatting

* configure forms overview page

* remove best-practice, content to overview and project preparation

* text

* date and time

* numbers

* checkbox

* qr code

* value select

* forms widget relations

* forms refactoring - attributes form layout

* form widgets - Photos, Info widgets (#696)

* forms refactoring - use cases

* html and text widgets link, possible duplicate content

* first feedback round

* forms refactoring - fix redirects

---------

Co-authored-by: Tomas Mizera <[email protected]>

Author: alex-cit

REDIRECTS

@@ -28,7 +28,7 @@ https://help.cloudmergin.com/plugin-installation	https://merginmaps.com/docs/set
 https://help.cloudmergin.com/plugin-logs	https://merginmaps.com/docs/misc/troubleshoot/
 https://help.cloudmergin.com/plugin-new-project	https://merginmaps.com/docs/manage/create-project/
 https://help.cloudmergin.com/plugin-sync-project	https://merginmaps.com/docs/manage/plugin/
-https://help.cloudmergin.com/plugin-variables	https://merginmaps.com/docs/layer/plugin-variables/
+https://help.cloudmergin.com/plugin-variables	https://merginmaps.com/docs/layer/variables/
 https://help.cloudmergin.com/project-advanced	https://merginmaps.com/docs/manage/project-advanced/
 https://help.cloudmergin.com/project-details	https://merginmaps.com/docs/manage/project-history/
 https://help.cloudmergin.com/quick-start	https://merginmaps.com/docs/tutorials/capturing-first-data/
@@ -62,7 +62,7 @@ https://help.inputapp.io/howto/exif_metadata	https://merginmaps.com/docs/layer/e
 https://help.inputapp.io/howto/external_gps	https://merginmaps.com/docs/field/external_gps/
 https://help.inputapp.io/howto/gps_accuracy	https://merginmaps.com/docs/field/gps_accuracy/
 https://help.inputapp.io/howto/package_qgis_project	https://merginmaps.com/docs/manage/create-project/
-https://help.inputapp.io/howto/position_variables	https://merginmaps.com/docs/layer/position_variables/
+https://help.inputapp.io/howto/position_variables	https://merginmaps.com/docs/layer/variables/
 https://help.inputapp.io/howto/proj	https://merginmaps.com/docs/gis/proj/
 https://help.inputapp.io/howto/project_config	https://merginmaps.com/docs/gis/features/
 https://help.inputapp.io/howto/registration	https://merginmaps.com/docs/setup/sign-up-to-mergin-maps/
@@ -75,11 +75,11 @@ https://help.inputapp.io/howto/settingup_background_map	https://merginmaps.com/d
 https://help.inputapp.io/howto/settingup_background_map_rastertile	https://merginmaps.com/docs/gis/settingup_background_map/
 https://help.inputapp.io/howto/settingup_background_map_vectortile	https://merginmaps.com/docs/gis/settingup_background_map/
 https://help.inputapp.io/howto/settingup_forms	https://merginmaps.com/docs/layer/form-widgets/
-https://help.inputapp.io/howto/settingup_forms_cascade	https://merginmaps.com/docs/layer/form-configuration/
+https://help.inputapp.io/howto/settingup_forms_cascade	https://merginmaps.com/docs/layer/value-select/
 https://help.inputapp.io/howto/settingup_forms_checkbox	https://merginmaps.com/docs/layer/form-widgets/
-https://help.inputapp.io/howto/settingup_forms_constraints	https://merginmaps.com/docs/layer/form-configuration/
+https://help.inputapp.io/howto/settingup_forms_constraints	https://merginmaps.com/docs/layer//constraints/
 https://help.inputapp.io/howto/settingup_forms_datetime	https://merginmaps.com/docs/layer/form-widgets/
-https://help.inputapp.io/howto/settingup_forms_defaults	https://merginmaps.com/docs/layer/form-configuration/
+https://help.inputapp.io/howto/settingup_forms_defaults	https://merginmaps.com/docs/layer/default-values/
 https://help.inputapp.io/howto/settingup_forms_layout	https://merginmaps.com/docs/layer/form-layout/
 https://help.inputapp.io/howto/settingup_forms_number	https://merginmaps.com/docs/layer/form-widgets/
 https://help.inputapp.io/howto/settingup_forms_one-to-many	https://merginmaps.com/docs/layer/one-to-n-relations/
@@ -90,7 +90,7 @@ https://help.inputapp.io/howto/settingup_forms_text	https://merginmaps.com/docs/
 https://help.inputapp.io/howto/settingup_forms_valuemap	https://merginmaps.com/docs/layer/form-widgets/
 https://help.inputapp.io/howto/settingup_forms_valuerelation	https://merginmaps.com/docs/layer/form-widgets/
 https://help.inputapp.io/howto/setup_themes	https://merginmaps.com/docs/gis/setup_themes/
-https://help.inputapp.io/howto/working_with_nonspatial_data	https://merginmaps.com/docs/layer/non-spatial-data/
+https://help.inputapp.io/howto/working_with_nonspatial_data	https://merginmaps.com/docs/layer/overview/
 https://help.inputapp.io/input_ui	https://merginmaps.com/docs/field/mobile-app-ui/
 https://help.inputapp.io/licensing	https://merginmaps.com/docs/misc/licensing/
 https://help.inputapp.io/privacy	N/A -- handled by https://merginmaps.com/privacy-policy/
@@ -120,7 +120,7 @@ https://merginmaps.com/docs/fieldwork/gps_accuracy/	https://merginmaps.com/docs/
 https://merginmaps.com/docs/field/input_features/	https://merginmaps.com/docs/field/mobile-features/
 https://merginmaps.com/docs/field/input_ui/	https://merginmaps.com/docs/field/mobile-app-ui/
 https://merginmaps.com/docs/gis/enable_browsing/	https://merginmaps.com/docs/gis/search_data/
-https://merginmaps.com/docs/howto/attach-multiple-photos-to-features/	https://merginmaps.com/docs/layer/attach-multiple-photos-to-features/
+https://merginmaps.com/docs/howto/attach-multiple-photos-to-features/	https://merginmaps.com/docs/layer/photos/#how-to-attach-multiple-photos-to-one-feature/
 https://merginmaps.com/docs/howto/contribute/	https://merginmaps.com/docs/misc/get-involved/
 https://merginmaps.com/docs/howto/create-an-organization/	https://merginmaps.com/docs/manage/workspaces/
 https://merginmaps.com/docs/howto/create-project/	https://merginmaps.com/docs/manage/create-project/
@@ -140,7 +140,7 @@ https://merginmaps.com/docs/howto/manage/plugin/install/	https://merginmaps.com/
 https://merginmaps.com/docs/howto/manage/plugin/plugin-delete-project/	https://merginmaps.com/docs/manage/project-advanced/
 https://merginmaps.com/docs/howto/manage/plugin/plugin-new-project/	https://merginmaps.com/docs/manage/create-project/
 https://merginmaps.com/docs/howto/manage/plugin/plugin-sync-project/	https://merginmaps.com/docs/manage/plugin/
-https://merginmaps.com/docs/howto/manage/plugin/plugin-variables/	https://merginmaps.com/docs/layer/plugin-variables/
+https://merginmaps.com/docs/howto/manage/plugin/plugin-variables/	https://merginmaps.com/docs/layer/variables/
 https://merginmaps.com/docs/howto/manage/troubleshoot/	https://merginmaps.com/docs/misc/troubleshoot/
 https://merginmaps.com/docs/howto/manage/web/dashboard/	https://merginmaps.com/docs/manage/dashboard/
 https://merginmaps.com/docs/howto/manage/web/project-advanced/	https://merginmaps.com/docs/manage/project-advanced/
@@ -151,7 +151,7 @@ https://merginmaps.com/docs/howto/manage/web/web-create-project/	https://merginm
 https://merginmaps.com/docs/howto/manage/web/working-with-organisations/	https://merginmaps.com/docs/manage/workspaces/
 https://merginmaps.com/docs/howto/mergince/	https://merginmaps.com/docs/server/
 https://merginmaps.com/docs/howto/mergin-tour/	https://merginmaps.com/docs/tutorials/creating-a-project-in-qgis/
-https://merginmaps.com/docs/howto/position_variables/	https://merginmaps.com/docs/layer/position_variables/
+https://merginmaps.com/docs/howto/position_variables/	https://merginmaps.com/docs/layer/variables/
 https://merginmaps.com/docs/howto/proj/	https://merginmaps.com/docs/gis/proj/
 https://merginmaps.com/docs/howto/project/enable_browsing/	https://merginmaps.com/docs/gis/search_data/
 https://merginmaps.com/docs/howto/project/enable_digitising/	https://merginmaps.com/docs/gis/enable_digitising/
@@ -162,17 +162,23 @@ https://merginmaps.com/docs/howto/project/selective_sync/	https://merginmaps.com
 https://merginmaps.com/docs/howto/project/settingup_background_map/	https://merginmaps.com/docs/gis/settingup_background_map/
 https://merginmaps.com/docs/howto/project/settingup_forms/	https://merginmaps.com/docs/layer/form-widgets/
 https://merginmaps.com/docs/howto/project/settingup_forms_photo/	https://merginmaps.com/docs/layer/photos/
-https://merginmaps.com/docs/howto/project/settingup_forms_settings/	https://merginmaps.com/docs/layer/form-configuration/
+https://merginmaps.com/docs/howto/project/settingup_forms_settings/	https://merginmaps.com/docs/layer/overview/
 https://merginmaps.com/docs/howto/project/setup_themes/	https://merginmaps.com/docs/gis/setup_themes/
-https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/	https://merginmaps.com/docs/layer/non-spatial-data/
+https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/	https://merginmaps.com/docs/layer/overview/
 https://merginmaps.com/docs/howto/quick-start/	https://merginmaps.com/docs/tutorials/capturing-first-data/
 https://merginmaps.com/docs/howto/reuse_last_values/	https://merginmaps.com/docs/field/reuse-last-values/
 https://merginmaps.com/docs/howto/sign-up-to-mergin-maps/	https://merginmaps.com/docs/setup/sign-up-to-mergin-maps/
+https://merginmaps.com/docs/layer/attach-multiple-photos-to-features/	https://merginmaps.com/docs/layer/photos/#how-to-attach-multiple-photos-to-one-feature/
+https://merginmaps.com/docs/layer/best-practice/	https://merginmaps.com/docs/layer/overview/
 https://merginmaps.com/docs/layer/exif_metadata/	https://merginmaps.com/docs/layer/exif/
-https://merginmaps.com/docs/layer/working_with_nonspatial_data/	https://merginmaps.com/docs/layer/non-spatial-data/
+https://merginmaps.com/docs/layer/form-configuration/	https://merginmaps.com/docs/layer/overview/
+https://merginmaps.com/docs/layer/non-spatial-data/	https://merginmaps.com/docs/layer/overview/
+https://merginmaps.com/docs/layer/position_variables/	https://merginmaps.com/docs/layer/variables/
+https://merginmaps.com/docs/layer/plugin-variables/	https://merginmaps.com/docs/layer/variables/
 https://merginmaps.com/docs/layer/settingup_forms/	https://merginmaps.com/docs/layer/form-widgets/
 https://merginmaps.com/docs/layer/settingup_forms_photo/	https://merginmaps.com/docs/layer/photos/
-https://merginmaps.com/docs/layer/settingup_forms_settings/	https://merginmaps.com/docs/layer/form-configuration/
+https://merginmaps.com/docs/layer/settingup_forms_settings/	https://merginmaps.com/docs/layer/overview/
+https://merginmaps.com/docs/layer/working_with_nonspatial_data/	https://merginmaps.com/docs/layer/overview/
 https://merginmaps.com/docs/manage/data_sync/	https://merginmaps.com/docs/manage/plugin/
 https://merginmaps.com/docs/manage/project-details/	https://merginmaps.com/docs/manage/project-history/
 https://merginmaps.com/docs/manage/plugin-multi-server-use/	https://merginmaps.com/docs/server/plugin-mobile-app/

scripts/wordlist.txt

@@ -53,6 +53,7 @@ Geomax
 GEOS
 GeoPackage
 GeoPackages
+Geotagging
 GeoTIFF
 GeoPDF
 Gimp

src/.vitepress/sidebar/en.js

@@ -10,8 +10,7 @@ export default {
         { text: 'Using Mergin Maps Mobile App', link: '/tutorials/mobile/' },
         { text: 'Further Project Customisation', link: '/tutorials/further-project-customisation/' },
         { text: 'Working Collaboratively', link: '/tutorials/working-collaboratively/' }
-      ]
-    },
+      ] },
     {
       text: 'Install & Sign Up',   // required
       collapsed: true,
@@ -20,8 +19,7 @@ export default {
         { text: 'How to Sign Up to Mergin Maps', link: '/setup/sign-up-to-mergin-maps/' },
         { text: 'How to Install QGIS', link: '/setup/install-qgis/' },
         { text: 'How to Install Mergin Maps Plugin for QGIS', link: '/setup/install-mergin-maps-plugin-for-qgis/' }
-      ]
-    },
+      ] },
     {
       text: 'Manage Account & Project',   // required
       collapsed: true,
@@ -43,8 +41,7 @@ export default {
         { text: 'Webmaps', link: '/manage/dashboard-maps/' },
         { text: 'Project History and Versions', link: '/manage/project-history/' },
         { text: 'Selective Synchronisation', link: '/manage/selective_sync/' }
-      ]
-    },
+      ] },
     {
       text: 'Setup GIS Project',   // required
       collapsed: true,
@@ -59,26 +56,47 @@ export default {
         { text: 'How to Avoid Polygons Overlap', link: '/gis/avoid-overlap/' },
         { text: 'Custom Projections', link: '/gis/proj/' },
         { text: 'Supported Formats', link: '/gis/supported_formats/' }
-      ]
-    },
+      ] },
     {
-      text: 'Configure Survey Layer',   // required
+      text: 'Configure Forms',   // required
       collapsed: true,
       items: [
-        { text: 'Best Practice Tips for Layers and Forms', link: '/layer/best-practice/' },
-        { text: 'Setting Up Widgets in Attributes Form', link: '/layer/form-widgets/' },
-        { text: 'Attributes Form Configuration', link: '/layer/form-configuration/' },
-        { text: 'Attributes Form Layout', link: '/layer/form-layout/' },
-        { text: 'Capturing Photos', link: '/layer/photos/' },
-        { text: 'How to Attach Multiple Photos to Features', link: '/layer/attach-multiple-photos-to-features/' },
-        { text: 'How to Link Multiple Records to One Feature (1-N Relations)', link: '/layer/one-to-n-relations/' },
-        { text: 'Exif Metadata', link: '/layer/exif/' },
-        { text: 'How to Use Hyperlinks', link: '/layer/external-link/' },
-        { text: 'Working with Non-Spatial Tables', link: '/layer/non-spatial-data/' },
-        { text: 'Extra Position Variables', link: '/layer/position_variables/' },
-        { text: 'Extra QGIS Variables', link: '/layer/plugin-variables/' }
-      ]
-    },
+        { text: 'Overview', link: '/layer/overview/' },
+        { text: 'Widgets', link: '/layer/form-widgets/',
+        items: [
+           { text: 'Text', link: '/layer/text/' },
+           { text: 'Date and Time', link: '/layer/date-time/' },
+           { text: 'Relations', link: '/layer/relations/' },
+           { text: 'Numbers', link: '/layer/numbers/' },
+           { text: 'Checkbox', link: '/layer/checkbox/' },
+           { text: 'QR Code', link: '/layer/qr-code/' },
+           { text: 'Selecting Single or Multiple Values', link: '/layer/value-select/' },
+           { text: 'Photos', link: '/layer/photos/' },
+           { text: 'Informational Widgets', link: '/layer/info-widgets/' },
+        ] },
+        { text: 'Default Values', link: '/layer/default-values/',
+        collapsed: true,
+        items: [
+           { text: 'Geotagging', link: '/layer/exif/' },
+           { text: 'Variables', link: '/layer/variables/' }
+        ] },
+        { text: 'Constraints', link: '/layer/constraints/' },        
+        { text: 'Layout', link: '/layer/form-layout/',
+        collapsed: true,
+        items: [
+           { text: 'Tabs and Groups', link: '/layer/tabs-and-groups/' },
+           { text: 'Conditional Visibility', link: '/layer/conditional-visibility/' },
+        ] },
+        { text: 'Use Cases', link: '/layer/use-cases/', 
+        collapsed: true,
+        items: [
+	       { text: 'How to Open a File', link: '/layer/open-file/' },
+	       { text: 'How to Use Hyperlinks', link: '/layer/external-link/' },
+           { text: 'How to Open a Link to a Navigation App', link: '/layer/link-to-navigation/' },
+           { text: 'How to Link Multiple Records to One Feature (1-N Relations)', link: '/layer/one-to-n-relations/' },
+           { text: 'How to Embed an Image', link: '/layer/embed-image/' },
+        ] },
+      ] },
     {
       text: 'Fieldwork Tips',   // required
       collapsed: true,
@@ -97,8 +115,7 @@ export default {
         { text: 'How to Reuse Last Entered Values', link: '/field/reuse-last-values/' },
         { text: 'How to Stake Out Points', link: '/field/stake-out/' },
         { text: 'How to Fix a Broken Project', link: '/field/broken-project/' }
-      ]
-    },
+      ] },
     {
       text: 'For Developers',   // required
       collapsed: true,
@@ -110,8 +127,7 @@ export default {
         { text: 'Media Sync', link: '/dev/media-sync/' },
         { text: 'Work Packages', link: '/dev/work-packages/' },
         { text: 'Geodiff Library', link: '/dev/geodiff/' }
-      ]
-    },
+      ] },
     {
       text: 'Custom Server',   // required
       collapsed: true,
@@ -125,17 +141,15 @@ export default {
         { text: 'Administration Panel', link: '/server/dashboard/' },
         { text: 'Troubleshoot Custom Servers', link: '/server/troubleshoot/' },
         { text: 'Using Mergin Maps Mobile App and QGIS Plugin with a Custom Server', link: '/server/plugin-mobile-app/' }
-      ]
-    },
+      ] },
     {
       text: 'Migrate to Mergin Maps',   // required
       collapsed: true,
       items: [
         { text: 'Migrate from QField', link: '/migrate/qfield/' },
         { text: 'Migrate from ArcGIS', link: '/migrate/arcgis/' },
         { text: 'Migrate from FulcrumApp', link: '/migrate/fulcrumapp/' },
-      ]
-    },
+      ] },
     {
       text: 'Support & Legal',   // required
       collapsed: true,
@@ -145,9 +159,8 @@ export default {
         { text: 'Troubleshoot', link: '/misc/troubleshoot/',
         collapsed:true,
         items: [
-        { text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' },
-        ]        
-        },
+           { text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' },
+        ] },
         { text: 'Write Documentation', link: '/misc/write-docs/' }
       ]
     }

src/field/external_gps/index.md

@@ -10,7 +10,7 @@ description: External GPS receivers can be connected to your mobile device via B
 
 External GPS receivers can be connected to your mobile device via Bluetooth and used in <MobileAppName /> to achieve higher [GPS accuracy](../gps_accuracy/). 
 
-There are several [extra position variables](../../layer/position_variables/) that can be useful to record when doing the survey with external GPS, such as the GPS antenna height, GPS device name as well as metrics like horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).
+There are several [extra position variables](../../layer/variables/#position-variables) that can be useful to record when doing the survey with external GPS, such as the GPS antenna height, GPS device name as well as metrics like horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).
 
 Note that external GPS devices usually return orthometric heights (ellipsoid with the geoid separation applied).
 
@@ -33,7 +33,7 @@ If GPS antenna height is set to a non-zero value, it is also displayed next to t
 ![GPS antenna height setup in Mergin Maps mobile app](./mobile-app-gps-antenna-height.jpg "GPS antenna height setup in Mergin Maps mobile app")
 
 :::tip
-GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/position_variables/) `@position_gps_antenna_height` as a [default value](../../layer/form-configuration/#default-values).
+GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/variables/#position-variables) `@position_gps_antenna_height` as a [default value](../../layer/default-values/).
 :::
 
 ## External GPS on Android

src/field/gps_accuracy/index.md

@@ -19,7 +19,7 @@ Tapping the GPS button opens the [GPS info panel](../mobile-app-ui/#current-posi
 
 If you'd like to have higher accuracy, you can wait for your device to acquire a better GPS signal. For precise measurements, you may need to connect your device to an [external GPS](../external_gps/).
 
-When assessing the overall quality of the survey, it may be beneficial to record some [extra position variables](../../layer/position_variables/), such as type and name of the used GPS device, the horizontal and vertical accuracy or the horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP). 
+When assessing the overall quality of the survey, it may be beneficial to record some [position variables](../../layer/variables/#position-variables), such as type and name of the used GPS device, the horizontal and vertical accuracy or the horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP). 
 
 
 :::tip

src/field/layers/index.md

@@ -9,7 +9,7 @@ The **Layers** button is located in the bottom navigation panel.
 
 It provides the overview of layers and features in your <MainPlatformNameLink /> project in <MobileAppName />, as well as the option to turn the visibility of specific layers on/off or to see a layer's legend.
 
-![Layers in Mergin Maps mobile app](../../layer/non-spatial-data/mobile-app-non-spatial-layers.jpg "Layers in Mergin Maps mobile app")
+![Layers in Mergin Maps mobile app](./mobile-app-non-spatial-layers.jpg "Layers in Mergin Maps mobile app")
 
 ## Layers visibility