msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

chore(i18n): sync translations with latest source changes (chunk 1/1, 5 changes)

Browse Source
pull/1793/head
localizeflow[bot] 5 months ago
parent becbe773b0
commit 9841823f1c
5 changed files with 342 additions and 342 deletions
Show Stats Download Patch File Download Diff File

2
translations/en/.co-op-translator.json
Unescape View File

@ -487,7 +487,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:24:53+00:00", "translation_date": "2026-04-20T15:26:56+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "en" "language_code": "en"
}, },

2
translations/es/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:27:05+00:00", "translation_date": "2026-04-20T15:29:24+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "es" "language_code": "es"
}, },

310
translations/es/AGENTS.md
Unescape View File

@ -2,14 +2,14 @@
## Descripción del Proyecto ## Descripción del Proyecto
Este es un repositorio de currículo educativo para enseñar fundamentos del desarrollo web a principiantes. El currículo es un curso comprensivo de 12 semanas desarrollado por Microsoft Cloud Advocates, que cuenta con 24 lecciones prácticas cubriendo JavaScript, CSS y HTML. Este es un repositorio educativo para enseñar los fundamentos del desarrollo web a principiantes. El currículum es un curso integral de 12 semanas desarrollado por Microsoft Cloud Advocates, que incluye 24 lecciones prácticas sobre JavaScript, CSS y HTML.
### Componentes Clave ### Componentes Clave
- **Contenido Educativo**: 24 lecciones estructuradas organizadas en módulos basados en proyectos - **Contenido Educativo**: 24 lecciones estructuradas organizadas en módulos basados en proyectos
- **Proyectos Prácticos**: Terrarium, Juego de Mecanografía, Extensión de Navegador, Juego Espacial, Aplicación Bancaria, Editor de Código y Asistente de Chat con IA - **Proyectos Prácticos**: Terrarium, Juego de mecanografía, Extensión de navegador, Juego espacial, Aplicación bancaria, Editor de código y Asistente de chat con IA
- **Cuestionarios Interactivos**: 48 cuestionarios con 3 preguntas cada uno (evaluaciones pre/post-lección) - **Cuestionarios Interactivos**: 48 cuestionarios con 3 preguntas cada uno (evaluaciones pre y post lección)
- **Soporte Multilenguaje**: Traducciones automáticas para más de 50 idiomas mediante GitHub Actions - **Soporte Multilenguaje**: Traducciones automáticas en más de 50 idiomas vía GitHub Actions
- **Tecnologías**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para proyectos de IA) - **Tecnologías**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para proyectos de IA)
### Arquitectura ### Arquitectura
@ -18,11 +18,11 @@ Este es un repositorio de currículo educativo para enseñar fundamentos del des
- Cada carpeta de lección contiene README, ejemplos de código y soluciones - Cada carpeta de lección contiene README, ejemplos de código y soluciones
- Proyectos independientes en directorios separados (quiz-app, varios proyectos de lecciones) - Proyectos independientes en directorios separados (quiz-app, varios proyectos de lecciones)
- Sistema de traducción usando GitHub Actions (co-op-translator) - Sistema de traducción usando GitHub Actions (co-op-translator)
- Documentación servida via Docsify y disponible en formato PDF - Documentación servida vía Docsify y disponible en PDF
## Comandos de Configuración ## Comandos de Configuración
Este repositorio es principalmente para consumo de contenido educativo. Para trabajar con proyectos específicos: Este repositorio está principalmente para consumo de contenido educativo. Para trabajar con proyectos específicos:
### Configuración Principal del Repositorio ### Configuración Principal del Repositorio
@ -37,21 +37,21 @@ cd Web-Dev-For-Beginners
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Iniciar servidor de desarrollo npm run dev # Iniciar servidor de desarrollo
npm run build # Compilar para producción npm run build # Construir para producción
npm run lint # Ejecutar ESLint npm run lint # Ejecutar ESLint
``` ```
### API del Proyecto Bancario (Node.js + Express) ### API para Proyecto Bancario (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Iniciar el servidor API npm start # Iniciar servidor API
npm run lint # Ejecutar ESLint npm run lint # Ejecutar ESLint
npm run format # Formatear con Prettier npm run format # Formatear con Prettier
``` ```
### Proyectos de Extensión de Navegador ### Proyectos de Extensión para Navegador
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
@ -59,7 +59,7 @@ npm install
# Sigue las instrucciones específicas del navegador para cargar extensiones # Sigue las instrucciones específicas del navegador para cargar extensiones
``` ```
### Proyectos del Juego Espacial ### Proyectos de Juego Espacial
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -76,35 +76,35 @@ pip install openai
python api.py python api.py
``` ```
## Flujo de Trabajo de Desarrollo ## Flujo de Desarrollo
### Para Colaboradores de Contenido ### Para Contribuidores de Contenido
1. **Haz fork** del repositorio a tu cuenta de GitHub 1. **Hacer fork del repositorio** a tu cuenta de GitHub
2. **Clona tu fork** localmente 2. **Clonar tu fork** localmente
3. **Crea una nueva rama** para tus cambios 3. **Crear una nueva rama** para tus cambios
4. Realiza cambios en el contenido de las lecciones o ejemplos de código 4. Realizar cambios en contenido de lecciones o ejemplos de código
5. Prueba cualquier cambio de código en los directorios de proyecto relevantes 5. Probar cualquier cambio de código en los directorios de proyectos relevantes
6. Envía pull requests siguiendo las pautas de contribución 6. Enviar pull requests siguiendo las directrices de contribución
### Para Estudiantes ### Para Estudiantes
1. Haz fork o clona el repositorio 1. Hacer fork o clonar el repositorio
2. Navega secuencialmente por los directorios de lecciones 2. Navegar secuencialmente por los directorios de lecciones
3. Lee los archivos README de cada lección 3. Leer los archivos README de cada lección
4. Completa los cuestionarios previos en https://ff-quizzes.netlify.app/web/ 4. Completar cuestionarios pre-lección en https://ff-quizzes.netlify.app/web/
5. Trabaja con los ejemplos de código en las carpetas de lecciones 5. Trabajar con ejemplos de código en las carpetas de las lecciones
6. Completa las tareas y desafíos 6. Completar tareas y desafíos
7. Realiza los cuestionarios posteriores a la lección 7. Realizar cuestionarios post-lección
### Desarrollo en Vivo ### Desarrollo en Vivo
- **Documentación**: Ejecuta `docsify serve` en la raíz (puerto 3000) - **Documentación**: Ejecutar `docsify serve` en la raíz (puerto 3000)
- **Quiz App**: Ejecuta `npm run dev` en el directorio quiz-app - **Quiz App**: Ejecutar `npm run dev` en el directorio quiz-app
- **Proyectos**: Usa la extensión Live Server de VS Code para proyectos HTML - **Proyectos**: Usar extensión Live Server de VS Code para proyectos HTML
- **Proyectos API**: Ejecuta `npm start` en los directorios API respectivos - **Proyectos API**: Ejecutar `npm start` en los directorios API respectivos
## Instrucciones de Pruebas ## Instrucciones para Pruebas
### Pruebas de Quiz App ### Pruebas de Quiz App
@ -114,7 +114,7 @@ npm run lint # Verificar problemas de estilo de código
npm run build # Verificar que la compilación sea exitosa npm run build # Verificar que la compilación sea exitosa
``` ```
### Pruebas de Bank API ### Pruebas de API Bancaria
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -124,57 +124,57 @@ node server.js # Verificar que el servidor arranque sin errores
### Enfoque General para Pruebas ### Enfoque General para Pruebas
- Este es un repositorio educativo sin pruebas automatizadas exhaustivas - Este repositorio educativo no cuenta con pruebas automatizadas completas
- Las pruebas manuales se enfocan en: - Las pruebas manuales se centran en:
- Ejecución de ejemplos de código sin errores - Que los ejemplos de código se ejecuten sin errores
- Funcionamiento correcto de enlaces en la documentación - Que los enlaces en la documentación funcionen correctamente
- Compilación exitosa de proyectos - Que las compilaciones de proyectos finalicen sin errores
- Ejemplos que siguen las mejores prácticas - Que los ejemplos sigan las mejores prácticas
### Chequeos Previos a Envíos ### Chequeos Previo al Envío
- Ejecuta `npm run lint` en directorios con package.json - Ejecutar `npm run lint` en directorios con package.json
- Verifica que los enlaces de markdown sean válidos - Verificar que los enlaces en markdown sean válidos
- Prueba los ejemplos de código en navegador o Node.js - Probar ejemplos de código en navegador o Node.js
- Revisa que las traducciones mantengan la estructura correcta - Comprobar que las traducciones mantengan la estructura adecuada
## Guías de Estilo de Código ## Guías de Estilo de Código
### JavaScript ### JavaScript
- Usa sintaxis moderna ES6+ - Usar sintaxis moderna ES6+
- Sigue configuraciones estándar ESLint proporcionadas en proyectos - Seguir configuraciones standard de ESLint proporcionadas en proyectos
- Usa nombres significativos para variables y funciones para claridad educativa - Usar nombres significativos para variables y funciones para claridad educativa
- Añade comentarios explicando conceptos para los estudiantes - Añadir comentarios que expliquen conceptos para los estudiantes
- Formatea con Prettier donde esté configurado - Formatear usando Prettier donde esté configurado
### HTML/CSS ### HTML/CSS
- Elementos HTML5 semánticos - Elementos semánticos HTML5
- Principios de diseño responsivo - Principios de diseño responsivo
- Nomenclatura clara de clases - Convenciones claras de nombres de clases
- Comentarios que expliquen técnicas CSS para estudiantes - Comentarios que expliquen técnicas CSS para estudiantes
### Python ### Python
- Lineamientos de estilo PEP 8 - Guías de estilo PEP 8
- Código claro y educativo - Código claro y educativo
- Anotaciones de tipo cuando ayuden al aprendizaje - Anotaciones de tipo donde sean útiles para el aprendizaje
### Documentación Markdown ### Documentación en Markdown
- Jerarquía clara de encabezados - Jerarquía clara de encabezados
- Bloques de código con especificación de lenguaje - Bloques de código con especificación de lenguaje
- Enlaces a recursos adicionales - Enlaces a recursos adicionales
- Capturas y imágenes en directorios `images/` - Capturas de pantalla e imágenes en directorios `images/`
- Texto alternativo en imágenes para accesibilidad - Texto alternativo para imágenes para accesibilidad
### Organización de Archivos ### Organización de Archivos
- Lecciones numeradas secuencialmente (1-getting-started-lessons, 2-js-basics, etc.) - Lecciones numeradas secuencialmente (1-getting-started-lessons, 2-js-basics, etc.)
- Cada proyecto tiene directorios `solution/` y a menudo `start/` o `your-work/` - Cada proyecto tiene `solution/` y a menudo `start/` o `your-work/`
- Imágenes almacenadas en carpetas `images/` específicas por lección - Imágenes almacenadas en carpetas `images/` específicas por lección
- Traducciones en estructura `translations/{código-idioma}/` - Traducciones en la estructura `translations/{language-code}/`
## Construcción y Despliegue ## Construcción y Despliegue
@ -185,15 +185,15 @@ La quiz-app está configurada para despliegue en Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Crea la carpeta dist/ npm run build # Crea la carpeta dist/
# Despliega a través del flujo de trabajo de GitHub Actions al hacer push en main # Despliega mediante el flujo de trabajo de GitHub Actions al hacer push en main
``` ```
Configuración de Azure Static Web Apps: Configuración de Azure Static Web Apps:
- **Ubicación de la app**: `/quiz-app` - **Ubicación de la app**: `/quiz-app`
- **Ubicación de salida**: `dist` - **Ubicación de salida**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Flujo de trabajo**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generación de PDF de Documentación ### Generación de Documentación PDF
```bash ```bash
npm install # Instalar docsify-to-pdf npm install # Instalar docsify-to-pdf
@ -207,18 +207,18 @@ npm install -g docsify-cli # Instalar Docsify globalmente
docsify serve # Servir en localhost:3000 docsify serve # Servir en localhost:3000
``` ```
### Construcciones Específicas por Proyecto ### Compilaciones específicas de proyectos
Cada directorio de proyecto puede tener su propio proceso de build: Cada directorio de proyecto puede tener su propio proceso de compilación:
- Proyectos Vue: `npm run build` crea bundles de producción - Proyectos Vue: `npm run build` crea paquetes para producción
- Proyectos estáticos: Sin paso de construcción, se sirven archivos directamente - Proyectos estáticos: No tienen paso de compilación, se sirven archivos directamente
## Pautas para Pull Requests ## Directrices para Pull Requests
### Formato del Título ### Formato del Título
Usa títulos claros y descriptivos indicando el área del cambio: Usar títulos claros y descriptivos indicando la área de cambio:
- `[Quiz-app] Añadir nuevo quiz para la lección X` - `[Quiz-app] Añadir nuevo cuestionario para la lección X`
- `[Lesson-3] Corregir error tipográfico en proyecto terrarium` - `[Lesson-3] Corregir error tipográfico en proyecto terrarium`
- `[Translation] Añadir traducción al español para la lección 5` - `[Translation] Añadir traducción al español para la lección 5`
- `[Docs] Actualizar instrucciones de configuración` - `[Docs] Actualizar instrucciones de configuración`
@ -227,56 +227,56 @@ Usa títulos claros y descriptivos indicando el área del cambio:
Antes de enviar un PR: Antes de enviar un PR:
1. **Calidad de Código**: 1. **Calidad del código**:
- Ejecuta `npm run lint` en directorios de proyectos afectados - Ejecutar `npm run lint` en directorios afectados
- Corrige todos los errores y advertencias de linting - Corregir todos los errores y advertencias de linting
2. **Verificación de Build**: 2. **Verificación de compilación**:
- Ejecuta `npm run build` si aplica - Ejecutar `npm run build` si aplica
- Asegura que no haya errores de compilación - Asegurar que no hay errores en la compilación
3. **Validación de Enlaces**: 3. **Validación de enlaces**:
- Prueba todos los enlaces markdown - Probar todos los enlaces markdown
- Verifica que referencias a imágenes funcionen - Verificar referencias de imágenes
4. **Revisión del Contenido**: 4. **Revisión de contenido**:
- Revisa ortografía y gramática - Revisar ortografía y gramática
- Asegura que los ejemplos de código sean correctos y educativos - Asegurar que ejemplos de código sean correctos y educativos
- Verifica que las traducciones mantengan el significado original - Verificar que las traducciones mantengan el significado original
### Requisitos de Contribución ### Requisitos para Contribuir
- Aceptar el CLA de Microsoft (revisión automática en el primer PR) - Aceptar Microsoft CLA (verificación automática en primer PR)
- Seguir el [Código de Conducta de Código Abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/) - Seguir el [Código de Conducta de Código Abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Consultar [CONTRIBUTING.md](./CONTRIBUTING.md) para directrices detalladas - Consultar [CONTRIBUTING.md](./CONTRIBUTING.md) para directrices detalladas
- Referenciar números de issue en la descripción del PR si aplica - Referenciar números de issues en la descripción del PR si aplica
### Proceso de Revisión ### Proceso de Revisión
- PR revisados por mantenedores y comunidad - Los PR son revisados por mantenedores y la comunidad
- Se prioriza la claridad educativa - Se prioriza la claridad educativa
- Los ejemplos de código deben seguir las mejores prácticas actuales - Los ejemplos de código deben seguir mejores prácticas actuales
- Traducciones revisadas para precisión y adecuación cultural - Las traducciones se revisan para exactitud y adecuación cultural
## Sistema de Traducción ## Sistema de Traducción
### Traducción Automatizada ### Traducción Automática
- Usa GitHub Actions con workflow co-op-translator - Usa GitHub Actions con el workflow co-op-translator
- Traduce automáticamente a más de 50 idiomas - Traduce automáticamente a más de 50 idiomas
- Archivos fuente en directorios principales - Archivos fuente en directorios principales
- Archivos traducidos en directorios `translations/{código-idioma}/` - Archivos traducidos en `translations/{language-code}/`
### Agregar Mejoras Manuales a Traducciones ### Agregar Mejoras Manuales de Traducción
1. Ubica el archivo en `translations/{código-idioma}/` 1. Localizar archivo en `translations/{language-code}/`
2. Haz mejoras preservando la estructura 2. Mejorar manteniendo la estructura
3. Asegura que los ejemplos de código sigan funcionando 3. Asegurar que los ejemplos de código sigan funcionando
4. Prueba cualquier contenido localizado de cuestionarios 4. Probar cualquier cuestionario localizado
### Metadatos de Traducción ### Metadatos de Traducción
Los archivos traducidos incluyen encabezado con metadatos: Los archivos traducidos incluyen encabezado de metadatos:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Problemas Comunes ### Problemas Comunes
**Quiz app no arranca**: **La app de cuestionarios no arranca**:
- Verifica la versión de Node.js (recomendada v14+) - Verificar versión de Node.js (recomendada v14+)
- Elimina `node_modules` y `package-lock.json`, ejecuta `npm install` de nuevo - Eliminar `node_modules` y `package-lock.json`, ejecutar de nuevo `npm install`
- Revisa conflictos de puertos (por defecto: Vite usa el puerto 5173) - Revisar conflictos de puertos (por defecto: Vite usa puerto 5173)
**Servidor API no inicia**: **El servidor API no inicia**:
- Confirma que la versión de Node.js cumple el mínimo (node >=10) - Verificar que la versión de Node.js sea compatible (node >=10)
- Revisa si el puerto ya está en uso - Comprobar si el puerto está en uso
- Asegura que todas las dependencias estén instaladas con `npm install` - Asegurar que todas las dependencias estén instaladas con `npm install`
**Extensión de navegador no carga**: **La extensión del navegador no carga**:
- Verifica que manifest.json esté correctamente formateado - Verificar que el manifest.json esté bien formado
- Revisa la consola del navegador por errores - Revisar la consola del navegador para errores
- Sigue las instrucciones específicas de instalación para el navegador - Seguir instrucciones específicas del navegador para instalar extensiones
**Problemas con proyecto de chat en Python**: **Problemas con el proyecto de chat en Python**:
- Asegura que el paquete OpenAI esté instalado: `pip install openai` - Asegurar que el paquete OpenAI esté instalado: `pip install openai`
- Verifica que la variable de entorno GITHUB_TOKEN esté configurada - Verificar que la variable de entorno GITHUB_TOKEN esté configurada
- Revisa permisos de acceso a GitHub Models - Comprobar permisos de acceso a GitHub Models
**Docsify no sirve la documentación**: **Docsify no sirve la documentación**:
- Instala docsify-cli globalmente: `npm install -g docsify-cli` - Instalar docsify-cli globalmente: `npm install -g docsify-cli`
- Ejecuta desde el directorio raíz del repositorio - Ejecutar desde el directorio raíz del repositorio
- Confirma que existe `docs/_sidebar.md` - Confirmar que `docs/_sidebar.md` exista
### Consejos para el Entorno de Desarrollo ### Consejos para el Entorno de Desarrollo
- Usa VS Code con la extensión Live Server para proyectos HTML - Usar VS Code con extensión Live Server para proyectos HTML
- Instala extensiones ESLint y Prettier para formato consistente - Instalar extensiones ESLint y Prettier para formateo consistente
- Usa las DevTools del navegador para depurar JavaScript - Usar DevTools del navegador para depurar JavaScript
- Para proyectos Vue, instala la extensión de navegador Vue DevTools - Para proyectos Vue, instalar extensión Vue DevTools para navegador
### Consideraciones de Rendimiento ### Consideraciones de Rendimiento
- Gran cantidad de archivos traducidos (más de 50 idiomas) hace que los clones completos sean grandes - Gran cantidad de archivos traducidos (más de 50 idiomas) hace que clonaciones completas sean grandes
- Usa clonación superficial si solo trabajas con contenido: `git clone --depth 1` - Usar clonación superficial si solo se trabaja con contenido: `git clone --depth 1`
- Excluye traducciones de búsquedas cuando trabajes con contenido en inglés - Excluir traducciones de búsquedas al trabajar con contenido en inglés
- Los procesos de build pueden ser lentos en la primera ejecución (npm install, build con Vite) - Los procesos de compilación pueden ser lentos en la primera ejecución (npm install, compilación Vite)
## Consideraciones de Seguridad ## Consideraciones de Seguridad
### Variables de Entorno ### Variables de Entorno
- Las claves API nunca deberían ser comprometidas en el repositorio - Las claves API nunca deben subirse al repositorio
- Usa archivos `.env` (ya en `.gitignore`) - Usar archivos `.env` (ya incluidos en `.gitignore`)
- Documenta las variables de entorno requeridas en los README de proyectos - Documentar variables de entorno necesarias en los READMEs de los proyectos
### Proyectos Python ### Proyectos en Python
- Usa entornos virtuales: `python -m venv venv` - Usar entornos virtuales: `python -m venv venv`
- Mantén dependencias actualizadas - Mantener dependencias actualizadas
- Los tokens de GitHub deben tener permisos mínimos requeridos - Los tokens de GitHub deben tener permisos mínimos necesarios
### Acceso a GitHub Models ### Acceso a GitHub Models
- Se requieren Personal Access Tokens (PAT) para GitHub Models - Se requieren Tokens de Acceso Personal (PAT) para GitHub Models
- Guarda los tokens como variables de entorno - Los tokens deben almacenarse como variables de entorno
- Nunca cometas tokens ni credenciales - Nunca subir tokens o credenciales al repositorio
## Notas Adicionales ## Notas Adicionales
### Público Objetivo ### Público Objetivo
- Principiantes absolutos en desarrollo web - Principiantes completos en desarrollo web
- Estudiantes y autodidactas - Estudiantes y autodidactas
- Profesores usando el currículo en aulas - Profesores que usan el currículum en aulas
- Contenido diseñado para accesibilidad y desarrollo gradual de habilidades - Contenido diseñado para accesibilidad y desarrollo gradual de habilidades
### Filosofía Educativa ### Filosofía Educativa
- Enfoque de aprendizaje basado en proyectos - Enfoque basado en aprendizaje por proyectos
- Revisiones frecuentes de conocimientos (cuestionarios) - Chequeos frecuentes de conocimiento (cuestionarios)
- Ejercicios prácticos de codificación - Ejercicios prácticos de codificación
- Ejemplos de aplicación en el mundo real - Ejemplos de aplicaciones del mundo real
- Enfoque en fundamentos antes de frameworks - Enfoque en fundamentos antes que frameworks
### Mantenimiento del Repositorio ### Mantenimiento del Repositorio
- Comunidad activa de aprendices y colaboradores - Comunidad activa de aprendices y contribuyentes
- Actualizaciones regulares de dependencias y contenidos - Actualizaciones regulares en dependencias y contenido
- Monitoreo de issues y discusiones por mantenedores - Issues y discusiones monitoreadas por mantenedores
- Actualizaciones de traducción automatizadas mediante GitHub Actions - Actualizaciones de traducción automatizadas vía GitHub Actions
### Recursos Relacionados ### Recursos Relacionados
- [Módulos de Microsoft Learn](https://docs.microsoft.com/learn/) - [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)
- [Recursos del Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Recursos para estudiantes hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para estudiantes - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendices
- Cursos adicionales: Currículos de IA generativa, Ciencia de Datos, ML, IoT disponibles - Cursos adicionales: IA generativa, Ciencia de datos, ML, currículos IoT disponibles
### Trabajo con Proyectos Específicos ### Trabajo con Proyectos Específicos
Para instrucciones detalladas sobre proyectos individuales, consulta los archivos README en: Para instrucciones detalladas de proyectos individuales, consultar los archivos README en:
- `quiz-app/README.md` - aplicación de quiz en Vue 3 - `quiz-app/README.md` - aplicación de cuestionarios en Vue 3
- `7-bank-project/README.md` - aplicación bancaria con autenticación - `7-bank-project/README.md` - aplicación bancaria con autenticación
- `5-browser-extension/README.md` - desarrollo de extensión de navegador - `5-browser-extension/README.md` - desarrollo de extensión de navegador
- `6-space-game/README.md` - desarrollo de juego con canvas - `6-space-game/README.md` - desarrollo de juego en canvas
- `9-chat-project/README.md` - proyecto asistente de chat con IA - `9-chat-project/README.md` - proyecto de asistente de chat IA
### Estructura Monorepo ### Estructura Monorepo
Aunque no es un monorepo tradicional, este repositorio contiene múltiples proyectos independientes: Aunque no es un monorepo tradicional, este repositorio contiene múltiples proyectos independientes:
- Cada lección es autocontenida - Cada lección es autónoma
- Los proyectos no comparten dependencias - Los proyectos no comparten dependencias
- Trabaja en proyectos individuales sin afectar otros - Se puede trabajar en proyectos individuales sin afectar otros
- Clona el repositorio completo para la experiencia completa del currículo - Clonar el repositorio completo para experiencia completa del currículum
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Aviso legal**: **Descargo de responsabilidad**:
Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por lograr precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda la traducción profesional humana. No nos hacemos responsables de malentendidos o interpretaciones erróneas que surjan del uso de esta traducción. Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional humana. No nos hacemos responsables de malentendidos o interpretaciones erróneas derivadas del uso de esta traducción.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

2
translations/fr/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:26:01+00:00", "translation_date": "2026-04-20T15:28:11+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "fr" "language_code": "fr"
}, },

368
translations/fr/AGENTS.md
Unescape View File

@ -1,24 +1,24 @@
# AGENTS.md # AGENTS.md
## Aperçu du projet ## Présentation du projet
Il s'agit d'un référentiel de programme éducatif pour enseigner les fondamentaux du développement web aux débutants. Le programme est un cours complet de 12 semaines développé par les Microsoft Cloud Advocates, comprenant 24 leçons pratiques couvrant JavaScript, CSS et HTML. Il s'agit d'un référentiel de programme éducatif pour enseigner les fondamentaux du développement web aux débutants. Le programme est un cours complet de 12 semaines développé par les Microsoft Cloud Advocates, comprenant 24 leçons pratiques couvrant JavaScript, CSS et HTML.
### Composants clés ### Composants clés
- **Contenu éducatif** : 24 leçons structurées organisées en modules basés sur des projets - **Contenu éducatif** : 24 leçons structurées organisées en modules basés sur des projets
- **Projets pratiques** : Terrarium, jeu de frappe, extension de navigateur, jeu spatial, application bancaire, éditeur de code, et assistant de chat IA - **Projets pratiques** : Terrarium, Jeu de frappe, Extension de navigateur, Jeu spatial, Application bancaire, Éditeur de code, et Assistant de chat IA
- **Quiz interactifs** : 48 quiz avec 3 questions chacun (évaluations avant/après les leçons) - **Quiz interactifs** : 48 quiz avec 3 questions chacun (évaluations pré/post- leçon)
- **Support multilingue** : traductions automatisées en 50+ langues via GitHub Actions - **Support multilingue** : Traductions automatiques en 50+ langues via GitHub Actions
- **Technologies** : HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pour les projets IA) - **Technologies** : HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pour projets IA)
### Architecture ### Architecture
- Référentiel éducatif avec une structure basée sur les leçons - Référentiel éducatif avec structure basée sur les leçons
- Chaque dossier de leçon contient README, exemples de code et solutions - Chaque dossier de leçon contient README, exemples de code, et solutions
- Projets autonomes dans des répertoires séparés (quiz-app, divers projets de leçon) - Projets indépendants dans des répertoires séparés (quiz-app, divers projets de leçons)
- Système de traduction utilisant GitHub Actions (co-op-translator) - Système de traduction utilisant GitHub Actions (co-op-translator)
- Documentation servie via Docsify et disponible en PDF - Documentation servie via Docsify et disponible en PDF
## Commandes d'installation ## Commandes d'installation
@ -31,13 +31,13 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Installation de l’application Quiz (Vue 3 + Vite) ### Installation de l'application Quiz (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Démarrer le serveur de développement npm run dev # Démarrer le serveur de développement
npm run build # Compiler pour la production npm run build # Construire pour la production
npm run lint # Exécuter ESLint npm run lint # Exécuter ESLint
``` ```
@ -59,7 +59,7 @@ npm install
# Suivez les instructions spécifiques au navigateur pour le chargement des extensions # Suivez les instructions spécifiques au navigateur pour le chargement des extensions
``` ```
### Projets de jeux spatiaux ### Projets de jeu spatial
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Ouvrez index.html dans un navigateur ou utilisez Live Server # Ouvrez index.html dans un navigateur ou utilisez Live Server
``` ```
### Projet de chat (backend Python) ### Projet de chat (Backend Python)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -80,33 +80,33 @@ python api.py
### Pour les contributeurs de contenu ### Pour les contributeurs de contenu
1. **Forkez le référentiel** sur votre compte GitHub 1. **Forkez le référentiel** vers votre compte GitHub
2. **Clonez votre fork** localement 2. **Clonez votre fork** localement
3. **Créez une nouvelle branche** pour vos modifications 3. **Créez une nouvelle branche** pour vos modifications
4. Effectuez des modifications dans le contenu des leçons ou les exemples de code 4. Modifiez le contenu des leçons ou les exemples de code
5. Testez les modifications de code dans les répertoires de projets concernés 5. Testez les modifications de code dans les répertoires de projets concernés
6. Soumettez des pull requests selon les directives de contribution 6. Soumettez des pull requests en suivant les consignes de contribution
### Pour les apprenants ### Pour les apprenants
1. Forkez ou clonez le référentiel 1. Forkez ou clonez le référentiel
2. Naviguez séquentiellement dans les dossiers de leçon 2. Naviguez dans les dossiers de leçons dans l'ordre
3. Lisez les fichiers README pour chaque leçon 3. Lisez les fichiers README pour chaque leçon
4. Complétez les quiz avant la leçon à https://ff-quizzes.netlify.app/web/ 4. Complétez les quiz pré-leçon sur https://ff-quizzes.netlify.app/web/
5. Travaillez sur les exemples de code dans les dossiers des leçons 5. Travaillez les exemples de code dans les dossiers de leçons
6. Réalisez les devoirs et défis 6. Réalisez les devoirs et défis
7. Passez les quiz après la leçon 7. Passez les quiz post-leçon
### Développement en direct ### Développement en direct
- **Documentation** : lancez `docsify serve` à la racine (port 3000) - **Documentation** : Lancez `docsify serve` à la racine (port 3000)
- **Application Quiz** : lancez `npm run dev` dans le dossier quiz-app - **Application Quiz** : Lancez `npm run dev` dans le répertoire quiz-app
- **Projets** : utilisez l’extension Live Server de VS Code pour les projets HTML - **Projets** : Utilisez l’extension Live Server de VS Code pour les projets HTML
- **Projets API** : lancez `npm start` dans les répertoires API respectifs - **Projets API** : Lancez `npm start` dans les répertoires API concernés
## Instructions de test ## Instructions de test
### Test de l’application Quiz ### Test de l'application Quiz
```bash ```bash
cd quiz-app cd quiz-app
@ -114,7 +114,7 @@ npm run lint # Vérifier les problèmes de style de code
npm run build # Vérifier que la compilation réussit npm run build # Vérifier que la compilation réussit
``` ```
### Test de l’API bancaire ### Test de l'API bancaire
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -124,63 +124,63 @@ node server.js # Vérifiez que le serveur démarre sans erreurs
### Approche générale des tests ### Approche générale des tests
- Il s’agit d’un référentiel éducatif sans tests automatisés complets - Il s'agit d'un référentiel éducatif sans tests automatisés exhaustifs
- Les tests manuels se concentrent sur : - Les tests manuels portent sur :
- Exécution des exemples de code sans erreurs - Exécution des exemples de code sans erreurs
- Fonctionnement correct des liens dans la documentation - Fonctionnement correct des liens dans la documentation
- Succès des compilations des projets - Compilation réussie des projets
- Respect des bonnes pratiques dans les exemples - Respect des bonnes pratiques dans les exemples
### Vérifications avant soumission ### Vérifications avant soumission
- Lancez `npm run lint` dans les dossiers contenant package.json - Lancez `npm run lint` dans les dossiers contenant package.json
- Vérifiez que les liens markdown sont valides - Vérifiez la validité des liens markdown
- Testez les exemples de code dans un navigateur ou Node.js - Testez les exemples de code dans le navigateur ou Node.js
- Assurez-vous que les traductions conservent la structure correcte - Vérifiez que les traductions conservent la structure appropriée
## Directives de style de code ## Directives de style de code
### JavaScript ### JavaScript
- Utilisez la syntaxe moderne ES6+ - Utilisez la syntaxe moderne ES6+
- Suivez les configurations ESLint standard fournies dans les projets - Respectez les configurations ESLint standard fournies dans les projets
- Utilisez des noms de variables et de fonctions significatifs pour la clarté éducative - Utilisez des noms de variables et fonctions significatifs pour la clarté pédagogique
- Ajoutez des commentaires expliquant les concepts pour les apprenants - Ajoutez des commentaires expliquant les concepts pour les apprenants
- Formatez avec Prettier là où configuré - Formatez avec Prettier si configuré
### HTML/CSS ### HTML/CSS
- Éléments HTML5 sémantiques - Utilisez des éléments HTML5 sémantiques
- Principes de design responsive - Appliquez des principes de design responsive
- Conventions claires de nommage des classes - Nommez clairement les classes
- Commentaires expliquant les techniques CSS pour les apprenants - Ajoutez des commentaires expliquant les techniques CSS pour les apprenants
### Python ### Python
- Directives de style PEP 8 - Suivez les directives de style PEP 8
- Exemples de code clairs et éducatifs - Exemples de code clairs et pédagogiques
- Annotations de types là où c’est utile pour l’apprentissage - Indications de type lorsque cela aide l'apprentissage
### Documentation Markdown ### Documentation Markdown
- Hiérarchie claire des titres - Hiérarchie claire des titres
- Blocs de code avec spécification de langage - Blocs de code avec spécification du langage
- Liens vers des ressources supplémentaires - Liens vers des ressources complémentaires
- Captures d’écran et images dans les dossiers `images/` - Captures d’écran et images dans les dossiers `images/`
- Texte alternatif pour les images pour l’accessibilité - Texte alternatif pour les images pour l’accessibilité
### Organisation des fichiers ### Organisation des fichiers
- Leçons numérotées séquentiellement (1-getting-started-lessons, 2-js-basics, etc.) - Leçons numérotées séquentiellement (1-getting-started-lessons, 2-js-basics, etc.)
- Chaque projet a des dossiers `solution/` et souvent `start/` ou `your-work/` - Chaque projet a les dossiers `solution/` et souvent `start/` ou `your-work/`
- Images stockées dans des dossiers `images/` spécifiques aux leçons - Images stockées dans des dossiers `images/` spécifiques aux leçons
- Traductions dans la structure `translations/{language-code}/` - Traductions dans la structure `translations/{code-langue}/`
## Construction et déploiement ## Compilation et déploiement
### Déploiement de l’application Quiz (Azure Static Web Apps) ### Déploiement de l'application Quiz (Azure Static Web Apps)
L’application quiz est configurée pour un déploiement sur Azure Static Web Apps : L'application quiz-app est configurée pour le déploiement avec Azure Static Web Apps :
```bash ```bash
cd quiz-app cd quiz-app
@ -188,12 +188,12 @@ npm run build # Crée le dossier dist/
# Déploie via le workflow GitHub Actions lors d'un push sur main # Déploie via le workflow GitHub Actions lors d'un push sur main
``` ```
Configuration Azure Static Web Apps : Configuration Azure Static Web Apps :
- **Emplacement de l’appli** : `/quiz-app` - **Emplacement de l'application** : `/quiz-app`
- **Emplacement de sortie** : `dist` - **Emplacement de sortie** : `dist`
- **Workflow** : `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow** : `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Génération PDF de la documentation ### Génération du PDF de documentation
```bash ```bash
npm install # Installer docsify-to-pdf npm install # Installer docsify-to-pdf
@ -207,76 +207,76 @@ npm install -g docsify-cli # Installer Docsify globalement
docsify serve # Servir sur localhost:3000 docsify serve # Servir sur localhost:3000
``` ```
### Builds spécifiques par projet ### Builds spécifiques aux projets
Chaque répertoire de projet peut avoir son propre processus de build : Chaque répertoire de projet peut avoir son propre processus de build :
- Projets Vue : `npm run build` crée les bundles de production - Projets Vue : `npm run build` crée des bundles de production
- Projets statiques : pas d’étape de build, fichiers servis directement - Projets statiques : Pas d'étape de build, fichiers servis directement
## Directives des pull requests ## Directives pour les pull requests
### Format du titre ### Format du titre
Utilisez des titres clairs et descriptifs indiquant la zone de changement : Utilisez des titres clairs et descriptifs indiquant la zone modifiée :
- `[Quiz-app] Ajouter un nouveau quiz pour la leçon X` - `[Quiz-app] Ajout d’un nouveau quiz pour la leçon X`
- `[Lesson-3] Corriger une faute dans le projet terrarium` - `[Lesson-3] Correction d’une faute dans le projet terrarium`
- `[Translation] Ajouter la traduction espagnole pour la leçon 5` - `[Translation] Ajout de la traduction espagnole pour la leçon 5`
- `[Docs] Mettre à jour les instructions d’installation` - `[Docs] Mise à jour des instructions d’installation`
### Vérifications requises ### Vérifications requises
Avant de soumettre une PR : Avant de soumettre une PR :
1. **Qualité du code** : 1. **Qualité du code** :
- Lancez `npm run lint` dans les dossiers projets concernés - Lancez `npm run lint` dans les répertoires de projet concernés
- Corrigez toutes erreurs et avertissements de lint - Corrigez toutes les erreurs et avertissements de lint
2. **Vérification de build** : 2. **Vérification de build** :
- Lancez `npm run build` si applicable - Lancez `npm run build` si applicable
- Assurez-vous qu’il n’y a pas d’erreurs de build - Assurez-vous qu’aucune erreur de build ne survient
3. **Validation des liens** : 3. **Validation des liens** :
- Testez tous les liens markdown - Testez tous les liens markdown
- Vérifiez que les références aux images fonctionnent - Vérifiez le bon fonctionnement des références aux images
4. **Relecture du contenu** : 4. **Relecture du contenu** :
- Vérifiez l’orthographe et la grammaire - Corrigez l’orthographe et la grammaire
- Assurez-vous que les exemples de code sont corrects et pédagogiques - Assurez-vous que les exemples de code sont corrects et pédagogiques
- Vérifiez que les traductions conservent le sens original - Vérifiez que les traductions conservent le sens original
### Exigences de contribution ### Exigences de contribution
- Accepter la CLA Microsoft (vérification automatisée à la première PR) - Acceptez la CLA Microsoft (vérification automatique à la première PR)
- Suivre le [Code de Conduite Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/) - Respectez le [Code de conduite open source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Voir [CONTRIBUTING.md](./CONTRIBUTING.md) pour les directives détaillées - Consultez le [CONTRIBUTING.md](./CONTRIBUTING.md) pour les détails
- Référencer les numéros d’issues dans la description de la PR si applicable - Référencez les numéros d’issues dans la description de la PR si applicable
### Processus de revue ### Processus de relecture
- PRs examinées par les mainteneurs et la communauté - Les PR sont revues par les mainteneurs et la communauté
- La clarté éducative est priorisée - La clarté pédagogique est priorisée
- Les exemples de code doivent suivre les meilleures pratiques actuelles - Les exemples de code doivent suivre les bonnes pratiques actuelles
- Les traductions sont revues pour précision et adéquation culturelle - Les traductions sont revues pour précision et adéquation culturelle
## Système de traduction ## Système de traduction
### Traduction automatisée ### Traduction automatisée
- Utilise GitHub Actions avec le workflow co-op-translator - Utilise GitHub Actions avec le workflow co-op-translator
- Traduit automatiquement en 50+ langues - Traduit automatiquement en 50+ langues
- Fichiers source dans les répertoires principaux - Fichiers source dans les répertoires principaux
- Fichiers traduits dans les dossiers `translations/{language-code}/` - Fichiers traduits dans `translations/{code-langue}/`
### Ajout d’améliorations manuelles ### Ajout d’améliorations manuelles aux traductions
1. Localisez le fichier dans `translations/{language-code}/` 1. Localisez le fichier dans `translations/{code-langue}/`
2. Effectuez des améliorations en conservant la structure 2. Apportez des améliorations tout en préservant la structure
3. Assurez-vous que les exemples de code restent fonctionnels 3. Assurez-vous que les exemples de code restent fonctionnels
4. Testez tout contenu localisé de quiz 4. Testez tout contenu de quiz localisé
### Métadonnées des traductions ### Métadonnées des traductions
Les fichiers traduits incluent un en-tête de métadonnées : Les fichiers traduits incluent un en-tête de métadonnées :
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Problèmes courants ### Problèmes courants
**L’application quiz ne démarre pas** : **L’application quiz ne démarre pas** :
- Vérifiez la version de Node.js (v14+ recommandée) - Vérifiez la version de Node.js (v14+ recommandé)
- Supprimez `node_modules` et `package-lock.json`, lancez `npm install` à nouveau - Supprimez `node_modules` et `package-lock.json`, puis lancez `npm install` à nouveau
- Vérifiez les conflits de port (par défaut : Vite utilise le port 5173) - Vérifiez les conflits de ports (par défaut : Vite utilise le port 5173)
**Le serveur API ne démarre pas** : **Le serveur API ne démarre pas** :
- Vérifiez que la version de Node.js est suffisante (node >=10) - Vérifiez que Node.js est à la version minimale (node >=10)
- Vérifiez si le port est déjà utilisé - Vérifiez si le port est déjà utilisé
- Assurez-vous que toutes les dépendances sont installées avec `npm install` - Assurez-vous que toutes les dépendances sont installées via `npm install`
**L’extension de navigateur ne se charge pas** : **L’extension navigateur ne charge pas** :
- Vérifiez que manifest.json est correctement formaté - Vérifiez que manifest.json est bien formatté
- Contrôlez la console du navigateur pour les erreurs - Consultez la console du navigateur pour les erreurs
- Suivez les instructions d’installation spécifiques au navigateur - Suivez les instructions d’installation spécifiques au navigateur
**Problèmes avec le projet de chat Python** : **Problèmes du projet chat Python** :
- Assurez-vous que le package OpenAI est installé : `pip install openai` - Assurez-vous que le package OpenAI est installé : `pip install openai`
- Vérifiez que la variable d’environnement GITHUB_TOKEN est définie - Vérifiez que la variable d’environnement GITHUB_TOKEN est définie
- Vérifiez les autorisations d’accès aux modèles GitHub - Vérifiez les autorisations d’accès aux modèles GitHub
**Docsify ne sert pas la documentation** : **Docsify ne sert pas la documentation** :
- Installez docsify-cli globalement : `npm install -g docsify-cli` - Installez docsify-cli globalement : `npm install -g docsify-cli`
- Lancez depuis le répertoire racine du référentiel - Lancez depuis le répertoire racine du dépôt
- Vérifiez que `docs/_sidebar.md` existe - Vérifiez que `docs/_sidebar.md` existe
### Conseils pour l’environnement de développement ### Conseils pour l’environnement de développement
- Utilisez VS Code avec l’extension Live Server pour les projets HTML - Utilisez VS Code avec l’extension Live Server pour les projets HTML
- Installez les extensions ESLint et Prettier pour un formatage cohérent - Installez les extensions ESLint et Prettier pour un formatage cohérent
- Utilisez les DevTools du navigateur pour déboguer JavaScript - Utilisez les DevTools du navigateur pour déboguer JavaScript
- Pour les projets Vue, installez l’extension Vue DevTools pour navigateur - Pour les projets Vue, installez l’extension Vue DevTools pour navigateur
### Considérations de performance ### Considérations de performance
- Le grand nombre de fichiers traduits (50+ langues) rend les clones complets volumineux - Le grand nombre de fichiers traduits (50+ langues) rend les clones complets volumineux
- Utilisez un clone superficiel si vous travaillez uniquement sur le contenu : `git clone --depth 1` - Utilisez un clone superficiel si vous travaillez uniquement sur le contenu : `git clone --depth 1`
- Excluez les traductions des recherches lorsque vous travaillez sur le contenu anglais - Excluez les traductions des recherches quand vous travaillez sur le contenu anglais
- Les processus de build peuvent être lents au premier lancement (npm install, build Vite) - Les processus de build peuvent être lents lors de la première exécution (npm install, build Vite)
## Considérations de sécurité ## Considérations de sécurité
### Variables d’environnement ### Variables d’environnement
- Les clés API ne doivent jamais être commises dans le référentiel - Les clés API ne doivent jamais être commises dans le référentiel
- Utilisez des fichiers `.env` (déjà dans `.gitignore`) - Utilisez des fichiers `.env` (déjà dans `.gitignore`)
- Documentez les variables d’environnement requises dans les README des projets - Documentez les variables d’environnement requises dans les README projets
### Projets Python ### Projets Python
- Utilisez des environnements virtuels : `python -m venv venv` - Utilisez des environnements virtuels : `python -m venv venv`
- Maintenez les dépendances à jour - Gardez les dépendances à jour
- Les tokens GitHub doivent avoir les permissions minimales requises - Les tokens GitHub doivent avoir les permissions minimales nécessaires
### Accès aux modèles GitHub ### Accès aux modèles GitHub
- Les tokens d’accès personnel (PAT) sont requis pour les modèles GitHub - Tokens d’accès personnel (PAT) requis pour les modèles GitHub
- Les tokens doivent être stockés comme variables d’environnement - Les tokens doivent être stockés en variables d’environnement
- Ne jamais commettre les tokens ou les identifiants - Ne jamais commettre de tokens ou d’identifiants
## Notes supplémentaires ## Notes supplémentaires
### Public cible ### Public cible
- Débutants complets au développement web - Débutants complets au développement web
- Étudiants et autodidactes - Étudiants et autodidactes
- Enseignants utilisant le programme en classe - Enseignants utilisant le programme en classe
- Le contenu est conçu pour l’accessibilité et un apprentissage progressif - Contenu conçu pour l’accessibilité et le développement progressif des compétences
### Philosophie éducative ### Philosophie éducative
- Approche d’apprentissage par projet - Approche par projets
- Vérifications fréquentes des connaissances (quiz) - Vérifications fréquentes des connaissances (quiz)
- Exercices pratiques de codage - Exercices pratiques de programmation
- Exemples d’application dans des cas réels - Exemples d’applications réelles
- Focus sur les fondamentaux avant les frameworks - Focus sur les fondamentaux avant les frameworks
### Maintenance du référentiel ### Maintenance du référentiel
- Communauté active d’apprenants et de contributeurs - Communauté active d’apprenants et contributeurs
- Mises à jour régulières des dépendances et du contenu - Mises à jour régulières des dépendances et du contenu
- Suivi des issues et discussions par les mainteneurs - Surveillance des issues et discussions par les mainteneurs
- Mises à jour des traductions automatisées via GitHub Actions - Mises à jour de traductions automatisées via GitHub Actions
### Ressources connexes ### Ressources associées
- [Modules Microsoft Learn](https://docs.microsoft.com/learn/) - [Modules Microsoft Learn](https://docs.microsoft.com/learn/)
- [Ressources Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Ressources du Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recommandé pour les apprenants - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recommandé pour les apprenants
- Cours supplémentaires : IA générative, Data Science, ML, IoT disponibles - Cours additionnels : IA générative, Data Science, ML, IoT disponibles
### Travail avec des projets spécifiques ### Travailler avec des projets spécifiques
Pour des instructions détaillées sur les projets individuels, consultez les fichiers README dans : Pour des instructions détaillées sur les projets individuels, consultez les fichiers README dans :
- `quiz-app/README.md` - application de quiz Vue 3 - `quiz-app/README.md` - application quiz Vue 3
- `7-bank-project/README.md` - application bancaire avec authentification - `7-bank-project/README.md` - application bancaire avec authentification
- `5-browser-extension/README.md` - développement d’extension de navigateur - `5-browser-extension/README.md` - développement d’extension navigateur
- `6-space-game/README.md` - développement de jeu basé sur Canvas - `6-space-game/README.md` - développement de jeu Canvas
- `9-chat-project/README.md` - projet d’assistant de chat IA - `9-chat-project/README.md` - projet assistant chat IA
### Structure Monorepo ### Structure Monorepo
Bien que ce ne soit pas un monorepo traditionnel, ce référentiel contient plusieurs projets indépendants : Bien que ce ne soit pas un monorepo traditionnel, ce référentiel contient plusieurs projets indépendants :
- Chaque leçon est autonome - Chaque leçon est autonome
- Les projets ne partagent pas leurs dépendances - Les projets ne partagent pas de dépendances
- Travaillez sur des projets individuels sans impacter les autres - Travaillez sur des projets individuels sans impacter les autres
- Clonez le référentiel complet pour l’expérience du programme complet - Clonez le référentiel complet pour l’expérience complète du programme
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Avertissement** : **Avertissement** :
Ce document a été traduit à l’aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforçons d’assurer l’exactitude, veuillez noter que les traductions automatiques peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d’origine doit être considéré comme la source faisant autorité. Pour les informations critiques, une traduction professionnelle réalisée par un humain est recommandée. Nous ne sommes pas responsables des malentendus ou des erreurs d’interprétation résultant de l’utilisation de cette traduction. Ce document a été traduit à l’aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforcions d’assurer l’exactitude, veuillez noter que les traductions automatisées peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d’origine doit être considéré comme la source faisant autorité. Pour les informations critiques, une traduction professionnelle humaine est recommandée. Nous déclinons toute responsabilité en cas de malentendus ou d’interprétations erronées résultant de l’utilisation de cette traduction.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save