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

Browse Source
pull/1774/head
localizeflow[bot] 2 weeks ago
parent b56c4f2f9e
commit 62372a19c0
9 changed files with 1463 additions and 1462 deletions
Show Stats Download Patch File Download Diff File

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

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T18:38:37+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T21:49:18+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "it"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T18:51:24+00:00",
"translation_date": "2026-03-27T21:58:14+00:00",
"source_file": "AGENTS.md",
"language_code": "it"
},

563
translations/it/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

284
translations/it/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Panoramica del Progetto
Questo è un repository curriculum educativo 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.
Questo è un repository per un curriculum educativo 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**: Terrarium, Gioco di Digitazione, Estensione del 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 automatiche per oltre 50 lingue tramite GitHub Actions
- **Contenuto Educativo**: 24 lezioni strutturate organizzate in moduli basati su progetti
- **Progetti Pratici**: Terrarium, Gioco di Digitazione, Estensione per 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 più di 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 delle lezioni contiene README, esempi di codice e soluzioni
- Ogni cartella lezione contiene README, esempi di codice e soluzioni
- Progetti autonomi in directory separate (quiz-app, vari progetti di lezione)
- Sistema di traduzione tramite GitHub Actions (co-op-translator)
- Documentazione servita tramite Docsify e disponibile in PDF
## Comandi di Configurazione
Questo repository è principalmente destinato al consumo di contenuti educativi. Per lavorare con progetti specifici:
Questo repository è principalmente per il consumo di contenuti educativi. Per lavorare con progetti specifici:
### Configurazione Principale del Repository
@ -41,7 +41,7 @@ npm run build # Compila per la produzione
npm run lint # Esegui ESLint
```
### API del Progetto Bancario (Node.js + Express)
### API Progetto Bancario (Node.js + Express)
```bash
cd 7-bank-project/api
@ -78,35 +78,35 @@ python api.py
## Flusso di Lavoro per lo Sviluppo
### Per i Collaboratori di Contenuti
### Per i Collaboratori dei Contenuti
1. **Effettuare il fork del repository** sul proprio account GitHub
2. **Clonare il fork** localmente
3. **Creare un nuovo branch** per le modifiche
4. Apportare modifiche ai contenuti delle lezioni o agli esempi di codice
5. Testare eventuali modifiche al codice nelle directory di progetto rilevanti
6. Inviare pull request seguendo le linee guida di contributo
1. **Fork del repository** nel tuo account GitHub
2. **Clona il tuo fork** in locale
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 di progetto rilevanti
6. Invia pull request seguendo le linee guida di contributo
### Per gli Studenti
1. Fare il fork o clonare il repository
2. Navigare sequenzialmente nelle directory delle lezioni
3. Leggere i file README di ogni lezione
4. Completare i quiz pre-lezione su https://ff-quizzes.netlify.app/web/
5. Lavorare sugli esempi di codice nelle cartelle delle lezioni
6. Completare compiti e sfide
7. Sostenere i quiz post-lezione
1. Fai fork o clona il repository
2. Naviga nelle cartelle delle lezioni in ordine
3. Leggi i file README di 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 compiti e sfide
7. Sostieni i quiz post-lezione
### Sviluppo Live
### Sviluppo in Diretta
- **Documentazione**: Eseguire `docsify serve` nella root (porta 3000)
- **Quiz App**: Eseguire `npm run dev` nella directory quiz-app
- **Progetti**: Usare l’estensione Live Server di VS Code per progetti HTML
- **Progetti API**: Eseguire `npm start` nelle rispettive directory API
- **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 i progetti HTML
- **Progetti API**: esegui `npm start` nelle directory API corrispondenti
## Istruzioni per il Testing
## Istruzioni per il Test
### Testing Quiz App
### Test Quiz App
```bash
cd quiz-app
@ -114,66 +114,66 @@ npm run lint # Controlla problemi di stile del codice
npm run build # Verifica che la compilazione abbia successo
```
### Testing API Bancaria
### Test API Bancaria
```bash
cd 7-bank-project/api
npm run lint # Controlla la presenza di problemi nello 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:
- Esecuzione degli esempi di codice senza errori
- I test manuali si concentrano su:
- Esecuzione senza errori degli esempi di codice
- Funzionamento corretto dei link nella documentazione
- Completamento con successo delle build dei progetti
- Aderenza degli esempi alle migliori pratiche
- Build dei progetti completati con successo
- Gli esempi seguono le migliori pratiche
### Controlli Pre-Invio
### Controlli Pre-Consegna
- Eseguire `npm run lint` nelle directory con package.json
- Verificare che i link markdown siano validi
- Testare gli esempi di codice nel browser o in Node.js
- Controllare che le traduzioni mantengano la struttura corretta
- Esegui `npm run lint` nelle directory con package.json
- Verifica che i link markdown siano validi
- Testa esempi di codice in browser o Node.js
- Controlla che le traduzioni mantengano la struttura corretta
## Linee Guida per lo Stile del Codice
## Linee Guida di Stile del Codice
### JavaScript
- Usare sintassi moderna ES6+
- Seguire le configurazioni standard ESLint fornite nei progetti
- Usare nomi di variabili e funzioni significativi per chiarezza educativa
- Aggiungere commenti che spiegano i concetti per gli studenti
- Formattare usando Prettier dove configurato
- Usa sintassi moderna ES6+
- Segui le configurazioni ESLint standard fornite nei progetti
- Usa nomi di variabili e funzioni significativi per chiarezza educativa
- Aggiungi commenti che spiegano i concetti agli studenti
- Format con Prettier dove configurato
### HTML/CSS
- Elementi semantici HTML5
- Principi di design responsivo
- Convenzioni chiare per la denominazione delle classi
- Elementi HTML5 semantici
- Principi di design responsive
- Convenzioni chiare per nomi delle classi
- Commenti che spiegano tecniche CSS per studenti
### Python
- Linee guida di stile PEP 8
- Esempi di codice chiari ed educativi
- Annotazioni di tipo dove utili per l’apprendimento
- Esempi di codice chiari e didattici
- Hint tipi dove utile per l’apprendimento
### Documentazione Markdown
- Chiara gerarchia delle intestazioni
- Blocchi di codice con specificazione del linguaggio
- Gerarchia chiara delle intestazioni
- Blocchi di codice con specifica di linguaggio
- Link a risorse aggiuntive
- Screenshot e immagini nelle directory `images/`
- Testo alternativo per le immagini per accessibilità
- Screenshot e immagini nelle cartelle `images/`
- Testo alternativo per immagini per accessibilità
### Organizzazione dei File
- Lezioni numerate progressivamente (1-getting-started-lessons, 2-js-basics, ecc.)
- Ogni progetto ha cartelle `solution/` e spesso `start/` o `your-work/`
- Immagini conservate nelle cartelle `images/` specifiche delle lezioni
- Lezioni numerate sequenzialmente (1-getting-started-lessons, 2-js-basics, ecc.)
- Ogni progetto ha directory `solution/` e spesso `start/` o `your-work/`
- Immagini archiviate in cartelle `images/` specifiche per lezione
- Traduzioni nella struttura `translations/{language-code}/`
## Build e Distribuzione
@ -185,7 +185,7 @@ La quiz-app è configurata per la distribuzione su Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Crea la cartella dist/
# Effettua il deploy tramite il workflow di GitHub Actions al push su main
# Esegue il deployment tramite workflow GitHub Actions al push su main
```
Configurazione Azure Static Web Apps:
@ -204,23 +204,23 @@ npm run convert # Genera PDF da docs
```bash
npm install -g docsify-cli # Installa Docsify globalmente
docsify serve # Servi su localhost:3000
docsify serve # Serve su localhost:3000
```
### Build Specifiche dei Progetti
### Build Specifici per Progetto
Ogni directory di progetto può avere il proprio processo di build:
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
Usare titoli chiari e descrittivi indicando l’area di modifica:
- `[Quiz-app] Aggiungi nuovo quiz per la lezione X`
Usa titoli chiari e descrittivi che indicano l’area di modifica:
- `[Quiz-app] Aggiungi nuovo quiz per lezione X`
- `[Lesson-3] Correggi errore di battitura nel progetto terrarium`
- `[Translation] Aggiungi traduzione spagnola per la lezione 5`
- `[Translation] Aggiungi traduzione spagnola per lezione 5`
- `[Docs] Aggiorna istruzioni di configurazione`
### Controlli Richiesti
@ -228,33 +228,33 @@ Usare titoli chiari e descrittivi indicando l’area di modifica:
Prima di inviare una PR:
1. **Qualità del Codice**:
- Eseguire `npm run lint` nelle directory di progetto interessate
- Correggere tutti gli errori e avvertimenti lint
- Esegui `npm run lint` nelle directory di progetto interessate
- Risolvi tutti gli errori e avvisi di linting
2. **Verifica della Build**:
- Eseguire `npm run build` se applicabile
- Assicurarsi che non vi siano errori di build
2. **Verifica Build**:
- Esegui `npm run build` se applicabile
- Assicurati che non ci siano errori di build
3. **Validazione Link**:
- Testare tutti i link markdown
- Verificare che i riferimenti alle immagini funzionino
- Testa tutti i link markdown
- Verifica che i riferimenti alle immagini funzionino
4. **Revisione Contenuto**:
- Correggere ortografia e grammatica
- Assicurarsi che gli esempi di codice siano corretti ed educativi
- Verificare che le traduzioni mantengano il significato originale
- Controlla ortografia e grammatica
- Assicurati che gli esempi di codice siano corretti e didattici
- Verifica che le traduzioni mantengano il significato originale
### Requisiti di Contributo
### Requisiti per il Contributo
- Accettare il CLA Microsoft (controllo automatico alla prima PR)
- Seguire il [Codice di Condotta Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Consultare [CONTRIBUTING.md](./CONTRIBUTING.md) per linee guida dettagliate
- Fare riferimento ai numeri delle issue nella descrizione PR se applicabile
- Accetta il CLA Microsoft (controllo automatico 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
- Riferisci i numeri degli issue nella descrizione della PR se applicabile
### Processo di Revisione
- Le PR sono revisionate dai responsabili e dalla community
- Si dà priorità alla chiarezza educativa
- Le PR sono revisionate da manutentori e comunità
- Priorità alla chiarezza educativa
- Gli esempi di codice devono seguire le migliori pratiche correnti
- Le traduzioni sono revisionate per accuratezza e adeguatezza culturale
@ -265,18 +265,18 @@ Prima di inviare una PR:
- Usa GitHub Actions con workflow co-op-translator
- Traduce automaticamente in oltre 50 lingue
- File sorgente nelle directory principali
- File tradotti in directory `translations/{language-code}/`
- File tradotti nelle directory `translations/{language-code}/`
### Aggiunta di Miglioramenti Manuali alle Traduzioni
### Aggiunta di Miglioramenti Manuali alla Traduzione
1. Trovare il file in `translations/{language-code}/`
2. Apportare miglioramenti mantenendo la struttura
3. Assicurarsi che gli esempi di codice restino funzionanti
4. Testare eventuali contenuti del quiz localizzati
1. Trova il file in `translations/{language-code}/`
2. Effettua miglioramenti mantenendo la struttura
3. Assicurati che gli esempi di codice rimangano funzionanti
4. Testa eventuale contenuto quiz localizzato
### Metadati della Traduzione
I file tradotti includono intestazione metadata:
I file tradotti includono header metadati:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -294,102 +294,102 @@ CO_OP_TRANSLATOR_METADATA:
### Problemi Comuni
**Quiz app non si avvia**:
- Controllare versione Node.js (consigliata v14+)
- Cancellare `node_modules` e `package-lock.json`, eseguire di nuovo `npm install`
- Verificare conflitti di porta (default: Vite usa porta 5173)
- Controlla versione Node.js (consigliato v14+)
- Elimina `node_modules` e `package-lock.json`, esegui di nuovo `npm install`
- Controlla conflitti di porta (default: Vite usa porta 5173)
**Server API non si avvia**:
- Verificare che la versione Node.js sia minima (node >=10)
- Controllare se la porta è già in uso
- Assicurarsi che tutte le dipendenze siano installate con `npm install`
- Verifica versione minima Node.js (node >=10)
- Controlla se la porta è già in uso
- Assicurati che tutte le dipendenze siano installate con `npm install`
**Estensione browser non si carica**:
- Verificare che manifest.json sia formattato correttamente
- Controllare la console del browser per errori
- Seguire le istruzioni specifiche del browser per l’installazione delle estensioni
- Controlla che manifest.json sia formattato correttamente
- Controlla la console del browser per errori
- Segui istruzioni specifiche per installazione estensioni browser
**Problemi progetto chat Python**:
- Assicurarsi che il pacchetto OpenAI sia installato: `pip install openai`
- Verificare che la variabile d’ambiente GITHUB_TOKEN sia impostata
- Controllare i permessi di accesso ai modelli GitHub
- Assicurati che il pacchetto OpenAI sia installato: `pip install openai`
- Verifica che la variabile ambiente GITHUB_TOKEN sia impostata
- Controlla permessi di accesso GitHub Models
**Docsify non serve la documentazione**:
- Installare docsify-cli globalmente: `npm install -g docsify-cli`
- Eseguire dalla directory root del repository
- Verificare che `docs/_sidebar.md` esista
- Installa docsify-cli globalmente: `npm install -g docsify-cli`
- Esegui dalla directory root del repository
- Controlla che `docs/_sidebar.md` esista
### Consigli per l’Ambiente di Sviluppo
- Usare VS Code con estensione Live Server per progetti HTML
- Installare estensioni ESLint e Prettier per formattazione coerente
- Usare gli strumenti DevTools del browser per il debug di JavaScript
- Per progetti Vue, installare l’estensione Vue DevTools per browser
- Usa VS Code con estensione Live Server per progetti HTML
- Installa estensioni ESLint e Prettier per formattazione coerente
- Usa DevTools del browser per il debug JavaScript
- Per progetti Vue, installa estensione browser Vue DevTools
### Considerazioni sulle Prestazioni
- L’elevato numero di file tradotti (oltre 50 lingue) rende le clone complete grandi
- Usare clone superficiale se si lavora solo sui contenuti: `git clone --depth 1`
- Escludere le traduzioni dalle ricerche quando si lavora su contenuti in inglese
- I processi di build possono essere lenti al primo avvio (npm install, build Vite)
- Il gran numero di file tradotti (oltre 50 lingue) rende i clone completi grandi
- Usa clone superficiale se lavori solo sui contenuti: `git clone --depth 1`
- Escludi traduzioni dalle ricerche quando lavori sui contenuti in inglese
- I processi di build possono essere lenti alla prima esecuzione (npm install, build Vite)
## Considerazioni sulla Sicurezza
### Variabili di Ambiente
### Variabili d’Ambiente
- Le chiavi API non devono mai essere inserite nel repository
- Usare file `.env` (già inclusi in `.gitignore`)
- Documentare le variabili di ambiente richieste nei README dei progetti
- Le chiavi API non devono mai essere committate nel repository
- Usa file `.env` (già in `.gitignore`)
- Documenta le variabili ambiente richieste nei README dei progetti
### Progetti Python
- Usare ambienti virtuali: `python -m venv venv`
- Mantenere aggiornate le dipendenze
- Usa ambienti virtuali: `python -m venv venv`
- Mantieni aggiornate le dipendenze
- I token GitHub devono avere permessi minimi necessari
### Accesso Modelli GitHub
### Accesso ai Modelli GitHub
- Sono necessari Personal Access Tokens (PAT) per i modelli GitHub
- I token devono essere conservati come variabili di ambiente
- Non commettere mai token o credenziali
- Sono necessari Personal Access Tokens (PAT) per i Modelli GitHub
- I token devono essere conservati come variabili ambiente
- Non committare mai token o credenziali
## Note Aggiuntive
### Pubblico di Destinazione
### Pubblico Target
- Principianti completi nello sviluppo web
- Studenti e autodidatti
- Insegnanti che usano il curriculum in aula
- Contenuti progettati per accessibilità e acquisizione graduale delle competenze
- Insegnanti che utilizzano il curriculum in classe
- Contenuti progettati per accessibilità e crescita graduale delle competenze
### Filosofia Educativa
- Approccio di apprendimento basato su progetti
- Verifiche frequenti delle conoscenze (quiz)
- Esercizi di programmazione pratici
- Esempi applicativi reali
- Focus sui fondamenti prima dei framework
- Approccio basato su apprendimento tramite progetto
- Controlli di conoscenza frequenti (quiz)
- Esercizi pratici di programmazione
- Esempi di applicazione reali
- Focus sulle fondamenta prima dei framework
### Manutenzione del Repository
- Comunità attiva di studenti e collaboratori
- Aggiornamenti regolari di dipendenze e contenuti
- Issue e discussioni monitorate dai manutentori
- Aggiornamenti delle traduzioni automatizzati tramite GitHub Actions
- Monitoraggio di issue e discussioni da parte dei manutentori
- Aggiornamenti traduzioni automatizzati tramite 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: AI Generativa, Data Science, ML, curricoli IoT disponibili
- Corsi aggiuntivi: AI generativa, Data Science, ML, curricula IoT disponibili
### Lavorare con Progetti Specifici
Per istruzioni dettagliate su singoli progetti, consultare i file README in:
Per istruzioni dettagliate sui progetti singoli, 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
- `5-browser-extension/README.md` - Sviluppo estensione per browser
- `6-space-game/README.md` - Sviluppo gioco basato su Canvas
- `9-chat-project/README.md` - Progetto assistente chat AI
### Struttura Monorepo
@ -397,12 +397,12 @@ Per istruzioni dettagliate su singoli progetti, consultare i file README in:
Pur non essendo un monorepo tradizionale, questo repository contiene più progetti indipendenti:
- Ogni lezione è autonoma
- I progetti non condividono dipendenze
- Lavorare su singoli progetti senza influenzare gli altri
- Clonare l’intero repository per l’esperienza completa del curriculum
- Lavora su singoli progetti senza influire sugli altri
- Clona l'intero repository per l’esperienza completa del curriculum
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Dichiarazione di non responsabilità**:
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 imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda la traduzione professionale effettuata da un umano. Non siamo responsabili per eventuali fraintendimenti o interpretazioni errate derivanti dall’uso di questa traduzione.
**Disclaimer**:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica [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 inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un esperto umano. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T18:44:39+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T21:53:50+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "pl"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T18:52:39+00:00",
"translation_date": "2026-03-27T21:59:29+00:00",
"source_file": "AGENTS.md",
"language_code": "pl"
},

688
translations/pl/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

412
translations/pl/AGENTS.md
Unescape View File

@ -2,35 +2,35 @@
## Przegląd projektu
Jest to edukacyjne repozytorium z programem nauczania do nauki podstaw tworzenia stron internetowych dla początkujących. Program nauczania to kompleksowy 12-tygodniowy kurs opracowany przez Microsoft Cloud Advocates, zawierający 24 praktyczne lekcje obejmujące JavaScript, CSS i HTML.
To jest repozytorium edukacyjne do nauczania podstaw tworzenia stron internetowych dla początkujących. Program nauczania to kompleksowy 12-tygodniowy kurs opracowany przez Microsoft Cloud Advocates, zawierający 24 praktyczne lekcje obejmujące JavaScript, CSS i HTML.
### Kluczowe elementy
- **Treści edukacyjne**: 24 ustrukturyzowane lekcje zorganizowane w moduły oparte na projektach
- **Projekty praktyczne**: Terrarium, Gra pisania na klawiaturze, Rozszerzenie przeglądarki, Gra kosmiczna, Aplikacja bankowa, Edytor kodu i 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 przez GitHub Actions
- **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (dla projektów AI)
- **Treści edukacyjne**: 24 uporządkowane lekcje zorganizowane w moduły oparte na projektach
- **Praktyczne projekty**: Terrarium, Gra pisania, Rozszerzenie przeglądarki, Gra kosmiczna, Aplikacja bankowa, Edytor kodu i Asystent czatu AI
- **Interaktywne quizy**: 48 quizów po 3 pytania każdy (oceny przed/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ą opartą na lekcjach
- Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania
- Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcyjne)
- System tłumaczeń wykorzystujący GitHub Actions (co-op-translator)
- Dokumentacja serwowana przez Docsify i dostępna jako PDF
- Edukacyjne repozytorium o strukturze opartej na lekcjach
- Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania
- Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcyjne)
- System tłumaczeń wykorzystujący GitHub Actions (co-op-translator)
- Dokumentacja udostępniana przez Docsify oraz dostępna w formacie PDF
## Komendy konfiguracji
To repozytorium jest głównie do konsumpcji treści edukacyjnych. Do pracy z konkretnymi projektami:
To repozytorium służy głównie do konsumpcji treści edukacyjnych. Aby pracować z konkretnymi projektami:
### Konfiguracja repozytorium głównego
### Konfiguracja głównego repozytorium
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Konfiguracja aplikacji Quiz (Vue 3 + Vite)
```bash
@ -40,25 +40,25 @@ npm run dev # Uruchom serwer deweloperski
npm run build # Kompiluj do produkcji
npm run lint # Uruchom ESLint
```
### API projektu bankowego (Node.js + Express)
### Bankowy projekt 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ą Prettier
npm run format # Formatowanie za pomocą Prettier
```
### Projekty rozszerzenia przeglądarki
### Projekty rozszerzeń przeglądarki
```bash
cd 5-browser-extension/solution
npm install
# Postępuj zgodnie z instrukcjami ładowania rozszerzeń specyficznymi dla przeglądarki
# Postępuj zgodnie z instrukcjami ładowania rozszerzenia specyficznymi dla przeglądarki
```
### Projekty gry kosmicznej
```bash
@ -66,7 +66,7 @@ cd 6-space-game/solution
npm install
# Otwórz index.html w przeglądarce lub użyj Live Server
```
### Projekt czatu (backend Python)
```bash
@ -75,34 +75,34 @@ pip install openai
# Ustaw zmienną środowiskową GITHUB_TOKEN
python api.py
```
## Przebieg rozwoju
### Dla osób dodających treści
### Dla współtwórców treści
1. **Sforkuj repozytorium** na swoje konto GitHub
2. **Sklonuj swoją kopię** lokalnie
3. **Utwórz nową gałąź** dla swoich zmian
4. Wprowadź zmiany w treści lekcji lub przykładach kodu
5. Przetestuj zmieniany kod w odpowiednich katalogach projektów
6. Prześlij pull requesty zgodnie z wytycznymi współpracy
1. **Zrób fork repozytorium** na swoje konto GitHub
2. **Sklonuj swój fork** lokalnie
3. **Utwórz nową gałąź** dla swoich zmian
4. Wprowadź zmiany w treści lekcji lub przykładach kodu
5. Przetestuj zmiany w kodzie w odpowiednich folderach projektów
6. Prześlij pull request zgodnie z wytycznymi dotyczącymi kontrybucji
### Dla uczących się
### Dla uczniów
1. Sforkuj lub sklonuj repozytorium
2. Przechodź kolejno do katalogów lekcji
3. Czytaj pliki README dla każdej lekcji
4. Wypełnij quizy przed lekcją na https://ff-quizzes.netlify.app/web/
5. Pracuj nad przykładami kodu w folderach lekcji
6. Wykonaj zadania i wyzwania
7. Przystąp do quizów po lekcji
1. Zrób fork lub sklonuj repozytorium
2. Przechodź kolejno do folderów lekcji
3. Czytaj pliki README każdej lekcji
4. Wykonaj quizy przed lekcją na https://ff-quizzes.netlify.app/web/
5. Pracuj poprzez przykłady kodu w folderach lekcji
6. Wykonuj zadania i wyzwania
7. Wykonaj quizy po lekcji
### Praca na żywo
### Programowanie na żywo
- **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000)
- **Aplikacja Quiz**: 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
- **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000)
- **Aplikacja Quiz**: Uruchom `npm run dev` w katalogu quiz-app
- **Projekty**: Użyj rozszerzenia Live Server w VS Code dla projektów HTML
- **Projekty API**: Uruchom `npm start` w odpowiednich katalogach API
## Instrukcje testowania
@ -111,74 +111,74 @@ python api.py
```bash
cd quiz-app
npm run lint # Sprawdź problemy ze stylem kodu
npm run build # Zweryfikuj pomyślność kompilacji
npm run build # Zweryfikuj, czy kompilacja zakończyła się sukcesem
```
### Testowanie API bankowego
### Testowanie API Bankowego
```bash
cd 7-bank-project/api
npm run lint # Sprawdź problemy ze stylem kodu
node server.js # Zweryfikuj, czy serwer uruchamia się bez błędów
node server.js # Sprawdź, czy serwer uruchamia się bez błędów
```
### Ogólne podejście do testowania
- To jest repozytorium edukacyjne bez kompleksowych testów automatycznych
- Testowanie manualne koncentruje się na:
- Przykłady kodu działają bez błędów
- Linki w dokumentacji działają prawidłowo
- Budowy projektów wykonują się poprawnie
- Przykłady przestrzegają najlepszych praktyk
- To repozytorium edukacyjne bez kompleksowych testów automatycznych
- Testy manualne koncentrują się na:
- Prawidłowym działaniu przykładów kodu
- Poprawności linków w dokumentacji
- Powodzeniu procesu budowania projektów
- Przestrzeganiu najlepszych praktyk w przykładach
### Sprawdzenia przed zatwierdzeniem
### Sprawdzenia przed wysłaniem
- Uruchom w katalogach z package.json `npm run lint`
- Zweryfikuj poprawność linków markdown
- Testuj przykłady kodu w przeglądarce lub Node.js
- Sprawdź czy tłumaczenia zachowują odpowiednią strukturę
- Uruchom `npm run lint` w katalogach zawierających package.json
- Zweryfikuj poprawność linków w markdownie
- Przetestuj przykłady kodu w przeglądarce lub Node.js
- Sprawdź, czy tłumaczenia zachowują odpowiednią strukturę
## Wytyczne stylu kodu
## Wytyczne dotyczące stylu kodu
### JavaScript
- Używaj nowoczesnej składni ES6+
- Przestrzegaj standardowej konfiguracji ESLint oferowanej w projektach
- Nadawaj znaczące nazwy zmiennym i funkcjom dla czytelności edukacyjnej
- Dodawaj komentarze tłumaczące koncepcje dla uczniów
- Formatowanie używaj Prettier tam, gdzie jest skonfigurowany
- Używaj nowoczesnej składni ES6+
- Przestrzegaj standardowych konfiguracji ESLint udostępnianych w projektach
- Stosuj sensowne nazwy zmiennych i funkcji dla przejrzystości edukacyjnej
- Dodawaj komentarze wyjaśniające koncepcje dla uczniów
- Formatuj kod za pomocą Prettier tam, gdzie jest skonfigurowany
### HTML/CSS
- Semantyczne elementy HTML5
- Zasady responsywnego designu
- Jasne nazewnictwo klas
- Komentarze tłumaczące techniki CSS dla uczniów
- Semantyczne elementy HTML5
- Zasady responsywnego projektowania
- Jasne konwencje nazewnictwa klas
- Komentarze wyjaśniające techniki CSS dla uczniów
### Python
- Zasady stylu PEP 8
- Jasne, edukacyjne przykłady kodu
- W razie potrzeby wskazówki typów dla nauki
- Wytyczne stylu PEP 8
- Przejrzyste, edukacyjne przykłady kodu
- Typowanie tam, gdzie pomaga to w nauce
### Dokumentacja Markdown
- Jasna hierarchia nagłówków
- Bloki kodu z podaniem języka
- Linki do dodatkowych zasobów
- Zrzuty ekranu i obrazy w katalogach `images/`
- Teksty alternatywne dla obrazów zapewniające dostępność
- Jasna hierarchia nagłówków
- Bloki kodu ze wskazaniem języka
- Linki do dodatkowych zasobów
- Zrzuty ekranu i obrazy w katalogach `images/`
- Tekst alternatywny dla obrazów dla dostępności
### Organizacja plików
- Lekcje ponumerowane kolejno (1-getting-started-lessons, 2-js-basics itd.)
- Każdy projekt ma katalogi `solution/` i często `start/` lub `your-work/`
- Obrazy przechowywane w folderach `images/` specyficznych dla lekcji
- Tłumaczenia w strukturze `translations/{language-code}/`
- Lekcje ponumerowane kolejno (1-getting-started-lessons, 2-js-basics, itd.)
- Każdy projekt posiada katalog `solution/` i często `start/` lub `your-work/`
- Obrazy przechowywane w specyficznych dla lekcji folderach `images/`
- Tłumaczenia w strukturze `translations/{language-code}/`
## Budowanie i wdrażanie
## Budowa i wdrożenie
### Wdrażanie aplikacji Quiz (Azure Static Web Apps)
### Wdrożenie aplikacji Quiz (Azure Static Web Apps)
quiz-app jest skonfigurowany do wdrożenia na Azure Static Web Apps:
@ -187,96 +187,96 @@ cd quiz-app
npm run build # Tworzy folder dist/
# Wdraża za pomocą workflow GitHub Actions przy pushu do main
```
Konfiguracja Azure Static Web Apps:
- **Lokalizacja aplikacji**: `/quiz-app`
- **Lokalizacja wynikowa**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Konfiguracja Azure Static Web Apps:
- **Lokalizacja aplikacji**: `/quiz-app`
- **Lokalizacja wyjściowa**: `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 plik PDF z dokumentów
npm run convert # Wygeneruj PDF z docs
```
### Dokumentacja Docsify
```bash
npm install -g docsify-cli # Zainstaluj Docsify globalnie
docsify serve # Serwuj na localhost:3000
```
### Budowy specyficzne dla projektów
Każdy katalog projektowy może mieć własny proces budowy:
- Projekty Vue: `npm run build` tworzy paczki produkcyjne
- Projekty statyczne: brak kroku budowy, służenie plików bezpośrednio
### Budowanie projektów specyficznych
Każdy katalog projektu może mieć własny proces budowania:
- Projekty Vue: `npm run build` tworzy paczki produkcyjne
- Projekty statyczne: brak kroku budowania, serwuj pliki bezpośrednio
## Wytyczne do pull requestów
## Wytyczne dotyczące pull requestów
### Format tytułu
Używaj jasnych, opisowych tytułów wskazujących obszar zmian:
- `[Quiz-app] Dodaj nowy quiz dla lekcji X`
- `[Lesson-3] Popraw literówkę w projekcie terrarium`
- `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5`
- `[Docs] Aktualizuj instrukcje konfiguracji`
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 dla lekcji 5`
- `[Docs] Zaktualizuj instrukcje konfiguracji`
### Wymagane sprawdzenia
### Wymagane kontrole
Przed przesłaniem PR:
Przed przesłaniem PR:
1. **Jakość kodu**:
- Uruchom `npm run lint` w dotkniętych katalogach projektów
- Napraw wszystkie błędy i ostrzeżenia
1. **Jakość kodu**:
- Uruchom `npm run lint` w dotkniętych katalogach projektów
- Napraw wszystkie błędy i ostrzeżenia lintingu
2. **Weryfikacja budowy**:
- Uruchom `npm run build`, jeśli dotyczy
- Upewnij się, że nie występują błędy budowy
2. **Weryfikacja budowy**:
- Uruchom `npm run build` jeśli dotyczy
- Upewnij się, że nie ma błędów budowania
3. **Walidacja linków**:
- Przetestuj wszystkie linki markdown
- Zweryfikuj, czy odwołania do obrazów działają
3. **Weryfikacja linków**:
- Przetestuj wszystkie linki markdown
- Zweryfikuj odwołania do obrazów
4. **Przegląd treści**:
- Sprawdź pisownię i gramatykę
- Upewnij się, że przykłady kodu są poprawne i edukacyjne
- Zweryfikuj, że tłumaczenia zachowują oryginalne znaczenie
4. **Przegląd treści**:
- Poprawność ortograficzna i gramatyczna
- Prawidłowość i edukacyjna wartość przykładów kodu
- Wierność tłumaczeń oryginalnemu znaczeniu
### Wymagania dotyczące współpracy
### Wymagania dotyczące kontrybucji
- Zgoda na Microsoft CLA (automatyczna kontrola przy pierwszym PR)
- Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Szczegóły w [CONTRIBUTING.md](./CONTRIBUTING.md)
- Jeśli stosowne, uwzględniaj numery issue w opisie PR
- Zgoda na Microsoft CLA (automatyczna weryfikacja przy pierwszym PR)
- Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Zobacz [CONTRIBUTING.md](./CONTRIBUTING.md) dla szczegółowych wytycznych
- Zamieszczaj numery issue w opisie PR, jeśli dotyczy
### Proces przeglądu
### Proces recenzji
- PRy przeglądane przez opiekunów i społeczność
- Priorytetem jest jasność edukacyjna
- Przykłady kodu powinny przestrzegać aktualnych najlepszych praktyk
- Tłumaczenia poddawane przeglądowi pod kątem dokładności i adekwatności kulturowej
- PR-y są recenzowane przez opiekunów i społeczność
- Priorytet wręczany jasności edukacyjnej
- Przykłady kodu powinny stosować aktualne najlepsze praktyki
- Tłumaczenia są sprawdzane pod kątem dokładności i zgodności kulturowej
## System tłumaczeń
### Tłumaczenia automatyczne
### Automatyczne tłumaczenia
- Wykorzystuje GitHub Actions z workflow co-op-translator
- Automatyczne tłumaczenia na ponad 50 języków
- Pliki źródłowe w głównych katalogach
- Przetłumaczone pliki w folderach `translations/{language-code}/`
- Wykorzystuje GitHub Actions z workflow co-op-translator
- Automatycznie tłumaczy na 50+ języków
- Pliki źródłowe w głównych katalogach
- Tłumaczenia w katalogach `translations/{language-code}/`
### Dodawanie ręcznych ulepszeń tłumaczeń
1. Znajdź plik w `translations/{language-code}/`
2. Wprowadź poprawki, zachowując strukturę
3. Upewnij się, że przykłady kodu działają poprawnie
4. Przetestuj przetłumaczone treści quizów
1. Zlokalizuj plik w `translations/{language-code}/`
2. Wprowadź poprawki zachowując strukturę
3. Upewnij się, że przykłady kodu pozostają działające
4. Przetestuj wszelki zlokalizowany quiz
### Metadane tłumaczeń
Przetłumaczone pliki zawierają nagłówek metadanych:
Przetłumaczone pliki zawierają nagłówek metadanych:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## Debugowanie i rozwiązywanie problemów
### Typowe problemy
**Aplikacja quiz nie uruchamia się:**
- Sprawdź wersję Node.js (zalecana v14+)
- Usuń `node_modules` i `package-lock.json`, uruchom ponownie `npm install`
- Sprawdź konflikty portów (domyślnie Vite używa portu 5173)
**Aplikacja quiz nie uruchamia się**:
- Sprawdź wersję Node.js (zalecana v14+)
- Usuń `node_modules` i `package-lock.json`, uruchom ponownie `npm install`
- Sprawdź konflikty portów (domyślnie Vite korzysta z portu 5173)
**Serwer API nie startuje:**
- Upewnij się, że wersja Node.js jest co najmniej 10
- Sprawdź, czy port nie jest zajęty
- Zweryfikuj instalację wszystkich zależności (`npm install`)
**Serwer API nie startuje**:
- Zweryfikuj minimalną wersję Node.js (node >=10)
- Sprawdź, czy port nie jest już zajęty
- Upewnij się, że wszystkie zależności są zainstalowane przez `npm install`
**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 konkretnej przeglądarki
**Rozszerzenie przeglądarki się nie ładuje**:
- Sprawdź poprawność pliku manifest.json
- Sprawdź konsolę przeglądarki pod kątem błędów
- Postępuj zgodnie z instrukcjami instalacji dla przeglądarki
**Problemy z projektem czatu Python:**
- Sprawdź, czy pakiet OpenAI jest zainstalowany: `pip install openai`
- Upewnij się, że zmienna środowiskowa GITHUB_TOKEN jest ustawiona
- Zweryfikuj uprawnienia dostępu do modeli GitHub
**Problemy z projektem czatu Python**:
- Upewnij się, że pakiet OpenAI jest zainstalowany: `pip install openai`
- Sprawdź, czy zmienna środowiskowa GITHUB_TOKEN jest ustawiona
- Zweryfikuj uprawnienia dostępu do modeli GitHub
**Docsify nie serwuje dokumentacji:**
- Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli`
- Uruchom z katalogu głównego repozytorium
- Sprawdź, czy istnieje plik `docs/_sidebar.md`
**Docsify nie serwuje dokumentacji**:
- Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli`
- Uruchom z katalogu głównego repozytorium
- Sprawdź, czy istnieje `docs/_sidebar.md`
### Wskazówki dotyczące środowiska deweloperskiego
- Używaj VS Code z rozszerzeniem Live Server dla projektów HTML
- Zainstaluj rozszerzenia ESLint i Prettier dla spójnego formatowania
- Korzystaj z narzędzi DevTools w przeglądarce do debugowania JavaScript
- Dla projektów Vue zainstaluj Vue DevTools jako rozszerzenie przeglądarki
- 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 DevTools w przeglądarce do debugowania JavaScript
- Dla projektów Vue zainstaluj rozszerzenie Vue DevTools do przeglądarki
### Wydajność
### Rozważania dotyczące wydajności
- Duża liczba tłumaczonych plików (50+ języków) powoduje duże pełne klony
- Używaj klonowania płytkiego, jeśli pracujesz tylko nad treścią: `git clone --depth 1`
- Wyłącz tłumaczenia w wyszukiwaniu podczas pracy nad treściami angielskimi
- Procesy budowy mogą być powolne przy pierwszym uruchomieniu (npm install, build Vite)
- Duża liczba przetłumaczonych plików (50+ języków) powoduje duże klony repozytorium
- 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ą zawartością
- Procesy budowania mogą być wolne przy pierwszym uruchomieniu (npm install, budowa Vite)
## Aspekty bezpieczeństwa
## Rozważania bezpieczeństwa
### Zmienne środowiskowe
- Klucze API nigdy nie powinny być zatwierdzane do repozytorium
- Używaj plików `.env` (już w `.gitignore`)
- Wymagane zmienne środowiskowe dokumentuj w README projektów
- Klucze API nigdy nie powinny być dodawane do repozytorium
- Używaj plików `.env` (już w `.gitignore`)
- Dokumentuj wymagane zmienne środowiskowe w README projektów
### Projekty Python
- Używaj środowisk wirtualnych: `python -m venv venv`
- Aktualizuj zależności
- Tokeny GitHub powinny mieć minimalne wymagane uprawnienia
- Używaj środowisk wirtualnych: `python -m venv venv`
- Aktualizuj zależności na bieżąco
- Tokeny GitHub powinny mieć minimalne niezbędne uprawnienia
### Dostęp do modeli GitHub
- Wymagane osobiste tokeny dostępu (PAT) dla modeli GitHub
- Tokeny przechowuj jako zmienne środowiskowe
- Nigdy nie zatwierdzaj tokenów ani haseł
- Wymagane są Personal Access Tokens (PAT) do modeli GitHub
- Tokeny przechowuj jako zmienne środowiskowe
- Nigdy nie umieszczaj tokenów ani danych uwierzytelniających w repozytorium
## Dodatkowe uwagi
### Grupa docelowa
- Kompletnych początkujących w tworzeniu stron internetowych
- Studentów i samouków
- Nauczycieli wykorzystujących program w klasach
- Treści zaprojektowane z myślą o dostępności i stopniowym budowaniu umiejętności
- Całkowici początkujący w tworzeniu stron internetowych
- Studenci i samoucy
- Nauczyciele wykorzystujący program nauczania w klasach
- Treści zaprojektowane z myślą o dostępności i stopniowym budowaniu umiejętności
### Filozofia edukacyjna
- Podejście oparte na nauce przez projekty
- Częste sprawdziany wiedzy (quizy)
- Praktyczne ćwiczenia kodowania
- Przykłady zastosowań w rzeczywistych sytuacjach
- Skupienie na podstawach przed frameworkami
- Podejście oparte na projektach
- Częste sprawdzanie wiedzy (quizy)
- Ćwiczenia praktyczne w kodowaniu
- 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 issue i dyskusji przez opiekunów
- Automatyczne aktualizacje tłumaczeń przez GitHub Actions
- Aktywna społeczność uczniów i współtwórców
- Regularne aktualizacje zależności i treści
- Monitorowanie zgłoszeń i dyskusji przez opiekunów
- Automatyzacja aktualizacji tłumaczeń przez GitHub Actions
### Powiązane zasoby
- [Moduły Microsoft Learn](https://docs.microsoft.com/learn/)
- [Zasoby Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) polecany dla uczących się
- Dodatkowe kursy: Generatywna AI, Data Science, ML, IoT
- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) zalecany dla uczniów
- Dodatkowe kursy: Generatywne AI, Data Science, ML, IoT dostępne
### Praca z konkretnymi projektami
Szczegółowe instrukcje dotyczące konkretnych projektów znajdują się w README:
- `quiz-app/README.md` - aplikacja quizowa Vue 3
- `7-bank-project/README.md` - aplikacja bankowa z uwierzytelnianiem
- `5-browser-extension/README.md` - rozwój rozszerzenia przeglądarki
- `6-space-game/README.md` - gra oparta na canvas
- `9-chat-project/README.md` - projekt asystenta czatu AI
Szczegółowe instrukcje do poszczególnych projektów znajdują się w plikach README:
- `quiz-app/README.md` - aplikacja quizowa Vue 3
- `7-bank-project/README.md` - aplikacja bankowa z uwierzytelnianiem
- `5-browser-extension/README.md` - rozwój rozszerzeń przeglądarki
- `6-space-game/README.md` - rozwój gry na canvasie
- `9-chat-project/README.md` - projekt asystenta czatu AI
### Struktura monorepo
Choć to nie tradycyjne monorepo, repozytorium zawiera wiele niezależnych projektów:
- Każda lekcja jest samodzielna
- Projekty nie dzielą zależności
- Pracuj nad indywidualnymi projektami bez wpływu na inne
- Sklonuj całe repo dla pełnego doświadczenia programu nauczania
Chociaż to nie jest tradycyjne monorepo, repozytorium zawiera wiele niezależnych projektów:
- Każda lekcja jest samodzielna
- Projekty nie dzielą zależności
- Pracuj nad indywidualnymi projektami bez wpływu na inne
- Sklonuj całe repozytorium, aby uzyskać pełne doświadczenie kursu
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**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). Choć dokładamy wszelkich starań, aby tłumaczenie było precyzyjne, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym należy traktować jako źródło autorytatywne. W przypadku informacji krytycznych zaleca się skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.
**Zastrzeżenie**:
Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczenia AI [Co-op Translator](https://github.com/Azure/co-op-translator). Chociaż dążymy do dokładności, prosimy mieć na uwadze, że tłumaczenia automatyczne mogą zawierać błędy lub niedokładności. Oryginalny dokument w jego rodzimym języku powinien być uznawany za źródło autorytatywne. 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.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T18:50:19+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T21:57:03+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "tr"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T18:53:47+00:00",
"translation_date": "2026-03-27T22:00:27+00:00",
"source_file": "AGENTS.md",
"language_code": "tr"
},

668
translations/tr/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

292
translations/tr/AGENTS.md
Unescape View File

@ -2,15 +2,15 @@
## Proje Genel Bakış
Bu, başlangıç seviyesindeki kişilere web geliştirme temel bilgilerini öğretmek için hazırlanmış eğitici 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.
Bu, web geliştirme temellerini yeni başlayanlara öğretmek için hazırlanmış eğitim amaçlı bir müfredat deposudur. Müfredat, Microsoft Cloud Advocates tarafından geliştirilen kapsamlı bir 12 haftalık kurstur ve JavaScript, CSS ve HTML'i kapsayan 24 uygulamalı ders içerir.
### Ana Bileşenler
- **Eğitici İçerik**: Proje bazlı modüllere organize edilmiş 24 yapılandırılmış ders
- **Pratik Projeler**: Terrarium, Yazma Oyunu, Tarayıcı Uzantısı, Uzay Oyunu, Bankacılık Uygulaması, Kod Editörü ve Yapay Zeka Sohbet Asistanı
- **Etkileşimli Quizler**: Her biri 3 sorudan oluşan 48 quiz (ders öncesi/sonrası değerlendirmeleri)
- **Çok Dilli Destek**: GitHub Actions ile 50+ dilde otomatik çeviriler
- **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (Yapay Zeka projeleri için)
- **Eğitim İçeriği**: Proje tabanlı modüllere 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 Quizler**: Her biri 3 sorudan oluşan 48 quiz (ders öncesi/sonrası değerlendirmeler)
- **Çoklu Dil Desteği**: GitHub Actions ile 50+ dilde otomatik çeviri
- **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projeleri için)
### Mimari
@ -18,11 +18,11 @@ Bu, başlangıç seviyesindeki kişilere web geliştirme temel bilgilerini öğr
- Her ders klasörü README, kod örnekleri ve çözümler içerir
- Ayrı dizinlerde bağımsız projeler (quiz-app, çeşitli ders projeleri)
- GitHub Actions kullanan çeviri sistemi (co-op-translator)
- Docsify ile sunulan dokümantasyon ve PDF olarak erişilebilirlik
- Docsify ile sunulan ve PDF olarak erişilebilir dokümantasyon
## Kurulum Komutları
Bu depo esas olarak eğitim içeriğinin tüketimi içindir. Belirli projelerle çalışmak için:
Bu depo öncelikle eğitim içeriği tüketimi içindir. Belirli projelerle çalışmak için:
### Ana Depo Kurulumu
@ -67,42 +67,42 @@ npm install
# index.html dosyasını tarayıcıda açın veya Canlı Sunucu kullanın
```
### Sohbet Projesi (Python Arka Uç)
### Sohbet Projesi (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ortam değişkenini ayarlayın
# GITHUB_TOKEN ortam değişkenini ayarla
python api.py
```
## Geliştirme İş Akışı
### İçerik Katkısı Sağlayanlar için
### İçerik Katkıcıları İçin
1. Depoyu GitHub hesabınıza **forklayın**
2. Forkladığınız depoyu yerel olarak **klonlayın**
3. Değişiklikleriniz için yeni bir **dal (branch)** oluşturun
2. Forkunuzu yerel olarak **klonlayın**
3. Değişiklikleriniz için yeni bir **branch oluşturun**
4. Ders içeriği veya kod örneklerinde değişiklik yapın
5. İlgili proje klasörlerinde kod değişikliklerini test edin
6. Katkı yönergelerini takip ederek pull request gönderin
5. İlgili proje dizinlerinde kod değişikliklerini test edin
6. Katkı rehberine uygun şekilde pull request gönderin
### Öğrenenler için
### Öğrenenler İçin
1. Depoyu forklayın veya klonlayın
2. Ders klasörleri arasında sırayla gezin
2. Ders dizinlerinde sırasıyla gezin
3. Her ders için README dosyalarını okuyun
4. Ders öncesi quizlerini https://ff-quizzes.netlify.app/web/ adresinde tamamlayın
5. Ders klasörlerindeki kod örneklerini uygulayın
4. https://ff-quizzes.netlify.app/web/ adresindeki ders öncesi quizleri tamamlayın
5. Ders klasörlerindeki kod örnekleri üzerinde çalışın
6. Ödevleri ve zorlukları tamamlayın
7. Ders sonrası quizlerine katılın
7. Ders sonrası quizlere katılı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` 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
- **Dokümantasyon**: Kök dizinde `docsify serve` komutunu çalıştırın (port 3000)
- **Quiz Uygulaması**: quiz-app dizininde `npm run dev` çalıştırın
- **Projeler**: HTML projeleri için VS Code Live Server eklentisini kullanın
- **API Projeleri**: İlgili API dizinlerinde `npm start` çalıştırın
## Test Talimatları
@ -118,74 +118,74 @@ npm run build # Derlemenin başarılı olduğunu doğrula
```bash
cd 7-bank-project/api
npm run lint # Kod stili sorunlarını kontrol et
node server.js # Sunucunun hatasız başlatıldığını doğrula
npm run lint # Kod stili sorunlarını kontrol edin
node server.js # Sunucunun hatasız başlamasını doğrulayın
```
### Genel Test Yaklaşımı
- Bu, kapsamlı otomatik testler içermeyen bir eğitim deposudur
- Bu bir eğitim deposudur ve kapsamlı otomatik test içermez
- Manuel testler şunlara odaklanır:
- Kod örnekleri hatasız çalışmalı
- Dokümantasyon linkleri düzgün çalışmalı
- Proje derlemeleri başarılı şekilde tamamlanmalı
- Örnekler en iyi uygulamaları takip etmeli
- Kod örnekleri hatasız çalışıyor
- Dokümantasyondaki bağlantılar doğru çalışıyor
- Proje derlemeleri başarılı tamamlanıyor
- Örnekler en iyi uygulamalara uygun
### Gönderim Öncesi Kontroller
- package.json olan dizinlerde `npm run lint` çalıştırın
- package.json içeren dizinlerde `npm run lint` çalıştırın
- Markdown bağlantılarının geçerli olduğunu doğrulayın
- Kod örneklerini tarayıcıda veya Node.js'de test edin
- Çevirilerin yapısını koruduğundan emin olun
- Kod örneklerini tarayıcı veya Node.js'de test edin
- Çevirilerin yapı olarak doğru kaldığını kontrol edin
## Kod Stili Rehberi
## Kod Stili Yönergeleri
### JavaScript
- Modern ES6+ sözdizimi kullanın
- Projelerde sağlanan standart ESLint yapılandırmalarını uygulayın
- Eğitim amacıyla anlamlı değişken ve fonksiyon isimleri kullanın
- Öğrenenlere kavramları açıklayan yorumlar ekleyin
- Ayarlanmışsa Prettier ile biçimlendirin
- Modern ES6+ sözdizimini kullanın
- Projelerde sağlanan standart ESLint yapılandırmalarını izleyin
- Eğitim için anlaşılır değişken ve fonksiyon isimleri kullanın
- Öğrenenler için kavramları açıklayan yorumlar ekleyin
- Konfigüre edilmişse Prettier ile biçimlendirin
### HTML/CSS
- Anlamsal HTML5 öğeleri
- Duyarlı tasarım prensipleri
- Açık sınıf isimlendirme kuralları
- Öğrenenler için CSS tekniklerini açıklayan yorumlar
- Semantik HTML5 öğeleri kullanın
- Duyarlı tasarım prensipleri uygulayın
- Açık sınıf isimlendirme kuralları kullanın
- CSS tekniklerini öğrencilere açıklayan yorumlar ekleyin
### Python
- PEP 8 stil yönergeleri
- Açık, eğitici kod örnekleri
- Öğrenmeye yardımcı olabilecek tip ipuçları
- PEP 8 stil rehberini takip edin
- Açık ve eğitim odaklı kod örnekleri oluşturun
- Öğrenme için faydalı olduğunda tip ipuçları ekleyin
### Markdown Dokümantasyonu
### Markdown Dokümantasyon
- Açık başlık hiyerarşisi
- Dil belirtimi içeren kod blokları
- Ek kaynak bağlantıları
- `images/` klasörlerinde ekran görüntüleri ve resimler
- Erişilebilirlik için görüntülerde alt metin
- Dil belirtmeli kod blokları
- Ek kaynaklara bağlantılar
- `images/` dizinlerinde ekran görüntüleri ve görseller
- Erişilebilirlik için resimlerde alt metin
### Dosya Organizasyonu
- Dersler sıralı numaralandırılmış (1-getting-started-lessons, 2-js-basics, vb.)
- Her projenin `solution/` ve genellikle `start/` veya `your-work/` klasörleri var
- Resimler derslere özgü `images/` klasörlerinde saklanır
- Çeviriler `translations/{dil-kodu}/` yapısında
- Dersler sıralı numaralanmış (1-getting-started-lessons, 2-js-basics vb.)
- Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri var
- Görseller ders bazlı `images/` klasörlerinde depolanır
- Çeviriler `translations/{language-code}/` yapısında
## Derleme ve Yayınlama
### Quiz Uygulaması Yayınlama (Azure Static Web Apps)
### Quiz Uygulaması Yayını (Azure Static Web Apps)
quiz-app Azure Static Web Apps yayınlama için yapılandırılmıştır:
Quiz-app, Azure Static Web Apps yayını için ayarlanmış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ışıyla dağıtım yapar
# main dalına push yapıldığında GitHub Actions iş akışı ile dağıtımı yapar
```
Azure Static Web Apps yapılandırması:
@ -196,85 +196,85 @@ Azure Static Web Apps yapılandırması:
### Dokümantasyon PDF Oluşturma
```bash
npm install # docsify-to-pdf kur
npm run convert # Belgelerden PDF oluştur
npm install # docsify-to-pdf yükle
npm run convert # docs'tan PDF oluştur
```
### Docsify Dokümantasyonu
```bash
npm install -g docsify-cli # Docsify'ı küresel olarak yükleyin
docsify serve # localhost:3000 üzerinde sunun
npm install -g docsify-cli # Docsify'i global olarak kur
docsify serve # localhost:3000 üzerinde sun
```
### Proje Özel Derlemeler
### Proje Bazlı Derlemeler
Her proje dizini kendi derleme sürecine sahip olabilir:
- Vue projeleri: `npm run build` üretim paketlerini oluşturur
- Statik projeler: Derleme işlemi yok, dosyalar doğrudan servis edilir
Her proje dizininin kendi derleme süreci olabilir:
- Vue projeleri: `npm run build` üretim paketleri oluşturur
- Statik projeler: Derleme adımı yok, dosyalar direkt sunulur
## Pull Request Yönergeleri
## Pull Request İlkeleri
### Başlık Formatı
Değişiklik alanını açıkça belirten başlıklar kullanın:
Değişiklik alanını açıkça belirten açıklayıcı başlıklar kullanın:
- `[Quiz-app] Ders X için yeni quiz ekle`
- `[Lesson-3] Terrarium projesinde yazım hatası düzeltildi`
- `[Translation] Ders 5 için İspanyolca çeviri eklendi`
- `[Docs] Kurulum talimatları güncellendi`
- `[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
### Gereken Kontroller
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ı düzeltin
- Etkilenen proje dizinlerinde `npm run lint` komutunu çalıştırın
- Tüm lint hatalarını ve uyarıları giderin
2. **Derleme Doğrulama**:
- Uygun ise `npm run build` çalıştırın
- Geçerliyse `npm run build` çalıştırın
- Derleme hatası olmadığından emin olun
3. **Bağlantı Doğrulama**:
- Tüm markdown bağlantılarını test edin
- Resim referanslarının çalıştığını kontrol edin
3. **Bağlantı Geçerliliği**:
- Tüm markdown bağlantıları test edin
- Resim referanslarının çalıştığından emin olun
4. **İçerik İncelemesi**:
- Yazım ve dil bilgisi denetimi yapın
- Yazım ve dilbilgisi kontrolü yapın
- Kod örneklerinin doğru ve eğitici olduğundan emin olun
- Çevirilerin orijinal anlamı koruduğunu doğrulayın
### Katkı Koşulları
### Katkı Gereksinimleri
- Microsoft CLA’ya (ilk PR’de otomatik kontrol)
- [Microsoft Açık Kaynak Davranış Kurallarına](https://opensource.microsoft.com/codeofconduct/) uyun
- Ayrıntılı yönergeler için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın
- Gerekliyse PR açıklamasında ilgili issue numaralarını belirtin
- Microsoft CLA’yı onaylayın (ilk PR’da otomatik kontrol)
- [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/) izleyin
- Detaylı rehber için [CONTRIBUTING.md](./CONTRIBUTING.md)’yi inceleyin
- İlgili ise PR açıklamasında issue numaralarını referans gösterin
### İnceleme Süreci
- PR’lar bakımcılar ve topluluk tarafından incelenir
- Eğitici açıklık önceliklidir
- Kod örnekleri güncel en iyi uygulamalara uygun olmalı
- Çeviriler doğruluk ve kültürel uygunluk için denetlenir
- Eğitimsel netlik önceliklidir
- Kod örnekleri mevcut en iyi uygulamalara uygun olmalı
- Ç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+ dile otomatik çeviri yapılır
- Kaynak dosyalar ana dizinlerde olur
- Çeviriler `translations/{dil-kodu}/` klasörlerinde bulunur
- co-op-translator iş akışıyla GitHub Actions kullanılır
- 50’den fazla dile otomatik çeviri yapılır
- Ana dizinlerde kaynak dosyalar
- Çevrilmiş dosyalar `translations/{language-code}/` dizinlerinde
### Manuel Çeviri İyileştirmeleri Ekleme
### Elle Çeviri İyileştirmeleri Ekleme
1. Dosyayı `translations/{dil-kodu}/` içinde bulun
1. `translations/{language-code}/` altında dosyayı bulun
2. Yapıyı koruyarak iyileştirmeler yapın
3. Kod örneklerinin işlevselliğini muhafaza edin
3. Kod örneklerinin çalışırlığını sağlayın
4. Yerelleştirilmiş quiz içeriğini test edin
### Çeviri Meta Verileri
### Çeviri Meta Verisi
Çevrilmiş dosyalar meta veri başlığı içerir:
```markdown
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Yaygın Sorunlar
**Quiz uygulaması başlamıyor**:
- Node.js versiyonunu kontrol edin (v14+ önerilir)
- `node_modules` ve `package-lock.json` silin, ardından `npm install` çalıştırın
- Port çakışmalarını kontrol edin (varsayılan: Vite 5173 portunu kullanır)
**Quiz uygulaması başlatılamıyor**:
- Node.js sürümünü kontrol edin (v14+ önerilir)
- `node_modules` ve `package-lock.json` dosyalarını silin, `npm install` tekrar çalıştırın
- Port çakışmalarını kontrol edin (varsayılan: Vite portu 5173)
**API sunucusu başlamıyor**:
**API sunucusu başlatılamıyor**:
- Node.js sürümünün minimum (node >=10) olduğundan emin olun
- Portun kullanımda olmadığını kontrol edin
- 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 düzgün formatlandığını kontrol edin
- Tarayıcı konsolundaki hatalara bakın
- Tarayıcıya özgü uzantı kurulum talimatlarını takip edin
- manifest.json dosyasının düzgün formatlandığını doğrulayın
- Tarayıcı konsolundaki hataları inceleyin
- Tarayıcıya özgü uzantı kurulum talimatlarını izleyin
**Python sohbet projesinde sorunlar**:
**Python sohbet projesi sorunları**:
- OpenAI paketi kurulu olmalı: `pip install openai`
- GITHUB_TOKEN çevre değişkeni ayarlı olmalı
- GitHub Models erişim izinleri kontrol edilmeli
- GITHUB_TOKEN ortam değişkeninin ayarlı olduğundan emin olun
- GitHub Modellerine erişim izinlerini kontrol edin
**Docsify dokümanları sunmuyor**:
- docsify-cli global kurulu değilse: `npm install -g docsify-cli`
- Depo kök dizininden çalıştırın
- `docs/_sidebar.md` var mı kontrol edin
**Docsify dokümantasyon sunmuyor**:
- docsify-cli global kurulumu yapın: `npm install -g docsify-cli`
- Depo kök dizininde çalıştırın
- `docs/_sidebar.md` varlığını doğrulayın
### Geliştirme Ortamı İpuçları
- HTML projeleri için VS Code Live Server uzantısını kullanın
- Tutarlı formatlama için ESLint ve Prettier uzantıları yükleyin
- JavaScript hata ayıklaması için tarayıcı geliştirici araçlarını kullanın
- HTML projeleri için VS Code Live Server eklentisini kullanın
- Tutarlı biçimlendirme için ESLint ve Prettier eklentilerini kurun
- JavaScript hatalarını tarayıcı geliştirici araçlarında ayıklayın
- Vue projeleri için Vue DevTools tarayıcı uzantısını kurun
### Performans Dikkatleri
- 50+ dilde çok sayıda çeviri dosyası olması, tam klonlamayı büyük yapar
- İçerikle çalışıyorsanız sığ klon kullanın: `git clone --depth 1`
- Çok sayıda çevrilmiş dosya (50+ dil) tam klonları büyük yapar
- Sadece içerikle çalışılıyorsa sığ klon kullanın: `git clone --depth 1`
- İngilizce içerikle çalışırken çevirileri aramalardan hariç tutun
- İlk çalıştırmada kurulum ve derleme süreçleri (npm install, Vite build) yavaş olabilir
- İlk çalıştırmada derleme süreçleri yavaş olabilir (npm install, Vite build)
## Güvenlik Dikkatleri
### Ortam Değişkenleri
- API anahtarları asla depoya eklenmemeli
- `.env` dosyaları kullanılmalı (zaten `.gitignore` içinde)
- Gerekli ortam değişkenleri proje README’lerinde belgelenmeli
- API anahtarları depoya asla eklenmemeli
- `.env` dosyaları kullanılmalı (zaten `.gitignore`’da)
- Gerekli ortam değişkenleri proje README dosyalarında belgelenmeli
### Python Projeleri
- Sanal ortamlar kullanılmalı: `python -m venv venv`
- Bağımlılıklar güncel tutulmalı
- GitHub tokenları minimum gerekli izinlere sahip olmalı
- Sanal ortam kullanın: `python -m venv venv`
- Bağımlılıkları güncel tutun
- GitHub tokenları en düşük gerekli izinlere sahip olmalı
### GitHub Models Erişimi
### GitHub Modellerine Erişim
- GitHub Models için Kişisel Erişim Tokenları (PAT) gerekir
- Kişisel Erişim Tokenları (PAT) gerekiyor
- Tokenlar ortam değişkeni olarak saklanmalı
- Tokenlar veya kimlik bilgileri asla depoya commit edilmemeli
- Token veya kimlik bilgileri asla commitlememeli
## Ek Notlar
### Hedef Kitle
- Web geliştirmeye tamamen yeni başlayanlar
- Web geliştirmeye yeni başlayanlar
- Öğrenciler ve kendi kendine öğrenenler
- Müfredatı sınıflarda kullanan öğretmenler
- İçerik erişilebilirlik ve aşamalı beceri oluşturma için tasarlanmıştır
- Müfredatı sınıf ortamında kullanan eğitmenler
- İçerik erişilebilirlik ve aşamalı beceri geliştirme için tasarlanmıştır
### Eğitim Felsefesi
- Proje bazlı öğrenme yaklaşımı
- Sık aralıklarla bilgi kontrolü (quizler)
- Uygulamalı kodlama alıştırmaları
- Proje tabanlı öğrenme yaklaşımı
- Sık sık bilgi kontrolü (quizler)
- Uygulamalı kodlama egzersizleri
- Gerçek dünya uygulama örnekleri
- Frameworklerden önce temellere odaklanma
### Depo Bakımı
- Aktif öğrenenler ve katkı sağlayanlardan oluşan topluluk
- Bağımlılık ve içerik düzenli güncellenir
- Bakımcılar tarafından sorunlar ve tartışmalar izlenir
- Çeviri güncellemeleri GitHub Actions ile otomatik yapılır
- Aktif öğrenenler ve katkıcılar topluluğu
- Bağımlılık ve içerik düzenli güncelleniyor
- Sorunlar ve tartışmalar bakımcılar tarafından izlenir
- Çeviri güncellemeleri GitHub Actions ile otomatik
### İlgili Kaynaklar
- [Microsoft Learn modülleri](https://docs.microsoft.com/learn/)
- [Student Hub kaynakları](https://docs.microsoft.com/learn/student-hub/)
- [Öğrenci Merkezi 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
### Belirli Projelerle Çalışma
Bireysel projelerle ilgili ayrıntılı talimatlar için README dosyalarına bakınız:
Bireysel projelere dair detaylı talimat için README dosyalarını inceleyin:
- `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` - Yapay zeka sohbet asistanı projesi
- `9-chat-project/README.md` - AI sohbet asistanı projesi
### Monorepo Yapısı
Klasik bir monorepo olmasa da bu depo birçok bağımsız projeyi içerir:
Geleneksel bir monorepo olmasa da bu depo çoklu bağımsız projeler içerir:
- Her ders kendi içinde bağımsızdır
- Projeler bağımlılık paylaşmaz
- Bireysel projeler üzerinde diğerlerini etkilemeden çalışabilirsiniz
- Tam müfredatı deneyimlemek için tüm depo klonlanabilir
- Projeler bağımlılıkları paylaşmaz
- Projelere diğerlerini etkilemeden çalışılabilir
- 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 etsek de, otomatik çevirilerin hata veya yanlışlık 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ılması sonucu oluşabilecek yanlış anlaşılmalardan veya yorum hatalarından sorumlu tutulamayız.
Bu belge, AI çeviri hizmeti [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba gösterilmekle birlikte, otomatik çevirilerin hatalar veya yanlışlıklar 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ı nedeniyle ortaya çıkabilecek herhangi bir yanlış anlama veya yanlış yorumdan sorumlu değiliz.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save