Merge branch 'main' of https://github.com/GIScience/gis-training-reso…

…urce-center

.github/workflows/deploy-book.yml

@@ -0,0 +1,42 @@
+name: deploy-book
+
+# Only run this when the master branch changes
+on:
+  push:
+    branches:
+    - main
+    # If your git repository has the Jupyter Book within some-subfolder next to
+    # unrelated files, you can make this run only if a file within that specific
+    # folder has been modified.
+    #
+    # paths:
+    # - some-subfolder/**
+
+# This job installs dependencies, builds the book, and pushes it to `gh-pages`
+jobs:
+  deploy-book:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+
+    # Install dependencies
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.8
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+
+    # Build the book
+    - name: Build the book
+      run: |
+        jupyter-book build .
+
+    # Push the book's HTML to github-pages
+    - name: GitHub Pages action
+      uses: peaceiris/[email protected]
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./_build/html

content/Modul_1/en_qgis_installation.md

@@ -9,6 +9,15 @@ For our introduction, the standalone installers from OSGeo4W packages are suffic
 
 [![QGIS 3.28 - installation and basic setup](/fig/image_QGIS_3.28_download.png)](https://www.youtube.com/watch?v=tSJMT96HsAo)
 
+or:
+
+<video width="100%" controls src="../../fig/QGIS_Installation.mp4">
+</video>
+
+
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/QGIS_Installation.mp4"></video>
+
+
 ## Windows
 
 ### 32 Bit or 64 Bit?

content/Modul_1/en_qgis_start.md

@@ -1,8 +1,11 @@
 # Getting started with QGIS
 
-## Intro QGIS concept
+**Competences:**
 
-### What is QGIS?
+- What is QGIS?
+- Introducing QGIS: Interface and further basic functionalities
+
+## What is QGIS?
 
 QGIS is an __open source geoinformation system software__. That means the source code is available for everyone, making QGIS a free application. 
 You may __view, edit, capture and analyze spatial data or create printable maps__ with it. QGIS was created in 2002 and is a project of volunteers. And it is __constantly changing__.
@@ -37,9 +40,10 @@ Toolbox
 
 6. __Locator bar__. Here you can __search for tools and layers__. If you don't know where to find a tool, you can try here.
 
-```{Tip}
-Exercise: Create a new QGIS project  
-```
+  <tagName>  <tagName>
+
+> **Exercise: Create a new QGIS project**  
+
   - In your “GIS_Training” folder, create a __subfolder__ called __“Projects”__
   - Open __QGIS__
   - Click on __New Empty Project__

content/Modul_1/en_qgis_theorie.md

@@ -1,5 +1,15 @@
 # What is GIS? (Theory)
 
+**Competences**
+
+- General Information
+- Why are Spatial Analyses important?
+- Introduction to GIS
+- A Galaxy of Tools
+- Paper Maps and Cartography
+- GIS vs Cartography
+- Web GIS Platforms
+
 ## General Information: 
 
 - A Geographic Information System (GIS) is a __digital system that connects data to maps__.
@@ -12,13 +22,11 @@
 
 ## Why are Spatial Analyses important?
 
-```{Note} 
-Discuss in groups:
-```
+> **Discuss in groups**  
+- Situations in which you benefitted from spatial analyses.
+- Situations in which you could may be have benefitted from spatial analyses.
+- Main areas where you see potential for spatial analyses in your work.
 
- - Situations in which you benefitted from spatial analyses.
- - Situations in which you could may be have benefitted from spatial analyses.
- - Main areas where you see potential for spatial analyses in your work.
 
 ## Introduction to GIS: 
 
@@ -39,10 +47,10 @@ GIS has many applications in the __humanitarian field__:
  - Support security decisions
  - Support operations planning
  - Identify areas most affected by disasters
-  
-```{Tip}
-A few examples:
-```
+
+  <tagName>  <tagName>
+
+> **A few examples:** 
 
  - [REACH Initiative](https://www.reachresourcecentre.info/search/)  
  - [World Food Programme (WFP)](https://hungermap.wfp.org/) 
@@ -56,24 +64,15 @@ GIS comes with a __galaxy of tools__ that are constantly evolving. An increasing
 
 ### An Overview: 
 
-- __Mobile Data Collection Tools__
-
-The latter make it possible to collect data via mobile or tablet, and often to visualize and exchange it with other platforms according to a common format.
-
--  __Mapping Tools__
-
-These tools provide a simple vizualisation of geographic data, and allow for the production of maps.
+| Name | Description |
+| --- | --- |
+| Mobile Data Collection Tools |The latter make it possible to collect data via mobile or tablet, and often to visualize and exchange it with other platforms according to a common format.|
+| Mapping Tools | These tools provide a simple vizualisation of geographic data, and allow for the production of maps.|
+|GIS Tools| As opposed to the previous ones, these more advanced tools are very comprehensive and allow for advanced analyses to be carried out on the geographical components of data.|
+| Webmapping Tools|These tools make it possible to manipulate and create maps online in a very simple way directly in a web browser. |
 
-- __GIS Tools__
 
-As opposed to the previous ones, these more advanced tools are very comprehensive and allow for advanced analyses to be carried out on the geographical components of data.
-
--  __Webmapping Tools__
-
-These tools make it possible to manipulate and create maps online in a very simple way directly in a web browser.
-
-
-## Paper Maps and Cartography 
+ ## Paper Maps and Cartography 
 
 ### What is Spatial Analysis?
 
@@ -82,7 +81,9 @@ These tools make it possible to manipulate and create maps online in a very simp
 - Data can be __added to a map as layers and they can interact with each other__. 
 - GIS enables you to work with these __layers__ to explore critically important questions and __find answers__ to those questions.
 
-#### An Example from the Past: John Snows' Cholera Map
+<tagName>  <tagName>
+
+> **An Example from the Past: John Snows' Cholera Map**  
 
 In 1854 an __outbreak of cholera__ occurred in London, England. The most common theory was that the disease was spread through the air. Dr.John Snow believed that the danger was __in the water__. He made a map to analyse the __number of deaths__ in Soho per house block. He added the __location of water pumps__ on the map.
 He found a __correlation__ between one specific water pump and the number of infections.
@@ -93,10 +94,10 @@ __Dr. Snow's map of the Cholera outbreak of 1854__, and the reports that it acco
 
 __Using GIS__, several measures of spatial central tendency have been applied to the dataset, revealing that the Spatial Mean (the geographic center of the distribution of deaths) of the outbreak lies __within 35 meters of the Broad Street Pump__, identified as the __source of contamination__ in the 1854 outbreak. 
 
+<tagName>  <tagName>
+
+> **Further information**:
 
-```{Tip}
-Further information:
-```
  - [Let’s explore John Snow’s map](https://www.arcgis.com/apps/PublicInformation/index.html?appid=d7deb67f810d46dfacb80ff80ac224e9)
 
 ## GIS vs Cartography

content/Modul_4/en_qgis_map_design_2.md

@@ -56,23 +56,37 @@ name: Add a new map
 ---
 Adding a new map to the Print Layout
 ```
-
+:::: {tab-set}
+::: {tab-item} Adding a new map
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_adding_a_new_map
+.mp4"></video>
+:::
+
+::: {tab-item} Moving and scaling the map
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_moving_and_scaling_the_map
+.mp4"></video>
+:::
+::::
 ### Adding a title or a text box
 
 A title should describe the phenomenen represented on the map.
 
 - To add text (title, explanations), use the __Add Label__ tool and draw a rectangle of the desired size.
 - In the __Item Properties__ panel (on the right of your screen) you can __enter your text__ and __change the font, style, colour, etc.__ (_Remember to use the scroll bar in the window to see all the options). 
 
-
-
 ```{figure} ../../fig/en_30.30.2_print_layout_add_text.png
 ---
 width: 750px
 name: Add text to the print layout
 ---
 Adding text to the print Layout
 ```
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_print_layout_adding_a_title
+.mp4"></video>
+
+### Adding an image
+
+VIDEO
 
 ### Adding a legend
 
@@ -95,6 +109,22 @@ Adding a legend to the print layout
 In the __item properties__ panel, if you keep the __'Auto update'__ option checked, new layers added to your project will automatically be added to the legend but you cannot control them individually (rename if necessary, reorder ot remove items).  
 Once the option is unchecked, you can update the name of the layers, group them, reorganise them, etc.
 
+:::: {tab-set}
+::: {tab-item} Adding a legend
+
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_adding_a_legend
+.mp4"></video>
+
+:::
+
+:::{tab-item} Editing the legend
+
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_editing_the_legend
+.mp4"></video>
+
+:::
+::::
+
 ### Adding a scale bar
 
 Before adding a scale bar, select your main map and check in the __Item Properties__ panel that the __Scale__ fielld has a __round number__ 
@@ -126,6 +156,9 @@ name: Add scale bar
 Add and customize the scale bar
 ```
 
+<video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/raw/main/fig/en_30.30.2_adding_a_scale_bar
+.mp4"></video>
+
 ### Adding an overview map
 
 Adding an overview map in the corner of your map will help locate the area you are viewing on the main map.
@@ -169,19 +202,33 @@ Add a the extent of the main map to your overview map (the red rectangle on the
 ```
 
 ``` {Caution}
-This method requires you to be sure that you are not going to modify the oveview map, as once the layers are locked, they will keep the style, and any updates will not affect the overview map
+This method requires you to be sure that you are not going to modify the oveview map, as once the layers are locked, they will keep the style, and any updates will not affect the overview map.
 ```
 
+## Exporting the print layout
+
+Once you are finished with the map composition, it is time to export export the print layout as a PDF or SVG file. 
+
+1. On the Toolbar click on the `Export as PDF`-button.
+2. Give the new file a name and select the location you want to save it.
+3. Click on `Save`.
+4. A new window "PDF Export Options" will open. Here you can adjust the compression algorithm. For the best results, select the lossless image compression. 
+5. Click `Save` again.
+6. A new green bar will pop up underneath the toolbars. Click on the file link to __review the exported map__.
+
+```{note}
+Make sure to check the map after exporting the PDF as some design elements might have changed in the exporting process.
+```
 
 # Good practices and common mistakes in mapping
 
 In order to produce good maps, there are some __basic rules__ to follow and common __semiological mistakes__ to avoid. 
 
-### Map composition
+## Map composition
 
-#### Key elements of a map
+### Key elements of a map
 
-A map is never complete without the following elements: 
+A map is __never complete without the following elements__: 
 - Title
 - Legend
 - Scale
@@ -237,7 +284,7 @@ name: scale bar
 ---
 A scale bar
 ``` 
-__Orientation__
+### Orientation
 
 Even if by default the majority of the maps are oriented to the North, it is still necessary to specify the orientation of the map. It is often indicated by an arrow to the North. Sometimes the orientation of different in order to optimize the representation of the study area on the map.
 
@@ -248,9 +295,9 @@ Any data represented on a map should have its sources indicated. This provides a
 It is possible to give the source of each data under the legend, or to do it in a dedicated space in the map. The level of precision of the sources varies according to the author or the precision of the data.
 
 
-### The 4 semiological errors
+## The 4 semiological errors
 
-#### 1. Proportional circles vs. solid colors
+### 1. Proportional circles vs. solid colors
 
 ```{caution}
 DO NOT represent __quantitative__ stock character/data with a __solid color__.
@@ -263,9 +310,10 @@ It is a mistake because:
 - You lose the __order relationship between the data__ (a circle can be twice as big as another one, a color cannot be "twice as dark")
 - Countries with a large surface area stand out visually (eg.: Russia in the example below)
 - We are trying to represent __data that has nothing to do with the area of a country__, but rather speaks of individual elements 
+
 >Add different example
 
-#### Color gradient vs. distinct color palette
+### 2. Color gradient vs. distinct color palette
 
 ```{caution}
 DO NOT use a __separate__ color palette to represent __ordered entities__
@@ -276,7 +324,7 @@ It is a mistake because:
 - By using a differentiating color variable, __you lose the ordinal relationship between entities__. Instead, a __gradient of the same color__ that should be used.
 - Different colors are used to differentiate between distinct entities.
 
-#### Gradient in a single color vs. Gradient between two colors
+### 3. Gradient in a single color vs. Gradient between two colors
 ```{Caution}
 DO NOT use a gradient across two colors for an always positive data.
 ```
@@ -291,7 +339,7 @@ It is a mistake because:
 - The map will send a message of divergence, of opposition between certain values, when we are simply trying to represent a hierarchy between values
 - In this way, the color itself directly indicates information about the trend (positive/negative or increasing/decreasing).
 
-#### Limited geometric symbols vs. complex icons and symbols
+### 4. Limited geometric symbols vs. complex icons and symbols
 ```{Caution}
 DO NOT use __too many symbols__ in a thematic map
 ```