Merge branch 'main' into fasterRaster_adam_smith

Author: petrasovaa

.github/workflows/pr-check.yml

@@ -32,6 +32,7 @@ jobs:
         with:
           packages:
             any::rmarkdown
+            any::reticulate
 
       - name: Set up Quarto
         uses: quarto-dev/quarto-actions/setup@v2

.github/workflows/publish.yml

@@ -31,6 +31,7 @@ jobs:
         with:
           packages:
             any::rmarkdown
+            any::reticulate
 
       - name: Set up Quarto
         uses: quarto-dev/quarto-actions/setup@v2

.gitignore

@@ -1,3 +1,6 @@
+# Quarto
+_freeze/
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]

CODE_OF_CONDUCT.md

@@ -0,0 +1,31 @@
+# Code of Conduct
+
+We value the participation of every member in our community and
+want to ensure that every contributor has an enjoyable experience.
+Accordingly, those who participate in the GRASS project are expected
+to show respect and courtesy to other community members at all times.
+
+GRASS uses the [NumFOCUS Code of Conduct (CoC)](https://numfocus.org/code-of-conduct).
+
+## The Short Version
+
+Be kind to others. Do not insult or put down others. Behave professionally.
+Remember that harassment and sexist, racist, or exclusionary jokes
+are not appropriate.
+
+All communication should be appropriate for a professional audience
+including people of many different backgrounds. Sexual language
+and imagery is not appropriate.
+
+GRASS and NumFOCUS are dedicated to providing a harassment-free community for everyone,
+regardless of gender, sexual orientation, gender identity and expression,
+disability, physical appearance, body size, race, or religion.
+We do not tolerate harassment of community members in any form.
+
+Thank you for helping make this a welcoming, friendly community for all.
+
+## Reporting
+
+If you feel that the Code of Conduct has been violated,
+submit a report directly to the NumFOCUS Code of Conduct Working Group by using
+[NumFOCUS Code of Conduct Reporting Form](https://numfocus.typeform.com/to/ynjGdT).

CONTRIBUTING.md

@@ -81,8 +81,8 @@ title: "Computing slope from elevation data in Python"
 author: "Your Name"
 date: "2025-05-15"
 description: "Learn how to derive slope from elevation data in GRASS in a Jupyter Notebook."
-categories: ["beginner", "geomorphometry", Python]
-thumbnail: slope_thumbnail.webp
+categories: [beginner, geomorphometry, Python]
+image: slope_thumbnail.webp
 format:
   ipynb: default
   html:
@@ -117,12 +117,47 @@ At the same time, their size should not be too big to load quickly, try to keep
 ```
 
 Each tutorial needs to have at least one image that can be used on the main page as a thumbnail.
-You can either specify it in the YAML header (`thumbnail: image.webp`) or add `{.preview-image}` to the image.
+You can either specify it in the YAML header (`image: image.webp`) or add `{.preview-image}` to the image.
 
 ``` markdown
 ![Slope map](slope.webp){.preview-image}
 ```
 
+## External tutorials
+
+If you want to have your GRASS external tutorials listed, you can create a `.yml` file
+within the `content/tutorials/external` folder with the tutorial(s) you want to include.
+See an example below:
+
+``` yaml
+- title: Species distribution modeling using Maxent in GRASS GIS
+  path: https://ecodiv.earth/TutorialsNotes/sdmingrassgis/
+  author: Paulo van Breugel
+  image: content/tutorials/external/images/sdm_in_grass_tutorialbanner.png
+  date: "2025-02-12"
+  description: Species distribution models to predict the current and future distribution of the Almond-eyed Ringlet.
+  categories: ['biogeography', 'ecology', 'intermediate', 'advanced']
+- title: Density distribution map of white-tailed deer
+  path: https://ecodiv.earth/TutorialsNotes/deerdensities/index.html
+  author: Paulo van Breugel
+  image: content/tutorials/external/images/deer-density-tile.png
+  date: "2025-01-10"
+  description: Habitat suitability map for the white-tailed deer using spatial multicriteria analysis and spatial disaggregation in GRASS.
+  categories: ['biogeography', 'MCDA', 'ecology', 'intermediate']
+```
+
+Then, you need to add the path to your `.yml` file in the header of the
+`index.qmd` file in the root directory.
+
+``` yaml
+contents: 
+  - content/tutorials    
+  - content/tutorials/external/your_tutorials.yml
+```
+
+Do not forget to also include the image that will be used as thumbnail within
+`content/tutorials/external/images`. 
+
 ## Submitting your contribution
 
 Check your markdown with a [linter](https://dlaa.me/markdownlint/) and fix as many issues as you can. This will help keeping the tutorials consistent.
@@ -134,5 +169,7 @@ Once you sumbmit a PR, the CI pipeline will build your
 tutorial, so you and a reviewer can check if everything is ok.
 When a reviewer approves, your PR will be merged soon.
 
+Please note that maintainers may make minor edits to improve clarity, consistency, or visual style.
+
 ---
 Thanks for helping us build better educational resources for the GRASS community!

FUNDING.yml

@@ -0,0 +1,2 @@
+---
+custom: ['https://numfocus.org/donate-to-grass']

README.md

@@ -18,6 +18,9 @@ written for OSGeo/grass repository, so just adjust it for this repository.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
 
+Please note that all contributors are expected to follow the [Code of Conduct](CODE_OF_CONDUCT.md)
+to ensure a respectful and inclusive environment.
+
 ## License
 
 The content in this repository is dual-licensed under the