Skip to content

Commit 208e5de

Browse files
emmanuelknafoemmanuelknafo
committed
feat: add French translation of all workshop labs Translate index.md and all 10 lab files (lab-00 through lab-07-ado) to French under the fr/ directory. Add language switcher links between EN and FR versions. - Translated headings, prose, tips, notes, and table content - Preserved all code blocks, commands, URLs, and tool names - Fixed image paths and internal links for fr/ subdirectory - Added FR permalink prefixes in front matter Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 468b803 commit 208e5de

12 files changed

Lines changed: 2423 additions & 0 deletions

File tree

‎fr/index.md‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
layout: default
3+
title: Accueil
4+
nav_order: 0
5+
permalink: /fr/
6+
---
7+
8+
> 🇬🇧 **[English version](../)**
9+
10+
<p align="center">
11+
<img src="../assets/branding/logo-128.png" alt="Agentic Accelerator Framework" width="100">
12+
</p>
13+
14+
# Atelier d'analyse d'accessibilité
15+
16+
Bienvenue dans l'**Atelier d'analyse d'accessibilité** — un atelier pratique et progressif qui vous apprend à analyser les applications web pour détecter les violations d'accessibilité WCAG 2.2 à l'aide d'axe-core, IBM Equal Access et de vérifications personnalisées Playwright.
17+
18+
Tous les résultats sont normalisés au format [SARIF v2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) pour un reporting unifié dans GitHub Advanced Security ou Azure DevOps Advanced Security.
19+
20+
> [!NOTE]
21+
> Cet atelier fait partie de l'[Agentic Accelerator Framework](https://github.com/devopsabcs-engineering/agentic-accelerator-framework).
22+
23+
## Vue d'ensemble de l'architecture
24+
25+
```mermaid
26+
graph LR
27+
L00[Lab 00: Installation] --> L01[Lab 01: Applis démo]
28+
L01 --> L02[Lab 02: axe-core]
29+
L01 --> L03[Lab 03: IBM Equal Access]
30+
L01 --> L04[Lab 04: Vérif. custom]
31+
L02 --> L05[Lab 05: SARIF]
32+
L03 --> L05
33+
L04 --> L05
34+
L05 --> L06[Lab 06: GitHub Actions]
35+
L05 --> L06A[Lab 06-ado: ADO AdvSec]
36+
L06 --> L07[Lab 07: Remédiation]
37+
L06A --> L07A[Lab 07-ado: ADO Pipelines]
38+
```
39+
40+
## Prérequis
41+
42+
- Compte GitHub avec accès à Copilot
43+
- Node.js 20+
44+
- Docker Desktop
45+
- Abonnement Azure (uniquement pour la journée complète)
46+
- PowerShell 7+
47+
48+
Consultez le [Lab 00 : Prérequis](labs/lab-00-setup.md) pour les instructions d'installation détaillées.
49+
50+
## Ateliers
51+
52+
| # | Atelier | Durée | Niveau |
53+
|---|---------|-------|--------|
54+
| 00 | [Prérequis](labs/lab-00-setup.md) | 30 min | Débutant |
55+
| 01 | [Explorer les applis démo](labs/lab-01.md) | 25 min | Débutant |
56+
| 02 | [axe-core](labs/lab-02.md) | 35 min | Intermédiaire |
57+
| 03 | [IBM Equal Access](labs/lab-03.md) | 30 min | Intermédiaire |
58+
| 04 | [Vérifications Playwright personnalisées](labs/lab-04.md) | 35 min | Intermédiaire |
59+
| 05 | [Sortie SARIF](labs/lab-05.md) | 30 min | Intermédiaire |
60+
| 06 | [GitHub Actions](labs/lab-06.md) | 40 min | Avancé |
61+
| 06-ADO | [ADO Advanced Security](labs/lab-06-ado.md) | 35 min | Intermédiaire |
62+
| 07 | [Remédiation (GitHub)](labs/lab-07.md) | 45 min | Avancé |
63+
| 07-ADO | [Remédiation (ADO)](labs/lab-07-ado.md) | 50 min | Avancé |
64+
65+
## Programme de l'atelier
66+
67+
### Demi-journée (3 heures)
68+
69+
| Horaire | Activité |
70+
|---------|----------|
71+
| 0:00 – 0:30 | Lab 00 : Prérequis |
72+
| 0:30 – 0:55 | Lab 01 : Explorer les applis démo |
73+
| 0:55 – 1:30 | Lab 02 : axe-core |
74+
| 1:30 – 2:00 | Lab 03 : IBM Equal Access |
75+
| 2:00 – 2:15 | Pause |
76+
| 2:15 – 2:55 | Lab 06 : GitHub Actions (ou Lab 06-ADO) |
77+
78+
### Journée complète (6,5 heures)
79+
80+
| Horaire | Activité |
81+
|---------|----------|
82+
| 0:00 – 0:30 | Lab 00 : Prérequis |
83+
| 0:30 – 0:55 | Lab 01 : Explorer les applis démo |
84+
| 0:55 – 1:30 | Lab 02 : axe-core |
85+
| 1:30 – 2:00 | Lab 03 : IBM Equal Access |
86+
| 2:00 – 2:35 | Lab 04 : Vérifications Playwright personnalisées |
87+
| 2:35 – 2:50 | Pause |
88+
| 2:50 – 3:20 | Lab 05 : Sortie SARIF |
89+
| 3:20 – 4:00 | Lab 06 : GitHub Actions |
90+
| 4:00 – 4:35 | Lab 06-ADO : ADO Advanced Security |
91+
| 4:35 – 4:50 | Pause |
92+
| 4:50 – 5:35 | Lab 07 : Remédiation (GitHub) |
93+
| 5:35 – 6:25 | Lab 07-ADO : Remédiation (ADO) |
94+
95+
## Niveaux de prestation
96+
97+
| Niveau | Plateforme | Ateliers | Durée | Azure requis |
98+
| --- | --- | --- | --- | --- |
99+
| Demi-journée (GitHub) | GitHub | 00, 01, 02, 03, 06 | ~3 heures | Non |
100+
| Demi-journée (ADO) | ADO | 00, 01, 02, 03, 06-ado | ~3 heures | Oui |
101+
| Journée complète (GitHub) | GitHub | 00–05, 06, 07 | ~6,5 heures | Oui |
102+
| Journée complète (ADO) | ADO | 00–05, 06-ado, 07-ado | ~7 heures | Oui |
103+
| Journée complète (Double) | Les deux | 00–05, 06, 06-ado, 07, 07-ado | ~8,5 heures | Oui |
104+
105+
## Pour commencer
106+
107+
1. **Forkez ou utilisez ce modèle** pour créer votre propre instance d'atelier.
108+
2. Complétez le [Lab 00 : Prérequis](labs/lab-00-setup.md) pour configurer votre environnement.
109+
3. Suivez les ateliers dans l'ordre — chaque atelier s'appuie sur le précédent.
110+
111+
> **Astuce** : Cet atelier est conçu pour GitHub Codespaces. Cliquez sur **Code → Codespaces → New codespace** pour obtenir un environnement préconfiguré avec tous les outils installés.
112+
113+
## Dépôts associés
114+
115+
| Dépôt | Description |
116+
|-------|-------------|
117+
| [Agentic Accelerator Framework](https://github.com/devopsabcs-engineering/agentic-accelerator-framework) | Définitions d'agents, instructions, compétences et workflows CI/CD |
118+
| [Agentic Accelerator Workshop](https://devopsabcs-engineering.github.io/agentic-accelerator-workshop/) | Atelier pratique pour les agents Accelerator alimentés par l'IA |
119+
| [FinOps Scan Workshop](https://devopsabcs-engineering.github.io/finops-scan-workshop/) | Atelier d'analyse de gouvernance des coûts Azure |
120+
| [Code Quality Scan Workshop](https://devopsabcs-engineering.github.io/code-quality-scan-workshop/) | Atelier d'analyse de qualité du code |

‎fr/labs/lab-00-setup.md‎

Lines changed: 264 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,264 @@
1+
---
2+
permalink: /fr/labs/lab-00-setup
3+
title: "Lab 00 : Prérequis et configuration de l'environnement"
4+
description: "Configurez votre environnement avec tous les outils nécessaires pour l'analyse d'accessibilité WCAG 2.2."
5+
---
6+
7+
# Lab 00 : Prérequis et configuration de l'environnement
8+
9+
> [!NOTE]
10+
> Cet atelier fait partie du [Agentic Accelerator Framework](https://github.com/devopsabcs-engineering/agentic-accelerator-framework).
11+
12+
| | |
13+
|---|---|
14+
| **Durée** | 30 minutes |
15+
| **Niveau** | Débutant |
16+
| **Prérequis** | Aucun |
17+
18+
## Objectifs d'apprentissage
19+
20+
À la fin de ce lab, vous serez en mesure de :
21+
22+
- Forker et cloner le dépôt `accessibility-scan-demo-app`
23+
- Installer les outils requis (Node.js, Docker, GitHub CLI, Azure CLI, PowerShell 7+, Charm freeze)
24+
- Vérifier toutes les installations d'outils avec des contrôles de version
25+
- Installer les dépendances du scanner et les navigateurs Playwright
26+
- Démarrer le scanner d'accessibilité localement et confirmer son fonctionnement
27+
28+
## Exercices
29+
30+
### Exercice 0.1 : Forker et cloner les dépôts
31+
32+
Vous allez forker le dépôt du scanner afin d'avoir votre propre copie pour travailler.
33+
34+
1. Ouvrez un terminal (PowerShell 7+).
35+
36+
2. Forkez et clonez le dépôt du scanner à l'aide de GitHub CLI :
37+
38+
```bash
39+
gh repo fork devopsabcs-engineering/accessibility-scan-demo-app --clone
40+
```
41+
42+
3. Accédez au répertoire cloné :
43+
44+
```bash
45+
cd accessibility-scan-demo-app
46+
```
47+
48+
4. Vérifiez que le remote pointe vers votre fork :
49+
50+
```bash
51+
git remote -v
52+
```
53+
54+
Vous devriez voir votre nom d'utilisateur GitHub dans l'URL `origin`.
55+
56+
5. Forkez et clonez le dépôt de l'atelier :
57+
58+
```bash
59+
gh repo fork devopsabcs-engineering/accessibility-scan-workshop --clone
60+
```
61+
62+
> [!TIP]
63+
> Si vous n'avez pas encore installé GitHub CLI, vous l'installerez dans l'exercice suivant. Vous pouvez également forker via l'interface web GitHub et cloner manuellement avec `git clone`.
64+
65+
### Exercice 0.2 : Installer les outils requis
66+
67+
Vous allez installer les outils utilisés tout au long de l'atelier.
68+
69+
1. **Node.js 20+** — Téléchargez depuis [nodejs.org](https://nodejs.org/) ou installez via un gestionnaire de paquets :
70+
71+
```powershell
72+
# Windows
73+
winget install OpenJS.NodeJS.LTS
74+
```
75+
76+
```bash
77+
# macOS
78+
brew install node@20
79+
```
80+
81+
2. **Docker Desktop** — Téléchargez depuis [docker.com](https://www.docker.com/products/docker-desktop/) ou installez via un gestionnaire de paquets :
82+
83+
```powershell
84+
# Windows
85+
winget install Docker.DockerDesktop
86+
```
87+
88+
3. **GitHub CLI** — Installez le CLI `gh` :
89+
90+
```powershell
91+
# Windows
92+
winget install GitHub.cli
93+
```
94+
95+
```bash
96+
# macOS
97+
brew install gh
98+
```
99+
100+
4. **Azure CLI** — Installez `az` :
101+
102+
```powershell
103+
# Windows
104+
winget install Microsoft.AzureCLI
105+
```
106+
107+
```bash
108+
# macOS
109+
brew install azure-cli
110+
```
111+
112+
5. **PowerShell 7+** — Installez la dernière version de PowerShell :
113+
114+
```powershell
115+
# Windows
116+
winget install Microsoft.PowerShell
117+
```
118+
119+
```bash
120+
# macOS
121+
brew install powershell/tap/powershell
122+
```
123+
124+
6. **Charm freeze** — Installez l'outil de capture d'écran de terminal :
125+
126+
```powershell
127+
# Windows
128+
winget install charmbracelet.freeze
129+
```
130+
131+
```bash
132+
# macOS
133+
brew install charmbracelet/tap/freeze
134+
```
135+
136+
> [!TIP]
137+
> Sous Windows, exécutez ces commandes dans un terminal PowerShell avec élévation de privilèges. Redémarrez votre terminal après l'installation afin que les outils soient disponibles dans votre PATH.
138+
139+
### Exercice 0.3 : Vérifier les versions des outils
140+
141+
Vous allez exécuter des contrôles de version pour confirmer que chaque outil est correctement installé.
142+
143+
1. **Node.js :**
144+
145+
```bash
146+
node --version
147+
```
148+
149+
Sortie attendue : `v20.x.x` ou supérieure.
150+
151+
![Sortie de la version Node.js](../../images/lab-00/lab-00-node-version.png)
152+
153+
2. **Docker :**
154+
155+
```bash
156+
docker --version
157+
```
158+
159+
Sortie attendue : `Docker version 2x.x.x` ou supérieure.
160+
161+
![Sortie de la version Docker](../../images/lab-00/lab-00-docker-version.png)
162+
163+
3. **GitHub CLI :**
164+
165+
```bash
166+
gh --version
167+
```
168+
169+
![Sortie de la version GitHub CLI](../../images/lab-00/lab-00-gh-version.png)
170+
171+
4. **Azure CLI :**
172+
173+
```bash
174+
az --version
175+
```
176+
177+
![Sortie de la version Azure CLI](../../images/lab-00/lab-00-az-version.png)
178+
179+
5. **PowerShell :**
180+
181+
```powershell
182+
$PSVersionTable.PSVersion
183+
```
184+
185+
Sortie attendue : `7.x.x` ou supérieure.
186+
187+
![Sortie de la version PowerShell](../../images/lab-00/lab-00-pwsh-version.png)
188+
189+
6. **Charm freeze :**
190+
191+
```bash
192+
freeze --version
193+
```
194+
195+
![Sortie de la version Charm freeze](../../images/lab-00/lab-00-freeze-version.png)
196+
197+
> [!CAUTION]
198+
> Si un outil échoue au contrôle de version, résolvez le problème d'installation avant de continuer. Les labs suivants dépendent de la disponibilité de tous les outils.
199+
200+
### Exercice 0.4 : Installer les dépendances du scanner
201+
202+
Vous allez installer les dépendances Node.js et le navigateur Playwright requis par le scanner.
203+
204+
1. Accédez à la racine du dépôt du scanner :
205+
206+
```bash
207+
cd accessibility-scan-demo-app
208+
```
209+
210+
2. Installez les dépendances Node.js :
211+
212+
```bash
213+
npm install
214+
```
215+
216+
3. Installez le navigateur Chromium de Playwright :
217+
218+
```bash
219+
npx playwright install --with-deps chromium
220+
```
221+
222+
> [!NOTE]
223+
> Le téléchargement du navigateur Playwright fait environ 150 Mo. Ce navigateur est utilisé par le scanner pour afficher les pages et exécuter les vérifications d'accessibilité.
224+
225+
### Exercice 0.5 : Démarrer le scanner localement
226+
227+
Vous allez démarrer le scanner d'accessibilité et vérifier son fonctionnement.
228+
229+
1. Démarrez le scanner à l'aide du script de démarrage local :
230+
231+
```powershell
232+
./start-local.ps1
233+
```
234+
235+
Le script lance le serveur de développement Next.js sur le port 3000.
236+
237+
2. Ouvrez votre navigateur et accédez à :
238+
239+
```text
240+
http://localhost:3000
241+
```
242+
243+
3. Vérifiez que la page d'accueil du scanner se charge avec le formulaire d'analyse visible.
244+
245+
![Page d'accueil du scanner](../../images/lab-00/lab-00-scanner-home.png)
246+
247+
4. Laissez le scanner en cours d'exécution pour les labs suivants.
248+
249+
> [!TIP]
250+
> Si le port 3000 est déjà utilisé, arrêtez le processus en conflit ou exécutez d'abord `./stop-local.ps1`. Vous pouvez également démarrer le scanner avec Docker en utilisant `./start-local.ps1 -Mode docker`.
251+
252+
## Point de vérification
253+
254+
Avant de continuer, vérifiez :
255+
256+
- [ ] Dépôt forké et cloné localement
257+
- [ ] Les 6 outils installés et retournant une sortie de version (Node.js, Docker, gh, az, pwsh, freeze)
258+
- [ ] `npm install` terminé sans erreurs
259+
- [ ] Navigateur Chromium de Playwright installé
260+
- [ ] Scanner en cours d'exécution à `http://localhost:3000`
261+
262+
## Étapes suivantes
263+
264+
Passez au [Lab 01 : Explorer les applications de démonstration et les violations WCAG](lab-01.md).

0 commit comments

Comments
 (0)