Initial commit

Author: th-e-o

.github/workflows/build_website.yml

@@ -0,0 +1,47 @@
+name: Build the website
+
+on:
+  push:
+    branches:
+      - main   # Triggers workflow on push to the main branch
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      # Step 1: Checkout the repository
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # Step 2: Install uv
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+          python-version: 3.12
+
+      - name: Restore environment
+        run: uv sync
+
+      # Step 3: Set up Quarto
+      - name: Set up quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+
+      # Step 4: Render Quarto in uv virtual environment (HTML)
+      - name: Render
+        run: uv run quarto render
+
+      # # Step 4b: Render Quarto in uv virtual environment (HTML)
+      # - name: Render in ipynb
+      #   run: uv run quarto render --to ipynb
+        
+      # Step 5: Publish website
+      - name: Publish to GitHub Pages (and render)
+        uses: quarto-dev/quarto-actions/publish@v2
+        with:
+          target: gh-pages
+          render: false

.gitignore

@@ -0,0 +1,53 @@
+_site/
+
+# History files
+.Rhistory
+.Rapp.history
+
+# Session Data files
+.RData
+.RDataTmp
+
+# User-specific files
+.Ruserdata
+
+# Example code in package build process
+*-Ex.R
+
+# Output files from R CMD build
+/*.tar.gz
+
+# Output files from R CMD check
+/*.Rcheck/
+
+# RStudio files
+.Rproj.user/
+
+# produced vignettes
+vignettes/*.html
+vignettes/*.pdf
+
+# OAuth2 token, see https://github.com/hadley/httr/releases/tag/v0.3
+.httr-oauth
+
+# knitr and R markdown default cache directories
+*_cache/
+/cache/
+
+# Temporary files created by R markdown
+*.utf8.md
+*.knit.md
+
+# R Environment Variables
+.Renviron
+
+# pkgdown site
+docs/
+
+# translation temp files
+po/*~
+
+# RStudio Connect folder
+rsconnect/
+
+/.quarto/

.python-version

@@ -0,0 +1 @@
+3.12

README.md

@@ -0,0 +1,8 @@
+# <img height="18" width="18" src="https://cdn.simpleicons.org/python/00ccff99" /> tutorial template for AIML4OS projects
+
+This repository provides a clean and modular template to build tutorials for projects in the **AIML4OS** project.
+
+## Usage
+
+➡️ See [this tutorial](https://aiml4os.github.io/training-material-starting-pack/) on how to customize and deploy this template.
+

_brand.yml

@@ -0,0 +1,5 @@
+logo: 
+  small: resources/profile/main3.png
+  medium: resources/profile/main3.png
+  large: resources/profile/main3.png
+

_extensions/quarto-ext/fontawesome/_extension.yml

@@ -0,0 +1,7 @@
+title: Font Awesome support
+author: Carlos Scheidegger
+version: 1.2.0
+quarto-required: ">=1.2.269"
+contributes:
+  shortcodes:
+    - fontawesome.lua