Merge pull request #808 from m-kuhn/qfield

Add qfield docs

doc/overview/qfield_overview.rst

@@ -0,0 +1,80 @@
+:Author: Matthias Kuhn
+:License: Creative Commons Attribution 3.0 Unported (CC BY 3.0)
+
+@LOGO_qfield@
+@OSGEO_KIND_qfield@
+
+
+
+@NAME_qfield@
+================================================================================
+
+Mobile GIS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`QField for QGIS <https://qfield.org>`_ is a simplified touch optimized interface for QGIS in the field.
+It includes professional tools for data acquisition with surveying grade positioning
+device integration as well as support for a wide variety of advanced attribute
+capturing and mobile mapping functionalities.
+QField is available for Android, iOS, Linux, MacOS and Windows.
+
+It is perfectly integrated with :doc:`QGIS <qgis_overview>` and the development of the two projects
+collaborate closely.
+
+@SCREENSHOT_qfield@
+
+Core Features
+--------------------------------------------------------------------------------
+
+* Friendly graphical user interface:
+    * identify/select features
+    * edit/view/search attributes
+    * on the fly reprojection
+    * beautiful cartography
+    * photo and multimedia capturing
+    * live feedback on data quality via constraints
+
+* Easy Viewing of many Vector and Raster Formats
+    * most vector formats: including ESRI shapefiles, MapInfo, SDTS and GML, OpenStreetMap vectors
+    * raster formats such as digital elevation models, aerial photography or landsat imagery
+    * online web services: WMS, WFS and OGC API
+
+* Exporting data
+    * printing to pdf
+
+* Sensor integration
+    * internal positioning sensors (GNSS)
+    * external positioning sensors via NMEA (bluetooth, UDP, TPC)
+    * NTRIP correction (RTK) can be enabled dependening on the device
+    * external sensor integration (radiation, gas, ...)
+
+* Synchronization
+    * Data synchronization via `QFieldCloud <https://qfield.cloud>`
+
+Implemented Standards
+--------------------------------------------------------------------------------
+
+* OGC standards compliant (WMS, WFS, ... )
+
+Details
+--------------------------------------------------------------------------------
+
+**Website:** @WEB_qfield@
+
+**Licence:** GNU General Public License (GPL) version 2
+
+**Software Version:** |version-qfield|
+
+**Supported Platforms:** Windows, Linux, Mac, Unix, iOS, Android
+
+**Community Support:** https://docs.qfield.org/get-started/support/
+
+**Commercial Support:** https://docs.qfield.org/get-started/support/
+
+
+@VMDK_qfield@
+@QUICKSTART_qfield@
+
+.. presentation-note
+    QField, is a very popular user-friendly mobile GIS client which allows you to visualize and collect data in combination with QGIS. It supports numerous vector, raster and database formats.
+

doc/quickstart/qfield_quickstart.rst

