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, 6 changes)

Browse Source
pull/1793/head
localizeflow[bot] 2 weeks ago
parent c2abd5d528
commit ecd784c7ff
6 changed files with 393 additions and 393 deletions
Show Stats Download Patch File Download Diff File

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:48:10+00:00",
"translation_date": "2026-04-20T16:39:19+00:00",
"source_file": "AGENTS.md",
"language_code": "it"
},

224
translations/it/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Panoramica del Progetto
Questo è un repository curriculare educativo per insegnare le basi dello sviluppo web ai principianti. Il curriculum è un corso completo di 12 settimane sviluppato dai Microsoft Cloud Advocates, che presenta 24 lezioni pratiche che coprono JavaScript, CSS e HTML.
Questo è un repository didattico per insegnare le basi dello sviluppo web ai principianti. Il curriculum è un corso completo di 12 settimane sviluppato dai Microsoft Cloud Advocates, con 24 lezioni pratiche che coprono JavaScript, CSS e HTML.
### Componenti Chiave
- **Contenuti Educativi**: 24 lezioni strutturate organizzate in moduli basati su progetti
- **Progetti Pratici**: Terrario, Gioco di Digitazione, Estensione Browser, Gioco Spaziale, App Bancaria, Editor di Codice e Assistente Chat AI
- **Quiz Interattivi**: 48 quiz con 3 domande ciascuno (valutazioni pre/post lezione)
- **Supporto Multilingue**: Traduzioni automatizzate per oltre 50 lingue tramite GitHub Actions
- **Supporto Multilingue**: Traduzioni automatiche per oltre 50 lingue tramite GitHub Actions
- **Tecnologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (per progetti AI)
### Architettura
- Repository educativo con struttura basata sulle lezioni
- Ogni cartella lezione contiene README, esempi di codice e soluzioni
- Progetti autonomi in directory separate (quiz-app, vari progetti lezioni)
- Progetti indipendenti in directory separate (quiz-app, vari progetti delle lezioni)
- Sistema di traduzione usando GitHub Actions (co-op-translator)
- Documentazione servita tramite Docsify e disponibile in PDF
## Comandi di Setup
Questo repository è principalmente per il consumo di contenuti educativi. Per lavorare su progetti specifici:
Questo repository è principalmente per il consumo di contenuti educativi. Per lavorare con progetti specifici:
### Setup Principale del Repository
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Avvia il server di sviluppo
npm run build # Costruisci per la produzione
npm run build # Compila per la produzione
npm run lint # Esegui ESLint
```
@ -51,7 +51,7 @@ npm run lint # Esegui ESLint
npm run format # Format con Prettier
```
### Progetti Estensione Browser
### Progetti Estensioni Browser
```bash
cd 5-browser-extension/solution
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# Apri index.html nel browser oppure usa Live Server
# Apri index.html nel browser o usa Live Server
```
### Progetto Chat (Backend Python)
@ -76,37 +76,37 @@ pip install openai
python api.py
```
## Flusso di Lavoro per lo Sviluppo
## Flusso di Lavoro Sviluppo
### Per i Collaboratori di Contenuti
### Per i Contributori di Contenuti
1. **Forka il repository** nel tuo account GitHub
1. **Fai il fork del repository** sul tuo account GitHub
2. **Clona il tuo fork** localmente
3. **Crea un nuovo branch** per le tue modifiche
4. Modifica contenuti delle lezioni o esempi di codice
5. Testa eventuali modifiche al codice nelle directory dei progetti pertinenti
6. Invia pull request seguendo le linee guida per i contributi
4. Apporta modifiche ai contenuti della lezione o agli esempi di codice
5. Testa ogni modifica al codice nelle directory dei progetti rilevanti
6. Invia pull request seguendo le linee guida di contributo
### Per gli Studenti
1. Fork o clona il repository
2. Naviga nelle directory delle lezioni in sequenza
3. Leggi i file README di ogni lezione
1. Fai fork o clona il repository
2. Naviga sequenzialmente nelle directory delle lezioni
3. Leggi i file README per ogni lezione
4. Completa i quiz pre-lezione su https://ff-quizzes.netlify.app/web/
5. Lavora sugli esempi di codice nelle cartelle delle lezioni
6. Completa esercizi e sfide
7. Fai i quiz post-lezione
6. Completa compiti e sfide
7. Sostieni i quiz post-lezione
### Sviluppo in Diretta
### Sviluppo Live
- **Documentazione**: Esegui `docsify serve` nella root (porta 3000)
- **Quiz App**: Esegui `npm run dev` nella directory quiz-app
- **Progetti**: Usa l'estensione Live Server di VS Code per progetti HTML
- **Progetti API**: Esegui `npm start` nelle directory API rispettive
- **Progetti**: Usa l’estensione VS Code Live Server per progetti HTML
- **Progetti API**: Esegui `npm start` nelle rispettive directory API
## Istruzioni per il Testing
## Istruzioni per i Test
### Testing Quiz App
### Test Quiz App
```bash
cd quiz-app
@ -114,22 +114,22 @@ npm run lint # Controlla problemi di stile del codice
npm run build # Verifica che la compilazione abbia successo
```
### Testing Bank API
### Test API Bancaria
```bash
cd 7-bank-project/api
npm run lint # Verifica la presenza di problemi di stile del codice
npm run lint # Controlla problemi di stile del codice
node server.js # Verifica che il server si avvii senza errori
```
### Approccio Generale al Testing
### Approccio Generale ai Test
- Questo è un repository educativo senza test automatizzati completi
- Il testing manuale si concentra su:
- Esempi di codice eseguiti senza errori
- Link nella documentazione funzionanti correttamente
- Build dei progetti completate con successo
- Esempi che seguono le migliori pratiche
- Gli esempi di codice funzionano senza errori
- I link nella documentazione sono funzionanti
- Le build dei progetti completano con successo
- Gli esempi rispettano le best practice
### Controlli Pre-Invio
@ -144,53 +144,53 @@ node server.js # Verifica che il server si avvii senza errori
- Usa sintassi moderna ES6+
- Segui le configurazioni ESLint standard fornite nei progetti
- Usa nomi di variabili e funzioni significativi per chiarezza educativa
- Usa nomi significativi per variabili e funzioni per chiarezza didattica
- Aggiungi commenti che spiegano i concetti per gli studenti
- Formattta con Prettier ove configurato
- Formattta usando Prettier dove configurato
### HTML/CSS
- Elementi semantici HTML5
- Principi di design responsivo
- Convenzioni chiare per nomi di classi
- Convenzioni chiare per la nomenclatura delle classi
- Commenti che spiegano le tecniche CSS per gli studenti
### Python
- Linee guida di stile PEP 8
- Esempi di codice chiari e educativi
- Indicazioni di tipo dove utili per l’apprendimento
- Esempi di codice chiari e didattici
- Suggerimenti di tipo dove utili per l’apprendimento
### Documentazione Markdown
- Chiara gerarchia di intestazioni
- Blocchi di codice con specifica del linguaggio
- Gerarchia chiara delle intestazioni
- Blocchi di codice con specifica linguaggio
- Link a risorse aggiuntive
- Screenshot e immagini nelle cartelle `images/`
- Testo alternativo per immagini per accessibilità
- Testo alternativo per le immagini per accessibilità
### Organizzazione dei File
- Lezioni numerate progressivamente (1-getting-started-lessons, 2-js-basics, ecc.)
- Lezioni numerate sequenzialmente (1-getting-started-lessons, 2-js-basics, ecc.)
- Ogni progetto ha directory `solution/` e spesso `start/` o `your-work/`
- Immagini conservate in cartelle `images/` specifiche per la lezione
- Immagini archiviate nelle cartelle `images/` specifiche della lezione
- Traduzioni in struttura `translations/{language-code}/`
## Build e Distribuzione
## Build e Deployment
### Distribuzione Quiz App (Azure Static Web Apps)
### Deployment Quiz App (Azure Static Web Apps)
La quiz-app è configurata per distribuzione su Azure Static Web Apps:
La quiz-app è configurata per il deployment su Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Crea la cartella dist/
# Esegue il deploy tramite workflow di GitHub Actions al push sul ramo main
# Esegue il deploy tramite workflow di GitHub Actions al push su main
```
Configurazione Azure Static Web Apps:
- **Posizione app**: `/quiz-app`
- **Posizione output**: `dist`
- **Cartella output**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generazione PDF Documentazione
@ -211,72 +211,72 @@ docsify serve # Servi su localhost:3000
Ogni directory progetto può avere un proprio processo di build:
- Progetti Vue: `npm run build` crea bundle di produzione
- Progetti statici: nessun passaggio di build, servire file direttamente
- Progetti statici: nessun passaggio di build, servire i file direttamente
## Linee Guida per le Pull Request
### Formato del Titolo
Usa titoli chiari e descrittivi indicanti l’area di modifica:
- `[Quiz-app] Aggiungi nuovo quiz per la lezione X`
- `[Lesson-3] Correggi errore di battitura nel progetto terrario`
- `[Translation] Aggiungi traduzione spagnola per la lezione 5`
- `[Docs] Aggiorna istruzioni di setup`
Usa titoli chiari e descrittivi che indicano l’area di modifica:
- `[Quiz-app] Aggiunta nuovo quiz per la lezione X`
- `[Lesson-3] Correzione errore di battitura nel progetto terrario`
- `[Translation] Aggiunta traduzione spagnola per la lezione 5`
- `[Docs] Aggiornate istruzioni di setup`
### Controlli Richiesti
Prima di inviare una PR:
1. **Qualità del Codice**:
- Esegui `npm run lint` nelle directory progetto coinvolte
- Risolvi tutti gli errori e avvisi di linting
- Esegui `npm run lint` nelle directory dei progetti interessati
- Correggi tutti errori e avvisi di lint
2. **Verifica Build**:
- Esegui `npm run build` se applicabile
- Assicurati di non avere errori di build
- Assicurati che non ci siano errori di build
3. **Validazione Link**:
- Testa tutti i link markdown
- Verifica i riferimenti alle immagini
- Verifica riferimenti alle immagini
4. **Revisione Contenuti**:
- Correggi errori di ortografia e grammatica
- Assicurati che gli esempi di codice siano corretti ed educativi
- Controllo ortografia e grammatica
- Assicurati che gli esempi di codice siano corretti e didattici
- Verifica che le traduzioni mantengano il significato originale
### Requisiti per il Contributo
### Requisiti di Contributo
- Accetta il CLA Microsoft (controllo automatico alla prima PR)
- Accetta la Microsoft CLA (verifica automatica alla prima PR)
- Segui il [Codice di Condotta Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Consulta [CONTRIBUTING.md](./CONTRIBUTING.md) per linee guida dettagliate
- Riporta i numeri degli issue nella descrizione della PR se applicabile
- Consulta [CONTRIBUTING.md](./CONTRIBUTING.md) per dettagli
- Riferisci numeri di issue nella descrizione PR se appropriato
### Processo di Revisione
- Le PR sono revisionate da manutentori e comunità
- La chiarezza educativa è una priorità
- Le PR sono revisionate da maintainer e community
- Si dà priorità alla chiarezza didattica
- Gli esempi di codice devono seguire le migliori pratiche correnti
- Le traduzioni sono revisionate per accuratezza e adeguatezza culturale
- Le traduzioni sono riviste per accuratezza e adeguatezza culturale
## Sistema di Traduzione
### Traduzione Automatica
- Usa GitHub Actions con workflow co-op-translator
- Traduce automaticamente in più di 50 lingue
- Traduce automaticamente in oltre 50 lingue
- File sorgente nelle directory principali
- File tradotti nelle directory `translations/{language-code}/`
- File tradotti in directory `translations/{language-code}/`
### Aggiunta di Miglioramenti Manuali alle Traduzioni
### Aggiungere Miglioramenti Manuali
1. Trova il file in `translations/{language-code}/`
2. Effettua miglioramenti mantenendo la struttura
3. Assicurati che gli esempi di codice restino funzionanti
4. Testa eventuali quiz localizzati
2. Apporta miglioramenti preservando la struttura
3. Assicurati che gli esempi di codice rimangano funzionanti
4. Testa ogni contenuto quiz localizzato
### Metadati di Traduzione
### Metadata Traduzione
I file tradotti includono header di metadati:
I file tradotti includono header di metadata:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,68 +289,68 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Debugging e Risoluzione Problemi
## Debug e Risoluzione Problemi
### Problemi Comuni
**Quiz app non si avvia**:
- Controlla la versione di Node.js (consigliata v14+)
- Controlla versione Node.js (consigliata v14+)
- Cancella `node_modules` e `package-lock.json`, esegui di nuovo `npm install`
- Controlla conflitti di porta (default: Vite usa porta 5173)
**Server API non parte**:
- Verifica che la versione di Node.js sia minima (node >=10)
**Server API non si avvia**:
- Verifica che versione Node.js sia almeno (node >=10)
- Controlla se la porta è già in uso
- Assicurati che tutte le dipendenze siano installate con `npm install`
**Estensione browser non si carica**:
- Verifica che manifest.json sia formattato correttamente
- Verifica che manifest.json sia ben formato
- Controlla la console del browser per errori
- Segui le istruzioni di installazione specifiche per il browser
- Segui le istruzioni specifiche di installazione per il browser
**Problemi con progetto chat Python**:
- Assicurati che il pacchetto OpenAI sia installato: `pip install openai`
- Verifica che la variabile ambiente GITHUB_TOKEN sia impostata
- Controlla i permessi di accesso ai GitHub Models
- Controlla i permessi di accesso ai Modelli GitHub
**Docsify non serve la documentazione**:
- Installa docsify-cli globalmente: `npm install -g docsify-cli`
- Esegui dalla directory root del repository
- Controlla che esista `docs/_sidebar.md`
- Avvia dalla root del repository
- Verifica che `docs/_sidebar.md` esista
### Suggerimenti per l’Ambiente di Sviluppo
### Consigli Ambiente di Sviluppo
- Usa VS Code con estensione Live Server per progetti HTML
- Installa estensioni ESLint e Prettier per formattazione coerente
- Usa DevTools del browser per il debugging di JavaScript
- Usa gli strumenti DevTools del browser per il debug JavaScript
- Per progetti Vue, installa l’estensione Vue DevTools per browser
### Considerazioni sulle Prestazioni
- L’elevato numero di file tradotti (oltre 50 lingue) rende le clone complete grandi
- Usa clone superficiale se lavori solo sui contenuti: `git clone --depth 1`
- Gran numero di file tradotti (oltre 50 lingue) rende il clone completo pesante
- Usa clone shallow se lavori solo sui contenuti: `git clone --depth 1`
- Escludi le traduzioni dalle ricerche quando lavori solo su contenuti in inglese
- I processi di build possono essere lenti alla prima esecuzione (npm install, build Vite)
## Considerazioni sulla Sicurezza
## Considerazioni di Sicurezza
### Variabili d’Ambiente
- Le API key non devono mai essere immesse nel repository
- Usa file `.env` (già inclusi in `.gitignore`)
- Documenta le variabili d’ambiente richieste nei README dei progetti
- Le chiavi API non devono mai essere committate nel repository
- Usa file `.env` (già in `.gitignore`)
- Documenta variabili d’ambiente richieste nei README dei progetti
### Progetti Python
- Usa ambienti virtuali: `python -m venv venv`
- Mantieni le dipendenze aggiornate
- Mantieni aggiornate le dipendenze
- I token GitHub devono avere permessi minimi necessari
### Accesso a GitHub Models
### Accesso Modelli GitHub
- Sono necessari Personal Access Token (PAT) per GitHub Models
- I token vanno conservati come variabili d’ambiente
- Mai commitare token o credenziali
- Sono richiesti Personal Access Tokens (PAT) per i Modelli GitHub
- I token devono essere conservati come variabili ambiente
- Mai committare token o credenziali
## Note Aggiuntive
@ -359,50 +359,50 @@ CO_OP_TRANSLATOR_METADATA:
- Principianti completi nello sviluppo web
- Studenti e autodidatti
- Insegnanti che usano il curriculum in aula
- Contenuti progettati per accessibilità e costruzione graduale di competenze
- Contenuti progettati per accessibilità e sviluppo graduale delle competenze
### Filosofia Educativa
- Approccio basato su apprendimento via progetti
- Controlli frequenti della conoscenza (quiz)
- Approccio basato su progetti
- Verifiche di apprendimento frequenti (quiz)
- Esercizi pratici di coding
- Esempi di applicazione reale
- Focus sui fondamenti prima dei framework
- Esempi di applicazioni reali
- Focus sulle basi prima dei framework
### Manutenzione del Repository
- Comunità attiva di studenti e collaboratori
- Comunità attiva di studenti e contributori
- Aggiornamenti regolari di dipendenze e contenuti
- Monitoraggio di issue e discussioni da parte dei manutentori
- Aggiornamenti traduzione automatizzati tramite GitHub Actions
- Issue e discussioni monitorate dai maintainer
- Aggiornamenti alle traduzioni automatici via GitHub Actions
### Risorse Correlate
- [Moduli Microsoft Learn](https://docs.microsoft.com/learn/)
- [Risorse Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) consigliato per studenti
- Corsi aggiuntivi: curricula Generative AI, Data Science, ML, IoT disponibili
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) consigliato per gli studenti
- Corsi aggiuntivi: curricula di IA generativa, Data Science, ML, IoT disponibili
### Lavorare con Progetti Specifici
Per istruzioni dettagliate sui singoli progetti, consulta i file README in:
- `quiz-app/README.md` - applicazione quiz Vue 3
- `7-bank-project/README.md` - applicazione bancaria con autenticazione
- `5-browser-extension/README.md` - sviluppo estensione browser
- `6-space-game/README.md` - sviluppo gioco basato su canvas
- `9-chat-project/README.md` - progetto assistente chat AI
- `quiz-app/README.md` - Applicazione quiz Vue 3
- `7-bank-project/README.md` - Applicazione bancaria con autenticazione
- `5-browser-extension/README.md` - Sviluppo estensione browser
- `6-space-game/README.md` - Sviluppo gioco basato su Canvas
- `9-chat-project/README.md` - Progetto assistente chat AI
### Struttura Monorepo
Anche se non è un monorepo tradizionale, questo repository contiene molti progetti indipendenti:
Sebbene non sia un monorepo tradizionale, questo repository contiene più progetti indipendenti:
- Ogni lezione è autonoma
- I progetti non condividono dipendenze
- Lavora su progetti individuali senza influenzare gli altri
- Lavora sui singoli progetti senza influenzarne altri
- Clona l’intero repo per l’esperienza completa del curriculum
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Disclaimer**:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per garantire l’accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua originale dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un essere umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.
Questo documento è stato tradotto utilizzando il servizio di traduzione AI [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua madre deve essere considerato la fonte autorevole. Per informazioni critiche, si consiglia una traduzione professionale effettuata da un umano. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:49:28+00:00",
"translation_date": "2026-04-20T16:40:39+00:00",
"source_file": "AGENTS.md",
"language_code": "pl"
},

288
translations/pl/AGENTS.md
Unescape View File

@ -1,57 +1,57 @@
# AGENTS.md
## Przegląd projektu
## Przegląd Projektu
To repozytorium edukacyjne służy do nauczania podstaw rozwoju stron internetowych dla początkujących. Program nauczania to kompleksowy kurs trwający 12 tygodni, opracowany przez Microsoft Cloud Advocates, zawierający 24 praktyczne lekcje obejmujące JavaScript, CSS i HTML.
To repozytorium edukacyjne służące do nauczania podstaw web developmentu dla początkujących. Program nauczania to kompleksowy 12-tygodniowy kurs opracowany przez Microsoft Cloud Advocates, obejmujący 24 praktyczne lekcje dotyczące JavaScript, CSS i HTML.
### Kluczowe elementy
### Kluczowe Komponenty
- **Treści edukacyjne**: 24 strukturalne lekcje podzielone na moduły projektowe
- **Projekty praktyczne**: Terrarium, Gra w pisanie, Rozszerzenie przeglądarki, Gra kosmiczna, Aplikacja bankowa, Edytor kodu oraz Asystent czatu AI
- **Interaktywne quizy**: 48 quizów po 3 pytania każdy (oceny przed i po lekcji)
- **Wsparcie wielojęzyczne**: Automatyczne tłumaczenia na ponad 50 języków za pomocą GitHub Actions
- **Treści edukacyjne**: 24 ustrukturyzowane lekcje zorganizowane w moduły oparte na projektach
- **Projekty praktyczne**: Terrarium, Gra Typowania, Rozszerzenie przeglądarki, Gra Kosmiczna, Aplikacja Bankowa, Edytor kodu i Asystent czatu AI
- **Interaktywne quizy**: 48 quizów po 3 pytania (oceny przed i po lekcji)
- **Wsparcie wielojęzyczne**: Automatyczne tłumaczenia na 50+ języków za pomocą GitHub Actions
- **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (dla projektów AI)
### Architektura
- Edukacyjne repozytorium z strukturą lekcji
- Edukacyjne repozytorium o strukturze opartej na lekcjach
- Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania
- Samodzielne projekty w oddzielnych katalogach (quiz-app, różne projekty lekcji)
- Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcji)
- System tłumaczeń wykorzystujący GitHub Actions (co-op-translator)
- Dokumentacja dostępna przez Docsify oraz w formacie PDF
- Dokumentacja serwowana przez Docsify i dostępna jako PDF
## Polecenia instalacyjne
## Komendy do Ustawienia
To repozytorium służy głównie do konsumpcji materiałów edukacyjnych. Aby pracować z konkretnymi projektami:
To repozytorium jest głównie do konsumpcji treści edukacyjnych. Do pracy z konkretnymi projektami:
### Główna instalacja repozytorium
### Podstawowa konfiguracja repozytorium
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Instalacja Quiz App (Vue 3 + Vite)
### Konfiguracja Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Uruchom serwer deweloperski
npm run build # Zbuduj do produkcji
npm run build # Buduj na produkcję
npm run lint # Uruchom ESLint
```
### API projektu Bank (Node.js + Express)
### Bank Project API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Uruchom serwer API
npm run lint # Uruchom ESLint
npm run format # Formatuj za pomocą Prettiera
npm run format # Sformatuj za pomocą Prettier
```
### Projekty rozszerzeń przeglądarki
### Projekty Rozszerzenia Przeglądarki
```bash
cd 5-browser-extension/solution
@ -59,7 +59,7 @@ npm install
# Postępuj zgodnie z instrukcjami ładowania rozszerzeń specyficznymi dla przeglądarki
```
### Projekty gry kosmicznej
### Projekty Gry Kosmicznej
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Otwórz index.html w przeglądarce lub użyj Live Server
```
### Projekt czatu (backend Python)
### Projekt Czat (Backend Python)
```bash
cd 9-chat-project/solution/backend/python
@ -76,42 +76,42 @@ pip install openai
python api.py
```
## Przebieg prac rozwojowych
## Przebieg Rozwoju
### Dla osób tworzących treści
### Dla wniesienia treści
1. **Zrób fork repozytorium** na swoje konto GitHub
2. **Sklonuj swojego forka** lokalnie
3. **Utwórz nową gałąź** dla swoich zmian
4. Wprowadzaj zmiany w treści lekcji lub przykładach kodu
3. **Utwórz nową gałąź** na swoje zmiany
4. Wprowadź zmiany w treści lekcji lub przykładach kodu
5. Testuj zmiany kodu w odpowiednich katalogach projektów
6. Składaj pull requesty zgodnie z wytycznymi dotyczącymi współpracy
6. Prześlij pull requesty zgodnie z wytycznymi contribution
### Dla uczących się
1. Zrób fork lub sklonuj repozytorium
2. Przechodź kolejno do katalogów z lekcjami
3. Czytaj pliki README każdej lekcji
4. Wykonuj quizy przed lekcją na https://ff-quizzes.netlify.app/web/
2. Przechodź przez katalogi lekcji kolejno
3. Czytaj pliki README dla każdej lekcji
4. Wykonaj quizy przed lekcjami na https://ff-quizzes.netlify.app/web/
5. Pracuj z przykładami kodu w folderach lekcji
6. Wykonuj zadania i wyzwania
7. Przystępuj do quizów po lekcji
7. Przejdź quizy po lekcji
### Praca na żywo
### Live Development
- **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000)
- **Quiz App**: Uruchom w katalogu quiz-app `npm run dev`
- **Projekty**: Używaj rozszerzenia Live Server w VS Code dla projektów HTML
- **Quiz App**: Uruchom `npm run dev` w katalogu quiz-app
- **Projekty**: Użyj rozszerzenia VS Code Live Server dla projektów HTML
- **Projekty API**: Uruchom `npm start` w odpowiednich katalogach API
## Instrukcje testowania
## Instrukcje Testowania
### Testowanie Quiz App
```bash
cd quiz-app
npm run lint # Sprawdź problemy ze stylem kodu
npm run build # Zweryfikuj, czy kompilacja się powiodła
npm run build # Zweryfikuj, czy kompilacja zakończyła się sukcesem
```
### Testowanie Bank API
@ -124,80 +124,80 @@ node server.js # Sprawdź, czy serwer uruchamia się bez błędów
### Ogólne podejście do testowania
- To repozytorium edukacyjne bez kompleksowych testów automatycznych
- Testowanie manualne koncentruje się na:
- Bezbłędnym uruchamianiu przykładów kodu
- Poprawności linków w dokumentacji
- Prawidłowym budowaniu projektów
- Przykłady zgodne z dobrymi praktykami
- To repozytorium edukacyjne bez rozbudowanych testów automatycznych
- Testowanie ręczne skupia się na:
- Przykłady kodu działają bez błędów
- Linki w dokumentacji działają poprawnie
- Budowy projektów kończą się sukcesem
- Przykłady są zgodne z najlepszymi praktykami
### Kontrole przed wysłaniem
- Uruchom `npm run lint` w katalogach z package.json
- Sprawdź ważność linków markdown
- Sprawdź poprawność linków markdown
- Testuj przykłady kodu w przeglądarce lub Node.js
- Sprawdź, czy tłumaczenia zachowują właściwą strukturę
- Zweryfikuj, że tłumaczenia zachowują właściwą strukturę
## Wytyczne dotyczące stylu kodu
## Zasady Stylu Kodu
### JavaScript
- Używaj nowoczesnej składni ES6+
- Stosuj standardową konfigurację ESLint dostarczoną w projektach
- Używaj znaczących nazw zmiennych i funkcji dla jasności edukacyjnej
- Dodawaj komentarze tłumaczące koncepcje dla uczących się
- Formatowanie kodu za pomocą Prettier, jeśli jest skonfigurowane
- Stosuj standardowe konfiguracje ESLint podane w projektach
- Używaj czytelnych nazw zmiennych i funkcji dla jasności edukacyjnej
- Dodawaj komentarze objaśniające koncepcje dla uczących się
- Formatuj przy użyciu Prettier tam, gdzie jest skonfigurowany
### HTML/CSS
- Semantyczne elementy HTML5
- Zasady projektowania responsywnego
- Jasne konwencje nazewnictwa klas
- Komentarze wyjaśniające techniki CSS dla uczących się
- Jasna konwencja nazewnictwa klas
- Komentarze objaśniające techniki CSS dla uczących
### Python
- Wytyczne stylu PEP 8
- Zasady stylu PEP 8
- Jasne, edukacyjne przykłady kodu
- Adnotacje typów tam, gdzie pomagają w nauce
### Dokumentacja Markdown
### Dokumentacja w Markdown
- Jasna hierarchia nagłówków
- Bloki kodu z określeniem języka
- Linki do dodatkowych zasobów
- Zrzuty ekranu i obrazy w katalogach `images/`
- Zrzuty ekranów i obrazy w katalogach `images/`
- Tekst alternatywny dla obrazów dla dostępności
### Organizacja plików
### Organizacja Plików
- Lekcje ponumerowane kolejno (1-getting-started-lessons, 2-js-basics itd.)
- Każdy projekt ma katalog `solution/` i często `start/` lub `your-work/`
- Obrazy przechowywane w specyficznych folderach `images/` dla lekcji
- Tłumaczenia w strukturze `translations/{kod-języka}/`
- Lekcje numerowane kolejno (1-getting-started-lessons, 2-js-basics, itd.)
- Każdy projekt posiada katalogi `solution/` oraz często `start/` lub `your-work/`
- Obrazy przechowywane w folderach `images/` specyficznych dla lekcji
- Tłumaczenia w strukturze `translations/{language-code}/`
## Budowanie i wdrażanie
## Budowa i Wdrożenie
### Wdrażanie Quiz App (Azure Static Web Apps)
### Wdrożenie Quiz App (Azure Static Web Apps)
quiz-app jest skonfigurowany do wdrażania na Azure Static Web Apps:
Quiz-app jest skonfigurowany do wdrożenia na Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Tworzy folder dist/
# Wdraża za pomocą workflow GitHub Actions przy pushu do main
# Wdraża za pomocą workflow GitHub Actions przy pushu do gałęzi main
```
Konfiguracja Azure Static Web Apps:
- **Lokalizacja aplikacji**: `/quiz-app`
- **Lokalizacja wyjściowa**: `dist`
- **Proces workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **Lokalizacja outputu**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generowanie dokumentacji PDF
```bash
npm install # Zainstaluj docsify-to-pdf
npm run convert # Wygeneruj PDF z docs
npm run convert # Wygeneruj plik PDF z docs
```
### Dokumentacja Docsify
@ -210,73 +210,73 @@ docsify serve # Serwuj na localhost:3000
### Budowy specyficzne dla projektów
Każdy katalog projektu może mieć własny proces budowy:
- Projekty Vue: `npm run build` tworzy produkcyjne pakiety
- Projekty statyczne: brak etapu build, pliki serwowane bezpośrednio
- Projekty Vue: `npm run build` tworzy produkcyjne bundlery
- Projekty statyczne: brak kroku budowania, serwuj pliki bezpośrednio
## Wytyczne dotyczące pull requestów
## Wytyczne dla Pull Requestów
### Format tytułu
Używaj jasnych, opisowych tytułów wskazujących obszar zmiany:
Używaj jasnych, opisowych tytułów wskazujących obszar zmian:
- `[Quiz-app] Dodaj nowy quiz do lekcji X`
- `[Lesson-3] Popraw literówkę w projekcie terrarium`
- `[Translation] Dodaj tłumaczenie na hiszpański do lekcji 5`
- `[Docs] Aktualizacja instrukcji instalacji`
- `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5`
- `[Docs] Aktualizuj instrukcje konfiguracji`
### Wymagane kontrole
Przed wysłaniem PR:
1. **Jakość kodu**:
- Uruchom `npm run lint` w katalogach projektów objętych zmianami
- Usuń wszystkie błędy i ostrzeżenia lintingu
- Uruchom `npm run lint` w katalogach projektów
- Napraw wszystkie błędy i ostrzeżenia lintingu
2. **Weryfikacja budowy**:
- Jeśli dotyczy, uruchom `npm run build`
- Upewnij się, że nie ma błędów budowy
2. **Weryfikacja builda**:
- Uruchom `npm run build` jeśli dotyczy
- Upewnij się, że brak błędów budowania
3. **Walidacja linków**:
- Testuj wszystkie linki markdown
- Sprawdź poprawność obrazów
- Sprawdź działanie odwołań do obrazów
4. **Przegląd zawartości**:
- Korekta pisowni i gramatyki
- Korekta ortografii i gramatyki
- Upewnij się, że przykłady kodu są poprawne i edukacyjne
- Weryfikuj, czy tłumaczenia zachowują pierwotne znaczenie
- Sprawdź, czy tłumaczenia zachowują oryginalne znaczenie
### Wymagania dotyczące współpracy
### Wymagania dotyczące wkładu
- Zgoda na Microsoft CLA (automatyczna weryfikacja przy pierwszym PR)
- Zgoda na Microsoft CLA (automatyczna kontrola przy pierwszym PR)
- Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Szczegółowe wytyczne w [CONTRIBUTING.md](./CONTRIBUTING.md)
- Jeżeli dotyczy, podawaj numery issue w opisie PR
- W referencji do PR podaj numery zgłoszeń, jeśli dotyczy
### Proces przeglądu
- PR są przeglądane przez maintainerów i społeczność
- Priorytet dla jasności edukacyjnej
- Przykłady kodu powinny stosować aktualne najlepsze praktyki
- Tłumaczenia przeglądane pod kątem dokładności i kulturowej adekwatności
- PRy recenzowane przez opiekunów i społeczność
- Priorytetem jest jasność edukacyjna
- Przykłady kodu powinny korzystać z aktualnych najlepszych praktyk
- Tłumaczenia sprawdzane pod kątem dokładności i odpowiedniości kulturowej
## System tłumaczeń
## System Tłumaczeń
### Tłumaczenie automatyczne
### Automatyczne tłumaczenie
- Używa GitHub Actions z workflow co-op-translator
- Automatycznie tłumaczy na ponad 50 języków
- Wykorzystuje GitHub Actions z workflow co-op-translator
- Automatyczne tłumaczenie na ponad 50 języków
- Pliki źródłowe w głównych katalogach
- Pliki tłumaczeń w katalogach `translations/{kod-języka}/`
- Pliki tłumaczeń w katalogach `translations/{language-code}/`
### Dodawanie ręcznych poprawek tłumaczeń
1. Znajdź plik w `translations/{kod-języka}/`
2. Wprowadź poprawki z zachowaniem struktury
3. Upewnij się, że przykłady kodu pozostają funkcjonalne
4. Testuj lokalizowaną treść quizów
1. Znajdź plik w `translations/{language-code}/`
2. Dokonaj poprawek zachowując strukturę
3. Upewnij się, że przykłady kodu działają
4. Testuj wszelkie zlokalizowane treści quizowe
### Metadane tłumaczeń
### Metadane tłumaczenia
Przetłumaczone pliki zawierają nagłówek metadanych:
Pliki przetłumaczone zawierają nagłówek metadanych:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Debugowanie i rozwiązywanie problemów
## Debugowanie i Rozwiązywanie Problemów
### Najczęstsze problemy
**Quiz app nie uruchamia się**:
- Sprawdź wersję Node.js (zalecane v14+)
**Quiz app nie startuje**:
- Sprawdź wersję Node.js (zalecana v14+)
- Usuń `node_modules` i `package-lock.json`, uruchom ponownie `npm install`
- Sprawdź, czy port nie jest zajęty (domyślnie Vite używa portu 5173)
- Sprawdź konflikty portów (domyślnie Vite używa portu 5173)
**Serwer API nie startuje**:
- Sprawdź, czy wersja Node.js spełnia minimalną (node >=10)
**Serwer API nie uruchamia się**:
- Sprawdź, czy wersja Node.js spełnia minimum (node >=10)
- Sprawdź, czy port nie jest już zajęty
- Upewnij się, że wszystkie zależności zostały zainstalowane (`npm install`)
- Upewnij się, że wszystkie zależności zainstalowane `npm install`
**Rozszerzenie przeglądarki nie ładuje się**:
- Sprawdź poprawność pliku manifest.json
**Rozszerzenie przeglądarki się nie ładuje**:
- Sprawdź poprawność manifest.json
- Sprawdź konsolę przeglądarki pod kątem błędów
- Postępuj zgodnie z instrukcjami instalacji dla danej przeglądarki
- Postępuj zgodnie z instrukcjami instalacji rozszerzeń specyficznych dla przeglądarki
**Problemy z projektem czatu w Pythonie**:
- Upewnij się, że pakiet OpenAI jest zainstalowany: `pip install openai`
- Sprawdź, czy zmienna środowiskowa GITHUB_TOKEN jest ustawiona
- Zweryfikuj uprawnienia dostępu do GitHub Models
**Docsify nie serwuje dokumentacji**:
**Docsify nie serwuje dokumentów**:
- Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli`
- Uruchom z katalogu głównego repozytorium
- Uruchom z katalogu root repozytorium
- Sprawdź, czy istnieje `docs/_sidebar.md`
### Wskazówki dotyczące środowiska programistycznego
- Używaj VS Code z rozszerzeniem Live Server dla projektów HTML
- Zainstaluj rozszerzenia ESLint i Prettier dla spójnego formatowania
- Używaj narzędzi deweloperskich przeglądarki do debugowania JavaScript
- Korzystaj z DevTools przeglądarki do debugowania JavaScript
- Dla projektów Vue zainstaluj rozszerzenie Vue DevTools do przeglądarki
### Aspekty wydajnościowe
### Względy wydajnościowe
- Duża liczba tłumaczeń (ponad 50 języków) powoduje, że pełne klony są duże
- Stosuj płytkie klony, jeśli pracujesz tylko z treścią: `git clone --depth 1`
- Wyklucz tłumaczenia z przeszukiwania podczas pracy nad angielską zawartością
- Procesy budowania mogą być powolne przy pierwszym uruchomieniu (npm install, budowa Vite)
- Duża liczba plików tłumaczeń (50+ języków) powoduje duże klony
- Używaj płytkiego klonu jeśli pracujesz tylko nad treścią: `git clone --depth 1`
- Wyklucz tłumaczenia z wyszukiwań podczas pracy nad angielską wersją
- Procesy budowania mogą być wolne przy pierwszym uruchomieniu (npm install, build Vite)
## Aspekty bezpieczeństwa
## Aspekty Bezpieczeństwa
### Zmienne środowiskowe
- Klucze API nigdy nie powinny być commitowane do repozytorium
- Używaj plików `.env` (są uwzględnione w `.gitignore`)
- Dokumentuj wymagane zmienne środowiskowe w plikach README projektów
- Klucze API nie powinny być nigdy commitowane do repozytorium
- Używaj plików `.env` (już w `.gitignore`)
- Udokumentuj wymagane zmienne środowiskowe w README projektów
### Projekty Python
- Używaj środowisk wirtualnych: `python -m venv venv`
- Aktualizuj zależności
- Tokeny GitHub powinny posiadać minimalne wymagane uprawnienia
- Używaj wirtualnych środowisk: `python -m venv venv`
- Aktualizuj zależności na bieżąco
- Tokenty GitHub powinny mieć minimalne wymagane uprawnienia
### Dostęp do GitHub Models
- Do GitHub Models wymagane są Personal Access Tokens (PAT)
- Tokeny powinny być przechowywane jako zmienne środowiskowe
- Personal Access Tokens (PAT) wymagane do GitHub Models
- Tokenty powinny być przechowywane jako zmienne środowiskowe
- Nigdy nie commituj tokenów ani danych uwierzytelniających
## Dodatkowe uwagi
## Dodatkowe Uwagi
### Grupa docelowa
- Zupełni początkujący w rozwoju stron internetowych
- Całkowici początkujący w web developmencie
- Studenci i samoucy
- Nauczyciele korzystający z programu nauczania w klasach
- Zawartość zaprojektowana pod kątem dostępności i stopniowego rozwoju umiejętności
- Nauczyciele korzystający z programu w klasie
- Treść zaprojektowana z myślą o dostępności i stopniowym rozwoju umiejętności
### Filozofia edukacyjna
- Podejście oparte na nauce przez projekty
- Nauka oparta na projektach
- Częste sprawdzanie wiedzy (quizy)
- Ćwiczenia praktyczne z kodem
- Przykłady zastosowania w rzeczywistych sytuacjach
- Praktyczne ćwiczenia kodowania
- Przykłady zastosowań w realnym świecie
- Skupienie na podstawach przed frameworkami
### Utrzymanie repozytorium
- Aktywna społeczność uczących się i współtwórców
- Regularne aktualizacje zależności i treści
- Monitorowanie zgłoszeń i dyskusji przez maintainerów
- Aktualizacje tłumaczeń automatyzowane przez GitHub Actions
- Monitorowane zgłoszenia i dyskusje przez opiekunów
- Automatyczne aktualizacje tłumaczeń przez GitHub Actions
### Powiązane zasoby
- [Moduły Microsoft Learn](https://docs.microsoft.com/learn/)
- [Student Hub – zasoby](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) polecany dla uczących się
- [Zasoby Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomendowane dla uczących się
- Dodatkowe kursy: Generative AI, Data Science, ML, IoT dostępne
### Praca z konkretnymi projektami
Szczegółowe instrukcje dotyczące poszczególnych projektów znajdują się w plikach README:
Dla szczegółowych instrukcji dot. poszczególnych projektów zobacz pliki README w:
- `quiz-app/README.md` - aplikacja quizowa Vue 3
- `7-bank-project/README.md` - aplikacja bankowa z uwierzytelnianiem
- `7-bank-project/README.md` - aplikacja bankowa z autentykacją
- `5-browser-extension/README.md` - rozwój rozszerzenia przeglądarki
- `6-space-game/README.md` - gra na kanwie Canvas
- `6-space-game/README.md` - rozwój gry na canvasie
- `9-chat-project/README.md` - projekt asystenta czatu AI
### Struktura monorepo
### Struktura Monorepo
Choć to nie jest tradycyjne monorepo, to repozytorium zawiera wiele niezależnych projektów:
- Każda lekcja jest samodzielna
Chociaż to nie jest tradycyjne monorepo, repozytorium zawiera wiele niezależnych projektów:
- Każda lekcja jest autonomiczna
- Projekty nie dzielą zależności
- Można pracować nad pojedynczymi projektami, nie wpływając na inne
- Sklonuj całe repozytorium, aby uzyskać pełne doświadczenie kursu
- Pracuj nad pojedynczymi projektami bez wpływu na inne
- Sklonuj całe repo dla pełnego doświadczenia kursu
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Zastrzeżenie**:
Niniejszy dokument został przetłumaczony przy użyciu automatycznej usługi tłumaczeniowej AI [Co-op Translator](https://github.com/Azure/co-op-translator). Chociaż dokładamy starań, aby tłumaczenie było precyzyjne, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub niedokładności. Oryginalny dokument w języku źródłowym powinien być uznawany za źródło nadrzędne. W przypadku informacji krytycznych zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.
**Zastrzeżenie**:
Niniejszy dokument został przetłumaczony przy użyciu usługi tłumaczeń AI [Co-op Translator](https://github.com/Azure/co-op-translator). Chociaż dążymy do dokładności, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym powinien być uważany za źródło autorytatywne. W przypadku istotnych informacji zaleca się profesjonalne tłumaczenie przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:50:38+00:00",
"translation_date": "2026-04-20T16:41:41+00:00",
"source_file": "AGENTS.md",
"language_code": "tr"
},

268
translations/tr/AGENTS.md
Unescape View File

@ -2,14 +2,14 @@
## Proje Genel Bakışı
Bu, yeni başlayanlara web geliştirme temellerini öğretmek için hazırlanan eğitim müfredatı deposudur. Müfredat, Microsoft Cloud Advocates tarafından geliştirilen kapsamlı 12 haftalık bir kurstur ve JavaScript, CSS ve HTML’i içeren 24 uygulamalı ders içermektedir.
Bu, yeni başlayanlara web geliştirme temellerini öğretmek için hazırlanmış eğitim amaçlı bir müfredat deposudur. Müfredat, Microsoft Cloud Advocates tarafından geliştirilen kapsamlı 12 haftalık bir kurstur ve JavaScript, CSS ve HTML'i kapsayan 24 uygulamalı dersten oluşur.
### Ana Bileşenler
- **Eğitim İçeriği**: Proje tabanlı modüller halinde düzenlenmiş 24 yapılandırılmış ders
- **Pratik Projeler**: Terrarium, Yazı Yazma Oyunu, Tarayıcı Uzantısı, Uzay Oyunu, Bankacılık Uygulaması, Kod Editörü ve AI Sohbet Asistanı
- **Etkileşimli Quizler**: Her biri 3 sorudan oluşan 48 quiz (ders öncesi/sonrası değerlendirmeler)
- **Çok Dilli Destek**: GitHub Actions ile 50’den fazla dile otomatik çeviriler
- **Eğitim İçeriği**: Proje tabanlı modüllerde düzenlenmiş 24 yapılandırılmış ders
- **Pratik Projeler**: Terrarium, Yazma Oyunu, Tarayıcı Uzantısı, Uzay Oyunu, Banka Uygulaması, Kod Editörü ve AI Sohbet Asistanı
- **Etkileşimli Testler**: Her biri 3 sorudan oluşan 48 test (ders öncesi/sonrası değerlendirmeleri)
- **Çok Dilli Destek**: GitHub Actions aracılığıyla 50+ dilde otomatik çeviriler
- **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projeleri için)
### Mimari
@ -17,12 +17,12 @@ Bu, yeni başlayanlara web geliştirme temellerini öğretmek için hazırlanan
- Ders tabanlı yapıya sahip eğitim deposu
- Her ders klasörü README, kod örnekleri ve çözümler içerir
- Bağımsız projeler ayrı dizinlerde (quiz-app, çeşitli ders projeleri)
- GitHub Actions (co-op-translator) ile çeviri sistemi
- Docsify üzerinden sunulan ve PDF olarak erişilebilen dokümantasyon
- GitHub Actions kullanan çeviri sistemi (co-op-translator)
- Docsify ile sunulan ve PDF olarak da erişilebilir belge
## Kurulum Komutları
Bu depo öncelikle eğitim içeriği tüketimi için tasarlanmıştır. Belirli projelerle çalışmak için:
Bu depo öncelikle eğitim içeriklerini tüketmek içindir. Belirli projelerle çalışmak için:
### Ana Depo Kurulumu
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Geliştirme sunucusunu başlat
npm run build # Üretim için yapılandır
npm run build # Üretim için derle
npm run lint # ESLint'i çalıştır
```
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# Tarayıcıda index.html dosyasını açın veya Live Server kullanın
# index.html dosyasını tarayıcıda açın veya Canlı Sunucu'yu kullanın
```
### Sohbet Projesi (Python Backend)
@ -78,29 +78,29 @@ python api.py
## Geliştirme İş Akışı
### İçerik Katkıda Bulunanlar İçin
### İçerik Katkı Sağlayıcılar için
1. Depoyu GitHub hesabınıza **forklayın**
2. Kendi fork’unuzu yerel olarak **klonlayın**
3. Değişiklikleriniz için yeni bir **branch oluşturun**
2. Forkladığınız depoyu **yerel olarak klonlayın**
3. Değişiklikleriniz için **yeni bir dal oluşturun**
4. Ders içeriği veya kod örneklerinde değişiklik yapın
5. İlgili proje dizinlerinde kod değişikliklerini test edin
6. Katkı kurallarına uygun şekilde pull request gönderin
6. Katkı yönergelerine uygun şekilde pull request gönderin
### Öğrenenler İçin
### Öğrenenler için
1. Depoyu fork’layın veya klonlayın
2. Ders dizinlerinde sırayla ilerleyin
3. Her dersin README dosyasını okuyun
4. Ders öncesi quizlerini https://ff-quizzes.netlify.app/web/ adresinde tamamlayın
5. Ders klasörlerindeki kod örnekleriyle çalışın
1. Depoyu forklayın veya klonlayın
2. Ders dizinlerinde sırasıyla gezin
3. Her ders için README dosyalarını okuyun
4. https://ff-quizzes.netlify.app/web/ adresinde ders öncesi testleri tamamlayın
5. Ders klasörlerindeki kod örneklerinde çalışın
6. Ödevleri ve zorlukları tamamlayın
7. Ders sonrası quizlerini yapın
7. Ders sonrası testleri yapın
### Canlı Geliştirme
- **Dokümantasyon**: Kök dizinde `docsify serve` çalıştırın (port 3000)
- **Quiz Uygulaması**: quiz-app dizininde `npm run dev` çalıştırın
- **Dokümantasyon**: Kök dizinde `docsify serve` komutunu çalıştırın (port 3000)
- **Quiz Uygulaması**: `quiz-app` dizininde `npm run dev` komutunu çalıştırın
- **Projeler**: HTML projeleri için VS Code Live Server uzantısını kullanın
- **API Projeleri**: İlgili API dizinlerinde `npm start` komutunu çalıştırın
@ -110,16 +110,16 @@ python api.py
```bash
cd quiz-app
npm run lint # Kod stili sorunlarını kontrol et
npm run lint # Kod stil sorunlarını kontrol et
npm run build # Derlemenin başarılı olduğunu doğrula
```
### Banka API Testi
### Bank API Testi
```bash
cd 7-bank-project/api
npm run lint # Kod stili sorunlarını kontrol et
node server.js # Sunucunun hatasız başladığını doğrula
node server.js # Sunucunun hatasız başlayıp başlamadığını doğrula
```
### Genel Test Yaklaşımı
@ -128,64 +128,64 @@ node server.js # Sunucunun hatasız başladığını doğrula
- Manuel testler şunlara odaklanır:
- Kod örneklerinin hatasız çalışması
- Dokümantasyondaki bağlantıların doğru çalışması
- Proje derlemelerinin başarılı olması
- Örneklerin en iyi uygulamaları takip etmesi
- Proje derlemelerinin başarıyla tamamlanması
- Örneklerin en iyi uygulamalara uygunluğu
### Gönderim Öncesi Kontroller
- package.json bulunan dizinlerde `npm run lint` çalıştırın
- Markdown bağlantılarının geçerli olduğundan emin olun
- Kod örneklerini tarayıcı veya Node.js’de test edin
- Çevirilerin yapısını koruduğundan emin olun
- Paket.json içeren dizinlerde `npm run lint` komutunu çalıştırın
- Markdown bağlantılarını doğrulayın
- Kod örneklerini tarayıcı veya Node.js'de test edin
- Çevirilerin yapısını düzgün koruduğunu kontrol edin
## Kod Stili Rehberi
## Kod Stili Kılavuzu
### JavaScript
- Modern ES6+ sözdizimi kullanın
- Projelerde sağlanan standart ESLint yapılandırmalarını takip edin
- Eğitim amaçlı anlamlı değişken ve fonksiyon isimleri kullanın
- Projelerde sağlanan standart ESLint yapılandırmalarına uyun
- Eğitim amaçlı anlamlı değişken ve fonksiyon adları kullanın
- Öğrenenler için kavramları açıklayan yorumlar ekleyin
- Yapılandırılmış ise Prettier ile formatlayın
- Yapılandırılmış yerlerde Prettier kullanarak biçimlendirin
### HTML/CSS
- Semantik HTML5 elemanları kullanın
- Duyarlı tasarım prensipleri uygulayın
- Açık sınıf isimlendirme konvansiyonları kullanın
- Öğrenenler için CSS tekniklerini açıklayan yorumlar ekleyin
- Anlamsal HTML5 elemanları
- Duyarlı tasarım prensipleri
- Açık sınıf isimlendirme kuralları
- CSS tekniklerini açıklayan yorumlar
### Python
- PEP 8 stil kurallarına uyun
- Açık, eğitim amaçlı kod örnekleri sunun
- Öğrenmeyi kolaylaştıran tip ipuçları kullanın
- PEP 8 stil yönergeleri
- Açık, eğitim odaklı kod örnekleri
- Öğrenme için yardımcı olduğunda tür ipuçları
### Markdown Dokümantasyon
### Markdown Dokümantasyonu
- Açık başlık hiyerarşisi
- Programlama dili belirtilmiş kod blokları
- Dil belirtmeli kod blokları
- Ek kaynaklara bağlantılar
- `images/` dizininde ekran görüntüleri ve resimler
- Erişilebilirlik için resimlerin alt metinleri
- `images/` dizinlerinde ekran görüntüleri ve resimler
- Erişilebilirlik için resimlere alt metin
### Dosya Organizasyonu
- Dersler numaralandırılmıştır (1-getting-started-lessons, 2-js-basics, vb.)
- Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri bulunur
- Resimler ders bazlı `images/` klasörlerinde saklanır
- Dersler sırasıyla numaralandırılmış (1-getting-started-lessons, 2-js-basics vb.)
- Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri var
- Derslere özgü `images/` klasörlerinde görseller saklanır
- Çeviriler `translations/{language-code}/` yapısındadır
## Derleme ve Dağıtım
## Derleme ve Yayınlama
### Quiz Uygulaması Dağıtımı (Azure Static Web Apps)
### Quiz Uygulaması Yayınlama (Azure Static Web Apps)
quiz-app, Azure Static Web Apps dağıtımına uygun şekilde yapılandırılmıştır:
quiz-app Azure Static Web Apps yayını için yapılandırılmıştır:
```bash
cd quiz-app
npm run build # dist/ klasörü oluşturur
# main dalına push yapıldığında GitHub Actions iş akışı ile dağıtım yapar
# Ana dala push yapıldığında GitHub Actions iş akışı ile dağıtım yapar
```
Azure Static Web Apps yapılandırması:
@ -193,35 +193,35 @@ Azure Static Web Apps yapılandırması:
- **Çıktı konumu**: `dist`
- **İş akışı**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokümantasyon PDF Üretimi
### Dokümantasyon PDF Oluşturma
```bash
npm install # docsify-to-pdf yükleyin
npm run convert # docs'dan PDF oluşturun
npm install # docsify-to-pdf yükle
npm run convert # Belgelerden PDF oluştur
```
### Docsify Dokümantasyonu
```bash
npm install -g docsify-cli # Docsify'i global olarak yükleyin
docsify serve # localhost:3000 üzerinde servis verin
npm install -g docsify-cli # Docsify'i global olarak kur
docsify serve # localhost:3000 üzerinde sun
```
### Projeye Özel Derlemeler
### Proje Bazlı Derlemeler
Her proje dizininin kendi derleme süreci olabilir:
- Vue projeleri: Üretim paketleri için `npm run build`
- Statik projeler: Derleme yok, dosyalar doğrudan sunulur
- Vue projeleri: `npm run build` ile prodüksiyon paketleri oluşturur
- Statik projeler: Derleme adımı yok, dosyalar doğrudan sunulur
## Pull Request Kuralları
## Pull Request Yönergeleri
### Başlık Formatı
Değişiklik alanını belirten net, açıklayıcı başlık kullanın:
- `[Quiz-app] Ders X için yeni quiz eklendi`
- `[Lesson-3] Terrarium projesinde yazım hatası düzeltildi`
- `[Translation] Ders 5 için İspanyolca çeviri eklendi`
- `[Docs] Kurulum talimatları güncellendi`
Değişiklik alanını belirten net, açıklayıcı başlıklar kullanın:
- `[Quiz-app] Ders X için yeni quiz ekle`
- `[Lesson-3] Terrarium projesindeki yazım hatasını düzelt`
- `[Translation] Ders 5 için İspanyolca çeviri ekle`
- `[Docs] Kurulum talimatlarını güncelle`
### Gerekli Kontroller
@ -229,50 +229,50 @@ PR göndermeden önce:
1. **Kod Kalitesi**:
- Etkilenen proje dizinlerinde `npm run lint` çalıştırın
- Tüm lint hatalarını ve uyarılarını giderin
- Tüm lint hatalarını ve uyarılarını düzeltin
2. **Derleme Doğrulaması**:
- Uygunsa `npm run build` çalıştırın
- Varsa `npm run build` komutunu çalıştırın
- Derleme hatası olmadığından emin olun
3. **Bağlantı Doğrulaması**:
3. **Link Doğrulama**:
- Tüm markdown bağlantılarını test edin
- Resim referanslarının çalıştığını kontrol edin
4. **İçerik İncelemesi**:
- Yazım ve dilbilgisi kontrolü yapın
- Kod örneklerinin doğru ve öğretici olduğundan emin olun
- Yazım ve dilbilgisini gözden geçirin
- Kod örneklerinin doğru ve eğitici olduğundan emin olun
- Çevirilerin orijinal anlamı koruduğunu doğrulayın
### Katkı Gereksinimleri
- Microsoft CLA’ya (ilk PR’de otomatik kontrol)
- Microsoft CLA'ya (ilk PR'de otomatik kontrol)
- [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/) uyumu
- Detaylı kurallar için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın
- PR açıklamasında ilgili sorun numaralarına atıfta bulunun
- Detaylı yönergeler için [CONTRIBUTING.md](./CONTRIBUTING.md)
- PR açıklamasında ilgili sorun numarasına referans verin (varsa)
### İnceleme Süreci
- PR’lar bakımcılar ve topluluk tarafından incelenir
- Eğitimsel açıklık ön plandadır
- Kod örnekleri güncel en iyi uygulamaları takip etmelidir
- Çeviriler doğruluk ve kültürel uygunluk açısından kontrol edilir
- PR'lar bakımcılar ve topluluk tarafından incelenir
- Eğitim açıklığı ön plandadır
- Kod örnekleri güncel en iyi uygulamalara uygun olmalıdır
- Çeviriler doğruluk ve kültürel uygunluk açısından gözden geçirilir
## Çeviri Sistemi
### Otomatik Çeviri
- GitHub Actions ile co-op-translator iş akışı kullanılır
- 50’den fazla dile otomatik çeviri yapılır
- Kaynak dosyalar ana dizinlerde bulunur
- Çeviriler `translations/{language-code}/` klasörlerinde yer alır
- 50+ dile otomatik çeviri yapılır
- Kaynak dosyalar ana dizinlerde
- Çevrilmiş dosyalar `translations/{language-code}/` dizinlerinde
### Manuel Çeviri İyileştirmeleri Ekleme
1. Dosyayı `translations/{language-code}/` içinde bulun
1. `translations/{language-code}/` içinde dosyayı bulun
2. Yapıyı koruyarak iyileştirmeler yapın
3. Kod örneklerinin işlevselliğinin devam ettiğinden emin olun
4. Yerelleştirilmiş quiz içeriğini test edin
3. Kod örneklerinin işlevselliğini sağlayın
4. Yerelleştirilmiş test içeriklerini test edin
### Çeviri Meta Verisi
@ -295,114 +295,114 @@ CO_OP_TRANSLATOR_METADATA:
**Quiz uygulaması başlamıyor**:
- Node.js sürümünü kontrol edin (v14+ önerilir)
- `node_modules` ve `package-lock.json` silin, sonra `npm install` çalıştırın
- Port çakışmalarını kontrol edin (default: Vite port 5173 kullanır)
- `node_modules` ve `package-lock.json` dosyalarını silip tekrar `npm install` yapın
- Port çakışmalarını kontrol edin (varsayılan: Vite 5173 portunu kullanır)
**API sunucusu başlamıyor**:
- Minimum Node.js sürümü kontrol edin (node >=10)
- Portun kullanımda olup olmadığını doğrulayın
- `npm install` ile tüm bağımlılıkların yüklendiğinden emin olun
- Node.js sürümünün minimum şartları sağladığını kontrol edin (node >=10)
- Portun kullanımda olup olmadığını kontrol edin
- Tüm bağımlılıkların `npm install` ile yüklendiğinden emin olun
**Tarayıcı uzantısı yüklenmiyor**:
- manifest.json dosyasının doğru formatta olduğunu kontrol edin
- Tarayıcı konsolundaki hatalara bakın
- Tarayıcıya özgü uzantı kurulum talimatlarını izleyin
- manifest.json dosyasının doğru formatta olduğunu doğrulayın
- Tarayıcı konsolunda hata olup olmadığını kontrol edin
- Tarayıcıya özgü uzantı yükleme talimatlarını izleyin
**Python sohbet projesi sorunları**:
- OpenAI paketi kurulu olmalı: `pip install openai`
- GITHUB_TOKEN ortam değişkeninin ayarlı olduğundan emin olun
- GitHub Modeller erişim izinlerini kontrol edin
- OpenAI paketi kurulu mu: `pip install openai`
- GITHUB_TOKEN ortam değişkeni ayarlı mı kontrol edin
- GitHub Modeller erişim izinlerini doğrulayın
**Docsify dokümantasyonu sunmuyor**:
- docsify-cli’yi global kurun: `npm install -g docsify-cli`
**Docsify dokümanları sunmuyor**:
- docsify-cli global olarak kurun: `npm install -g docsify-cli`
- Depo kök dizininden çalıştırın
- `docs/_sidebar.md` dosyasının varlığını kontrol edin
- `docs/_sidebar.md` dosyasının var olduğundan emin olun
### Geliştirme Ortamı İpuçları
- HTML projeleri için VS Code Live Server uzantısını kullanın
- Tutarlı format için ESLint ve Prettier uzantılarını kurun
- HTML projeleri için VS Code Live Server uzantısı kullanın
- Tutarlı biçimlendirme için ESLint ve Prettier uzantılarını kurun
- JavaScript hata ayıklama için tarayıcı Geliştirici Araçlarını kullanın
- Vue projeleri için Vue DevTools tarayıcı uzantısını yükleyin
### Performans Considerations
### Performans Dikkatleri
- Çok sayıda çevrilmiş dosya (50+ dil) tam klonlama boyutunu artırır
- Sadece içerik üzerinde çalışıyorsanız sığ klonlama kullanın: `git clone --depth 1`
- İngilizce içerik çalışırken çevirileri aramalardan hariç tutun
- İlk kurulumda derleme işlemleri (npm install, Vite build) yavaş olabilir
- Çok sayıda çeviri dosyası (50+ dil) tam klonları büyük yapar
- Sadece içerikle çalışıyorsanız derinliği 1 olan klon kullanın: `git clone --depth 1`
- İngilizce içerik üzerinde çalışırken çevirileri aramalardan hariç tutun
- İlk çalıştırmada derleme ve yükleme işlemleri yavaş olabilir (npm install, Vite build)
## Güvenlik Considerations
## Güvenlik Dikkatleri
### Ortam Değişkenleri
- API anahtarları hiçbir zaman depoya commit edilmemelidir
- `.env` dosyaları kullanılır (zaten `.gitignore`da var)
- Proje README’lerinde gerekli ortam değişkenleri belgelenir
- API anahtarları asla depoya gönderilmemelidir
- `.env` dosyalarını kullanın (zaten `.gitignore` içinde)
- Gerekli ortam değişkenlerini proje README'lerinde belgeleyin
### Python Projeleri
- Sanal ortamlar kullanın: `python -m venv venv`
- Sanal ortam kullanın: `python -m venv venv`
- Bağımlılıkları güncel tutun
- GitHub token’lar gerekli minimum izinlere sahip olmalıdır
- GitHub tokenları minimum gerekli izinlere sahip olmalıdır
### GitHub Modeller Erişimi
- GitHub Modeller için Kişisel Erişim Tokenları (PAT) gereklidir
- Token'lar ortam değişkeni olarak saklanmalıdır
- Token veya kimlik bilgileri hiçbir zaman commit edilmemelidir
- Tokenlar ortam değişkeni olarak saklanmalıdır
- Tokenlar veya kimlik bilgileri asla depoya gönderilmemelidir
## Ek Notlar
### Hedef Kitle
- Tamamen yeni başlayan web geliştiriciler
- Web geliştirmeye tamamen yeni başlayanlar
- Öğrenciler ve kendi kendine öğrenenler
- Müfredatı sınıflarında kullanan öğretmenler
- İçerik erişilebilirlik ve aşamalı beceri gelişimi için tasarlanmıştır
- İçerik erişilebilirlik ve kademeli beceri geliştirmeye yönelik
### Eğitim Felsefesi
- Proje tabanlı öğrenme yaklaşımı
- Sık sık bilgi kontrolü (quizler)
- Sık bilgi ölçme testleri (quizler)
- Uygulamalı kodlama egzersizleri
- Gerçek dünya uygulama örnekleri
- Frameworklerden önce temellerin vurgulanması
- Frameworklerden önce temel bilgilere odaklanma
### Depo Bakımı
- Aktif öğrenenler ve katkıda bulunanlar topluluğu
- Düzenli bağımlılık ve içerik güncellemeleri
- Sorunlar ve tartışmalar bakımcılarca izlenir
- Çeviri güncellemeleri GitHub Actions ile otomatik
- Aktif öğrenci ve katkı sağlayıcı topluluğu
- Bağımlılıklar ve içerik düzenli olarak güncellenir
- Sorunlar ve tartışmalar bakımcılar tarafından izlenir
- Çeviri güncellemeleri GitHub Actions ile otomatik yapılır
### İlgili Kaynaklar
- [Microsoft Learn modülleri](https://docs.microsoft.com/learn/)
- [Öğrenci Merkezi kaynakları](https://docs.microsoft.com/learn/student-hub/)
- [Student Hub kaynakları](https://docs.microsoft.com/learn/student-hub/)
- Öğrenenler için önerilen [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
- Ek kurslar: Üretken AI, Veri Bilimi, ML, IoT müfredatları mevcut
- Ek dersler: Üretken AI, Veri Bilimi, ML, IoT müfredatları mevcut
### Belirli Projelerle Çalışmak
### Belirli Projeler ile Çalışma
Bireysel projeler için detaylı talimatlar README dosyalarında:
Bireysel projeler için ayrıntılı talimatlar aşağıdaki README dosyalarında:
- `quiz-app/README.md` - Vue 3 quiz uygulaması
- `7-bank-project/README.md` - Kimlik doğrulamalı bankacılık uygulaması
- `7-bank-project/README.md` - Kimlik doğrulamalı banka uygulaması
- `5-browser-extension/README.md` - Tarayıcı uzantısı geliştirme
- `6-space-game/README.md` - Canvas tabanlı oyun geliştirme
- `9-chat-project/README.md` - AI sohbet asistanı projesi
### Monorepo Yapısı
Geleneksel bir monorepo olmamakla birlikte, bu depo birden fazla bağımsız proje içerir:
- Her ders kendi içinde bağımsızdır
- Projeler ortak bağımlılık paylaşmaz
- Diğerlerini etkilemeden bireysel projelerde çalışılır
- Tüm müfredatı deneyimlemek için depo tamamen klonlanabilir
Geleneksel bir monorepo olmasa da, bu depo birden çok bağımsız proje içerir:
- Her ders kendi başına tamamlanabilir
- Projeler bağımlılık paylaşmaz
- Bireysel projeler üzerinde diğerlerini etkilemeden çalışabilirsiniz
- Tam müfredat deneyimi için tüm depo klonlanabilir
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Feragatname**:
Bu belge, AI çeviri hizmeti [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba sarf edilse de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucunda oluşabilecek herhangi bir yanlış anlama veya yorum hatasından sorumlu tutulamayız.
Bu belge [Co-op Translator](https://github.com/Azure/co-op-translator) adlı AI çeviri hizmeti kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayın. Orijinal belge, kendi ana dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu oluşabilecek yanlış anlamalar veya yorum hatalarından sorumlu değiliz.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save