chore(release): v0.0.4

Author: hadrien-toma

README.md

@@ -1,183 +1,183 @@
-# SophiaHackLab Documentation
+# Documentation SophiaHackLab
 
-This is the official documentation website for [SophiaHackLab](https://www.shl.contact/), a collaborative hackerspace for engineers, artists, scientists, and entrepreneurs located in Sophia-Antipolis, France.
+Le présent document constitue le site web officiel de documentation pour [SophiaHackLab](https://www.shl.contact/), un hackerspace collaboratif regroupant ingénieurs, artistes, scientifiques et entrepreneurs, situé à Sophia-Antipolis, France.
 
-Built with [Docusaurus](https://docusaurus.io/), a modern static website generator.
+Ce site est développé avec [Docusaurus](https://docusaurus.io/), un générateur de sites web statiques moderne.
 
-## Quick Start
+## Démarrage rapide
 
 ### Installation
 
 ```bash
 npm install
 ```
 
-### Local Development
+### Développement local
 
 ```bash
 npm start
 ```
 
-This command starts a local development server at `http://localhost:3000` and opens up a browser window. Most changes are reflected live without having to restart the server.
+Cette commande lance un serveur de développement local à l'adresse `http://localhost:3000` et ouvre une fenêtre de navigateur à cette adresse. La plupart des modifications sont reflétées instantanément sans nécessiter le redémarrage du serveur.
 
 ### Build
 
 ```bash
 npm run build
 ```
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+Cette commande génère le contenu statique dans le répertoire `build` et peut être déployée via tout service d'hébergement de contenu statique.
 
-## Testing
+## Tests
 
-We use [Playwright](https://playwright.dev/) for end-to-end testing across Chromium, Firefox, and WebKit browsers.
+[Playwright](https://playwright.dev/) est utilisé pour les tests de bout en bout (end-to-end) sur les navigateurs Chromium, Firefox et WebKit.
 
-### Run E2E Tests (Dev Server)
+### Exécution des tests E2E (serveur de développement)
 
-Run tests against the development server:
+Exécuter les tests sur le serveur de développement:
 
 ```bash
-npm start          # In one terminal
-npm run test:e2e   # In another terminal
+npm start          # Dans un premier terminal
+npm run test:e2e   # Dans un second terminal
 ```
 
-### Run Complete Test Suite (Production Build)
+### Exécution de la suite complète de tests (build de production)
 
-Build, serve, test, and generate reports in one command:
+Build, déploiement, tests et génération de rapports en une seule commande:
 
 ```bash
 npm run test:local
 ```
 
-This script will:
-1. Build the Docusaurus site
-2. Start a local production server
-3. Wait for the server to be ready
-4. Run Playwright e2e tests
-5. Generate JUnit XML and HTML reports
-6. Stop the server and display results
+Ce script exécute les opérations suivantes:
+1. Build du site Docusaurus
+2. Démarrage d'un serveur de production local
+3. Attente de la disponibilité du serveur
+4. Exécution des tests e2e Playwright
+5. Génération des rapports JUnit XML et HTML
+6. Arrêt du serveur et affichage des résultats
 
-**Test Reports:**
+**Rapports de tests:**
 - JUnit XML: `test-results/junit.xml`
-- HTML Report: `test-results/html/index.html`
+- Rapport HTML: `test-results/html/index.html`
 
-### View Test Reports
+### Visualisation des rapports de tests
 
-Open the HTML test report in your browser:
+Ouvrir le rapport de tests HTML dans votre navigateur:
 
 ```bash
 npm run test:report
 ```
 
-## Project Structure
+## Structure du projet
 
 ```
 .
-├── docs/                    # Documentation markdown files
-│   ├── intro.md            # Introduction page
-│   ├── contributing.md     # Contributing guide (in sidebar)
-│   ├── test-reports.md     # Test reports documentation
-│   └── projects/           # Project documentation
+├── docs/                   # Fichiers markdown de documentation
+│   ├── intro.md            # Page d'introduction
+│   ├── contributing.md     # Guide de contribution (dans la sidebar)
+│   ├── test-reports.md     # Documentation des rapports de tests
+│   └── projects/           # Documentation des projets
 │       ├── fete_de_la_science/
 │       ├── rov/
 │       └── triviak/
 │           ├── mini/
 │           └── real/
-├── blog/                   # Blog posts (3 SHL articles)
+├── blog/                   # Articles de blog
 │   ├── 2025-01-06-campagne-dons-2025.md
 │   ├── 2024-12-15-innovation-hackerspaces.md
 │   ├── 2025-01-05-open-talks-rust.md
-│   ├── authors.yml         # Blog authors
-│   └── tags.yml           # Blog tags
-├── src/                    # React components and pages
-├── static/                 # Static assets
-├── tests/                  # Playwright e2e tests
+│   ├── authors.yml         # Auteurs du blog
+│   └── tags.yml            # Tags du blog
+├── src/                    # Composants React et pages
+├── static/                 # Ressources statiques
+├── tests/                  # Tests e2e Playwright
 │   ├── homepage.spec.ts
 │   ├── sidebar.spec.ts
 │   └── projects.spec.ts
-├── scripts/                # Utility scripts
-│   └── test-local.sh      # Local testing script
-├── docusaurus.config.ts    # Docusaurus configuration
-├── playwright.config.ts    # Playwright configuration
-├── sidebars.ts            # Sidebar configuration (autogenerated)
-└── DEPLOYMENT.md           # Deployment instructions
+├── scripts/                # Scripts utilitaires
+│   └── test-local.sh       # Script de test local
+├── docusaurus.config.ts    # Configuration Docusaurus
+├── playwright.config.ts    # Configuration Playwright
+├── sidebars.ts             # Configuration de la sidebar (autogénérée)
+└── DEPLOYMENT.md           # Instructions de déploiement
 ```
 
-## Deployment
+## Déploiement
 
-### GitHub Pages (Automated)
+### GitHub Pages (automatisé)
 
-The site is automatically deployed to GitHub Pages when changes are pushed to the `main` branch via GitHub Actions.
+Le site est automatiquement déployé sur sur une GitHub Page lors des modifications poussées sur la branche `main` (via GitHub Actions).
 
-**Production URL:** https://sophiahacklab.github.io/docusaurus/
+**URL de production:** https://sophiahacklab.github.io/docusaurus/
 
-#### GitHub Actions Workflows
+#### Workflows GitHub Actions
 
-We use two automated workflows:
+Deux workflows automatisés:
 
-**1. Deploy Workflow** (`.github/workflows/deploy.yml`)
-- **Trigger:** Push to `main` branch
-- **Steps:**
-  1. Checkout code
-  2. Setup Node.js 20
-  3. Install dependencies
+**1. Workflow de déploiement** (`.github/workflows/deploy.yml`)
+- **Déclenchement:** Push sur la branche `main`
+- **Étapes:**
+  1. Checkout du code
+  2. Installation de Node.js 20
+  3. Installation des dépendances
   4. Build Docusaurus
-  5. Upload build artifact
-  6. Deploy to GitHub Pages
-- **Status:** [![Deploy](https://github.com/SophiaHackLab/docusaurus/actions/workflows/deploy.yml/badge.svg)](https://github.com/SophiaHackLab/docusaurus/actions/workflows/deploy.yml)
-
-**2. E2E Test Workflow** (`.github/workflows/test.yml`)
-- **Trigger:** Push to `main`, Pull requests, manual dispatch
-- **Steps:**
-  1. Checkout code
-  2. Setup Node.js 20 with npm cache
-  3. Install dependencies with `npm ci`
-  4. Install Playwright browsers with dependencies
+  5. Upload de l'artefact de build
+  6. Déploiement sur GitHub Pages
+- **Statut:** [![Deploy](https://github.com/SophiaHackLab/docusaurus/actions/workflows/deploy.yml/badge.svg)](https://github.com/SophiaHackLab/docusaurus/actions/workflows/deploy.yml)
+
+**2. Workflow de tests E2E** (`.github/workflows/test.yml`)
+- **Déclenchement:** Push sur `main`, Pull requests, déclenchement manuel
+- **Étapes:**
+  1. Checkout du code
+  2. Installation de Node.js 20 avec cache npm
+  3. Installation des dépendances via `npm ci`
+  4. Installation des navigateurs Playwright avec dépendances
   5. Build Docusaurus
-  6. Run Playwright tests with JUnit, HTML, and list reporters
-  7. Upload test results (JUnit XML and HTML)
-  8. Upload screenshots on failure
-  9. Publish test summary to GitHub
+  6. Exécution des tests Playwright avec reporters JUnit, HTML et list
+  7. Upload des résultats de tests (JUnit XML et HTML)
+  8. Upload des captures d'écran en cas d'échec
+  9. Publication du résumé des tests sur GitHub
 - **Timeout:** 15 minutes maximum
-- **Reports:** Available as GitHub Actions artifacts for 30 days
-- **Status:** [![Tests](https://github.com/SophiaHackLab/docusaurus/actions/workflows/test.yml/badge.svg)](https://github.com/SophiaHackLab/docusaurus/actions/workflows/test.yml)
+- **Rapports:** Disponibles en tant qu'artefacts GitHub Actions pendant 30 jours
+- **Statut:** [![Tests](https://github.com/SophiaHackLab/docusaurus/actions/workflows/test.yml/badge.svg)](https://github.com/SophiaHackLab/docusaurus/actions/workflows/test.yml)
 
-#### Repository Settings
+#### Paramètres du dépôt
 
-To enable GitHub Pages deployment:
+Les GitHub Pages sont activées (projet Open Source):
 
-1. Go to **Settings → Pages**
-2. Set **Source** to "GitHub Actions"
-3. The site will deploy automatically on the next push
+1. Accéder à **Settings → Pages**
+2. Définir **Source** sur "GitHub Actions"
+3. Le site sera déployé automatiquement au prochain push
 
-### Manual Deployment
+### Déploiement manuel (debug)
 
-Using SSH:
+Via SSH:
 
 ```bash
 USE_SSH=true npm run deploy
 ```
 
-Not using SSH:
+Sans SSH:
 
 ```bash
-GIT_USER=<Your GitHub username> npm run deploy
+GIT_USER=<Votre nom d'utilisateur GitHub> npm run deploy
 ```
 
 ## Configuration
 
-### Environment-Based URLs
+### URLs basées sur l'environnement
 
-The site uses environment-based configuration for URLs:
+Le site utilise une configuration d'URL basée sur l'environnement:
 
-- **Local Development:** `baseURL: '/'` at `http://localhost:3000`
-- **GitHub Pages:** `baseURL: '/docusaurus/'` at `https://sophiahacklab.github.io/docusaurus/`
+- **Développement local:** `baseURL: '/'` à `http://localhost:3000`
+- **GitHub Pages:** `baseURL: '/docusaurus/'` à `https://sophiahacklab.github.io/docusaurus/`
 
-This is automatically detected via the `BUILD_FOR_GITHUB_PAGES` environment variable.
+Cette configuration est détectée automatiquement via la variable d'environnement `BUILD_FOR_GITHUB_PAGES`.
 
-### Internationalization
+### Internationalisation
 
-The site is configured with French (fr) as the default locale:
+Le site est configuré en français (fr) comme locale par défaut:
 
 ```typescript
 i18n: {
@@ -186,10 +186,10 @@ i18n: {
 }
 ```
 
-### Theme Configuration
+### Configuration du thème
 
-**Forced Dark Mode:**
-The site uses a custom monochrome dark theme with color mode switching disabled:
+**Mode sombre forcé:**
+Le site utilise un thème sombre monochrome personnalisé avec commutation du mode couleur désactivée:
 
 ```typescript
 colorMode: {
@@ -199,14 +199,14 @@ colorMode: {
 }
 ```
 
-**Custom Styling:**
-- Ultra-minimal monochrome design with pure black (#000000) backgrounds
-- Maximum contrast with white/gray text
-- Custom CSS in `src/css/custom.css` for minimalist aesthetic
+**Stylisation personnalisée:**
+- Design monochrome ultra-minimaliste avec arrière-plans noir pur (#000000)
+- Contraste maximum avec texte blanc/gris
+- CSS personnalisé dans `src/css/custom.css` pour une esthétique minimaliste
 
-### Mermaid Diagram Support
+### Support des diagrammes Mermaid
 
-The site includes Mermaid diagram rendering capabilities via `@docusaurus/theme-mermaid`:
+Le site intègre des capacités de rendu de diagrammes Mermaid via `@docusaurus/theme-mermaid`:
 
 ```typescript
 themes: ['@docusaurus/theme-mermaid'],
@@ -215,51 +215,51 @@ markdown: {
 }
 ```
 
-You can create diagrams directly in markdown using mermaid code blocks.
+Il est possible de créer des diagrammes directement dans le markdown en utilisant des blocs de code mermaid.
 
 ### Sidebar
 
-The sidebar is automatically generated from the filesystem structure in the `docs/` directory. To customize the order:
+La sidebar est automatiquement générée à partir de la structure du système de fichiers dans le répertoire `docs/`. Pour personnaliser l'ordre:
 
-- Use `sidebar_position` in markdown frontmatter
-- Add `_category_.json` files in directories
-- See [Docusaurus sidebar docs](https://docusaurus.io/docs/sidebar)
+- Utiliser `sidebar_position` dans le frontmatter markdown
+- Ajouter des fichiers `_category_.json` dans les répertoires
+- Consulter la [documentation sidebar de Docusaurus](https://docusaurus.io/docs/sidebar)
 
-## Available Scripts
+## Scripts disponibles
 
 | Script | Description |
 |--------|-------------|
-| `npm start` | Start development server |
-| `npm run build` | Build for production |
-| `npm run serve` | Serve production build locally |
-| `npm run test:e2e` | Run Playwright e2e tests |
-| `npm run test:local` | Build, serve, test, and report |
-| `npm run test:report` | Open HTML test report |
-| `npm run clear` | Clear Docusaurus cache |
-| `npm run deploy` | Deploy to GitHub Pages |
+| `npm start` | Démarrer le serveur de développement |
+| `npm run build` | Build pour la production |
+| `npm run serve` | Servir le build de production localement |
+| `npm run test:e2e` | Exécuter les tests e2e Playwright |
+| `npm run test:local` | Build, servir, tester et générer un rapport |
+| `npm run test:report` | Ouvrir le rapport de tests HTML |
+| `npm run clear` | Effacer le cache Docusaurus |
+| `npm run deploy` | Déployer sur GitHub Pages |
 
 ## Blog
 
-The site includes 3 SHL-specific blog articles:
+Le site comprend 3 articles de blog spécifiques au SHL:
 
-- **2025 Donation Campaign** - Information about supporting SHL through donations
-- **Innovation in Hackerspaces** - How hackerspaces catalyze tech ecosystems
-- **Open Talks: Rust** - Event announcement for Rust presentation (January 14, 2025)
+- **Campagne de dons 2025** - Informations sur le soutien au SHL via les dons
+- **Innovation dans les hackerspaces** - Comment les hackerspaces catalysent les écosystèmes technologiques
+- **Open Talks: Rust** - Annonce d'événement pour la présentation Rust (14 janvier 2025)
 
-All blog posts feature SHL branding and are properly tagged for easy navigation.
+Tous les articles de blog comportent le branding SHL et sont correctement tagués pour une navigation facilitée.
 
-## Contributing
+## Contribuer
 
-Please read [CONTRIBUTING.md](./docs/contributing.md) for details on our code of conduct and the process for submitting pull requests.
+Veuillez consulter [CONTRIBUTING.md](./docs/contributing.md) pour les détails concernant notre code de conduite et le processus de soumission des pull requests.
 
-## About SophiaHackLab
+## À propos du SophiaHackLab
 
-SophiaHackLab is a community of engineers, artists, scientists, entrepreneurs, and other creative people who share a workspace and socialization space in Sophia-Antipolis, France.
+Le SophiaHackLab regroupe des ingénieurs, artistes, scientifiques, entrepreneurs et créatifs, qui partagent un espace de travail et de socialisation à Sophia-Antipolis, France.
 
-- **Website:** https://www.shl.contact/
-- **Location:** Space Antipolis, Building 9, Sophia-Antipolis
+- **Site web:** https://www.shl.contact/
+- **Localisation:** Space Antipolis, Bâtiment 9, Sophia-Antipolis
 - **Contact:** [email protected]
 
-## License
+## Licence
 
-This project documentation is maintained by SophiaHackLab.
+Cette documentation de projet est maintenue par le SophiaHackLab.