Merge branch 'dev' of https://github.com/edunumsec2/book into dev

Author: soniaagrebi

.github/ISSUE_TEMPLATE/suggestion-contenu.yml

@@ -8,7 +8,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        **Remarque**: pour les demandes plus complexes, nous vous invitons à dialoguer avec nous via [Discord](https://discord.gg/b8qu79t6HQ) ou sur [modulo-team@epfl.ch](mailto:modulo-team@epfl.ch).
+        **Remarque**: pour les demandes plus complexes, nous vous invitons à dialoguer avec nous via [Discord](https://discord.gg/b8qu79t6HQ) ou sur [contact@modulo-info.ch](mailto:contact@modulo-info.ch).
   - type: input
     id: page
     attributes:

.github/workflows/main.yml renamed to .github/workflows/deploy-dev.yml

@@ -1,36 +1,36 @@
-name: deploy-book
+name: deploy-book-dev
 
-# Only run this when the master branch changes
+# Only run this when the dev branch changes
 on: 
   push:
     branches: 
       - dev
 
-# This job installs dependencies, builds the book, and pushes it to `gh-pages`
+# This job installs dependencies, builds the book, and pushes it to FTP server
 jobs:
   deploy-book-appr:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
-    # Install dependencies
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
+    - name: Set up Python
+      uses: actions/setup-python@v5
       with:
-        python-version: 3.8
+        python-version: '3.13'
 
     - name: Install dependencies
       run: |
         pip install -r requirements.txt
       working-directory: .
-    # Build the book
+
     - name: Build the book
       run: |
         sphinx-build src/appr build -E
       working-directory: .
+
     # Push the book's HTML to Infomaniak FTP
     - name: 📂 Sync files
-      uses: SamKirkland/[email protected].0-beta
+      uses: SamKirkland/[email protected].5
       with:
         server: 31826.ftp.infomaniak.com
         username: 31826_elliot
@@ -41,26 +41,26 @@ jobs:
   deploy-book-ens:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
-    # Install dependencies
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
+    - name: Set up Python
+      uses: actions/setup-python@v5
       with:
-        python-version: 3.8
+        python-version: '3.13'
 
     - name: Install dependencies
       run: |
         pip install -r requirements.txt
       working-directory: .
-    # Build the book
+
     - name: Build the book
       run: |
         sphinx-build src/ens build -E
       working-directory: .
+
     # Push the book's HTML to Infomaniak FTP
     - name: 📂 Sync files
-      uses: SamKirkland/[email protected].0-beta
+      uses: SamKirkland/[email protected].5
       with:
         server: 31826.ftp.infomaniak.com
         username: 31826_elliot

.github/workflows/deploy.yml

@@ -0,0 +1,99 @@
+name: deploy-book-master
+
+# Only run this when the master branch changes
+on:
+  push:
+    branches:
+      - master
+
+# This job installs dependencies, builds the book, and pushes it to FTP server
+jobs:
+  deploy-landing-page:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'latest'
+
+      - name: Install dependencies
+        working-directory: ./landing-page
+        run: |
+          npm ci
+
+      - name: Build the landing page
+        working-directory: ./landing-page
+        run: |
+          npm run build
+
+      # Push the built files to Infomaniak FTP
+      - name: 📂 Sync files
+        uses: SamKirkland/[email protected]
+        with:
+          server: 31826.ftp.infomaniak.com
+          username: 31826_elliot
+          password: ${{ secrets.FTP_PASSWORD }}
+          local-dir: ./landing-page/public/
+          server-dir: web/
+
+  deploy-book-appr:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+      working-directory: .
+
+    - name: Build the book
+      run: |
+        sphinx-build src/appr build -E
+      working-directory: .
+
+    # Push the book's HTML to Infomaniak FTP
+    - name: 📂 Sync files
+      uses: SamKirkland/[email protected]
+      with:
+        server: 31826.ftp.infomaniak.com
+        username: 31826_elliot
+        password: ${{ secrets.FTP_PASSWORD }}
+        local-dir: ./build/
+        server-dir: sites/apprendre.modulo-info.ch/
+
+  deploy-book-ens:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+      working-directory: .
+
+    - name: Build the book
+      run: |
+        sphinx-build src/ens build -E
+      working-directory: .
+
+    # Push the book's HTML to Infomaniak FTP
+    - name: 📂 Sync files
+      uses: SamKirkland/[email protected]
+      with:
+        server: 31826.ftp.infomaniak.com
+        username: 31826_elliot
+        password: ${{ secrets.FTP_PASSWORD }}
+        local-dir: ./build/
+        server-dir: sites/enseigner.modulo-info.ch/

.gitignore

@@ -164,3 +164,11 @@ dmypy.json
 .pyre/
 edunum-sec2/content/theme/representation-information/representation-entiers/eleve.ipynb
 .eps
+
+# Node modules
+**/node_modules/
+**/.npm
+
+# Gatsby files
+**/.cache/
+**/public/

doc/migration-styles.md

@@ -0,0 +1,49 @@
+# Migration des balises de `sphinx-panels` vers `sphinx-design`
+
+Suite au passage vers Sphinx version 5, le système de `sphinx-panels` a été remplacé par `sphinx-design`.
+Ça implique des changements dans la creation des éléments du style dans les pages, notamment en ce qui concerne
+les tabs est les panels.
+
+Exemple pour illustration:
+
+```
+````{panels}
+:img-top: media/Usine_avant.jpeg
+
+**Usine du début du siècle dernier.** Les machines dans cette usine de métallurgie à Vallorbe dans le canton de Vaud sont au service des ouvriers. Source : https://wikivaud.ch/metallurgie-vaudoise/
+
+----
+:img-top: media/Usine_après.jpeg
+
+**Usine du début de ce siècle.** Les machines dans cette usine de montage Mistubishi en Chine ont remplacé les ouvriers. Source : https://www.lemonde.fr/blog/fredericjoignot/2015
+````
+```
+
+devient
+
+```
+:::::{grid} 1 2 2 2
+:gutter: 2
+
+::::{grid-item}
+:::{card}
+:img-top: media/Usine_avant.jpeg
+
+**Usine du début du siècle dernier.** Les machines dans cette usine de métallurgie à Vallorbe dans le canton de Vaud sont au service des ouvriers. Source : https://wikivaud.ch/metallurgie-vaudoise/
+
+:::
+::::
+
+::::{grid-item}
+:::{card}
+:img-top: media/Usine_après.jpeg
+
+**Usine du début de ce siècle.** Les machines dans cette usine de montage Mistubishi en Chine ont remplacé les ouvriers. Source : https://www.lemonde.fr/blog/fredericjoignot/2015
+
+:::
+::::
+:::::
+```
+
+Pour plus d'exemples, conslutez le commit `e836c1c185f2609cfaac950acc8c3aa05992444c` et sur la page de référence de
+[sphinx-design](https://sphinx-design.readthedocs.io/en/latest/).

landing-page/README.md

@@ -0,0 +1,89 @@
+<p align="center">
+    <img alt="Logo Modulo" src="https://user-images.githubusercontent.com/12733352/187911585-9ba02dd4-3eda-4102-bbaa-45e15bdb0473.png" width="300" />
+</p>
+<h1 align="center">
+  Site web
+</h1>
+
+Ce répertoire contient le code source pour le site informationnel Modulo, actuellement accessible sur [https://modulo-info.ch](https://modulo-info.ch/) et hébergé chez Infomaniak. Ce projet, complémentaire aux [ressources Modulo](https://github.com/edunumsec2/book), permet de communiquer plus largement les informations importantes liées à Modulo.
+
+## Technologies
+
+Le site est développé avec le framework JavaScript [Gatsby](https://www.gatsbyjs.com/) (v.4.0), les styles sont gérés par le framework CSS [Tailwind](https://tailwindcss.com/), tous les deux open source. De manière similaire à [Sphinx](https://www.sphinx-doc.org/en/master/) qui génère une documentation statique pour le projet principal, Gatsby génère des fichiers HTML/CSS/JS statiques permettant une très grande portabilité - aucune technologie spécifique n'est requise du côté du serveur.
+
+## 🚀 Installation
+
+1. **Pré-requis**
+
+   [**Visual Studio Code**](https://code.visualstudio.com/) ou n'importe quel éditeur de code de votre choix.
+
+   [**Node.js**](https://nodejs.org/en/download/) _(v.16.x.x LTS)_ nécessaire pour l'installation de Gatsby, permet à celui-ci de générer les fichiers statiques. Node permet également d'accéder au Node Package Manager (NPM) - outil similaire à pip pour Python.
+
+   ```shell
+   # pour vérifier si Node est installé
+   node --version # expected : v.16.x.x
+   ```
+
+   _Si la commande ne fonctionne pas, vous devez peut-être relancer un nouveau Terminal ou redémarrer la machine._
+
+   [**GitHub Desktop**](https://desktop.github.com/) **(recommandé)** pour cloner ce répertoire. GitHub Desktop fournit une interface graphique agréable d'utilisation pour Git, en gardant les choses simples puisqu'il enlève certaines complexités de Git (utilisation d'un agent ssh par exemple). Pour Ubuntu, voir [github_ubuntu_desktop.sh](https://gist.github.com/berkorbay/6feda478a00b0432d13f1fc0a50467f1).
+
+   _A la place de GitHub Desktop, vous pouvez aussi utiliser [Git](https://git-scm.com/downloads) via votre terminal, mais il faudra [se familiariser avec les commandes](https://rogerdudler.github.io/git-guide/), [générer une clé SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) et la [connecter à votre compte GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) pour pouvoir récupérer le projet._
+
+2. **Gatsby CLI**
+
+   Installer Gatsby Command Line Interface (CLI) via NPM. Gatsby CLI permettra d'exécuter les commandes de développement ou de build (voir [utilisation](#utilisation)).
+
+   ```shell
+   # install gatsby cli
+   npm install -g gatsby-cli
+   ```
+
+   ```shell
+   # check installation
+   gatsby --version # expected : Gatsby CLI version: 4.16.0
+   ```
+
+_Si vous êtes bloqués dans l'installation de Node, Git ou Gatsby CLI, vous pouvez trouver de l'aide supplémentaire [ici](https://www.gatsbyjs.com/docs/tutorial/part-0/)_.
+
+3. **Cloner le projet**
+
+   Via GitHub Desktop.
+
+   Ou alors via votre terminal :
+
+   ```shell
+
+   # aller dans votre répertoire de développement
+   cd my-dev-repository
+
+   # cloner le projet
+   git clone [email protected]:edunumsec2/modulo-website.git
+
+   ```
+
+4. **Installation des dépendances**
+
+   A la racine du projet, installer les [dépendances](https://github.com/edunumsec2/modulo-website/blob/master/package.json) :
+
+   ```shell
+
+   # aller dans le répertoire du projet
+   cd modulo-website
+
+   # installer les dépendances
+   npm install --force
+
+   ```
+
+## Utilisation
+
+todo (gatsby build, clean, develop)
+
+## Structure du projet
+
+todo
+
+## Ressources utiles
+
+todo

landing-page/gatsby-browser.js

@@ -0,0 +1 @@
+import "./src/global.css"

landing-page/gatsby-config.js

@@ -0,0 +1,35 @@
+module.exports = {
+  siteMetadata: {
+    title: `Modulo - Catalogue de ressources informatiques`,
+    description: `Apprendre et enseigner l'informatique au gymnase grâce à un contenu didactique.`,
+    author: `Centre LEARN - EPFL`,
+    siteUrl: `https://www.epfl.ch/education/educational-initiatives/center-learn/`,
+  },
+  plugins: [
+    `gatsby-plugin-no-sourcemaps`,
+    `gatsby-plugin-postcss`, // used by Tailwindcss
+    `gatsby-plugin-emotion`, // for Taliwindcss styling with styled-components
+    {
+      resolve: `gatsby-plugin-google-fonts`,
+      options: {
+        fonts: [`poppins\:200,300,400`],
+        display: "swap",
+      },
+    },
+    {
+      resolve: "gatsby-plugin-htaccess",
+      options: {
+        https: true,
+        SymLinksIfOwnerMatch: true,
+        host: "modulo-info.ch",
+        redirect: [
+          "RewriteRule ^not-existing-url/?$ /existing-url [R=301,L,NE]",
+          {
+            from: "edunumsec2.ch",
+            to: "modulo-info.ch",
+          },
+        ],
+      },
+    },
+  ],
+}