@@ -0,0 +1,137 @@
+:Author: OSGeoLive
+:License: Creative Commons Attribution-ShareAlike 3.0 Unported  (CC BY-SA 3.0)
+
+@LOGO_qfield@
+@OSGEO_KIND_qfield@
+@VMDK_qfield@
+
+
+
+
+********************************************************************************
+@NAME_qfield@ Quickstart
+********************************************************************************
+
+QField is a powerful tool to collect data in the field for usage with QGIS.
+
+.. contents:: Contents
+   :local:
+
+
+Start QField
+============
+
+#. Click the menu button at the bottom left
+#. Click the QField icon in the Education menu
+
+    .. image:: /images/projects/qfield/00_menu.png
+      :scale: 70 %
+      :alt: Find QField in the menu
+
+You will see QField launch and show the changelog of the release.
+Close the screen by clicking on the arrow button on the top left.
+
+    .. image:: /images/projects/qfield/01_welcome_screen.png
+      :scale: 70 %
+      :alt: The changelog is shown once
+
+
+Open a project
+==============
+
+You can open any QGIS project with QField.
+
+#. Click the `Open local file` button
+#. Open the `qgis-examples` folder
+#. Click the `QGIS-Itasca-Example.qgz` project file to open the project
+
+    .. image:: /images/projects/qfield/02_open_project.png
+      :scale: 70 %
+      :alt: Choose the Itasca project to open
+
+Navigation
+==========
+
+You can navigate on the map by
+
+#. Pan: hold and drag the mouse cursor or by moving your finger on a touch screen
+#. Zoom: with the mouse wheel or with the zoom buttons. On a touch screen it is also possible to use pinch gestures
+#. Rotate: by holding the middle mouse button down or by rotating on the screen with two fingers on a touch screen
+
+Please keep in mind that the interaction design for QField was always done with touch screens in mind
+and is therefore best served on a touch screen.
+
+Basic canvas interaction
+========================
+
+You can identify features by clicking on them.
+In the itasca project, there are multiple layers identifiable, so you will get results from multiple layers, in this case here "airports" and "County Boundaries".
+
+To inspect the attributes of one of the features, click on the feature in the identification panel.
+You will see all attributes of this feature appear.
+
+    .. image:: /images/projects/qfield/03_identify.png
+      :scale: 70 %
+      :alt: The hamburger menu
+
+Legend
+======
+
+To see which layers are loaded and to inspect the layer legends, click the hamburger menu on the top left corner.
+
+    .. image:: /images/projects/qfield/04_hamburger_menu.png
+      :scale: 70 %
+      :alt: The hamburger menu
+
+You will see all layers in the project listed.
+By right clicking on the layer (or long pressing on a touch screen) you will have additional actions
+available for each layer.
+
+    .. image:: /images/projects/qfield/05_legend.png
+      :scale: 70 %
+      :alt: The legend
+
+Close the legend by clicking the white arrow on the top left or by clicking anywhere on the canvas
+outside the legend panel.
+
+Digitize Data
+=============
+
+By default, QField opens in read/view mode and you are not able to make any changes to preexisting geometries or add new features.
+To go into digitize mode:
+
+#. Click the hamburger menu on the top left corner, so you see the legend.
+#. Click the pencil switch to go into digitize mode.
+
+    .. image:: /images/projects/qfield/06_digitize_mode.png
+      :scale: 70 %
+      :alt: Switch to the digitize mode
+
+Next, we will create a new airport.
+
+#. Activate the airports layer by clicking on the `airports` layer. The current layer within which digitizing will occur is highlighted using a green background in the legend.
+#. Close the layer panel
+#. You will see a crosshair appear. This will follow your mouse or stay in the center of the screen if you are working with a touch screen.
+  #. If you have a mouse: click to create a new airport.
+  #. If you have a touchscreen, move the map until the crosshair is on the desired location and click the plus button at the bottom right of the screen to create a point.
+#. A panel appears, where you can enter all the desired attributes for the new airport
+#. Click the checkbox to confirm the new airport.
+#. The data is saved immediately.
+
+Things to try
+=============
+
+#. Show and hide a layer via the layer options (long click in the legend)
+#. On the legend panel, check the cog wheel symbol for more actions like measuring and printing
+#. Download the `QField sample projects`_ for more inspiration
+#. Open a project file in QGIS, add layers to it and change the configuration
+#. Install QField on your mobile device through the app store or via the `Download page`_.
+
+What next?
+==========
+
+To learn more about QField, a good starting point is the `Documentation page`_.
+
+.. _`Documentation page`: https://docs.qfield.org/
+.. _`Download page`: https://docs.qfield.org/get-started/
+.. _`QField sample projects`: https://docs.qfield.org/get-started/sample-projects/

projects_info.csv

@@ -10,6 +10,7 @@ Y | qgis | 3.22.7 | Y | Y | Desktop GIS | | | qgis | https://www.qgis.org/en/sit
 #   OSGeo Community | | | | | | | | | | | |
 #   Others  | | | | | | | | | | | |
 Y | openjump | 1.15.1 | Y | Y | Desktop GIS | | | openjump_gis | http://www.openjump.org | | OpenJUMP GIS | Y
+Y | qfield | 2.7.6 | Y | Y | Desktop GIS | | | qfield | https://qfield.org/ | | QField | N
 Y | saga | 7.3.0 | Y | Y | Desktop GIS | | | saga-gis | https://saga-gis.sourceforge.io/en/index.html | | SAGA | Y
 Y | udig | 2.0.0RC1 | Y | Y | Desktop GIS | | | udig | http://udig.refractions.net/ | | uDig | N
 ###################### | | | | | | | | | | | |