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] 6 months 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": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T18:38:37+00:00", "translation_date": "2026-03-27T21:49:18+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "it" "language_code": "it"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "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", "source_file": "AGENTS.md",
"language_code": "it" "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 ## 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 ### Componenti Chiave
- **Contenuti Educativi**: 24 lezioni strutturate organizzate in moduli basati su progetti - **Contenuto Educativo**: 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 - **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) - **Quiz Interattivi**: 48 quiz con 3 domande ciascuno (valutazioni pre/post lezione)
- **Supporto Multilingue**: Traduzioni automatiche per oltre 50 lingue tramite GitHub Actions - **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) - **Tecnologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (per progetti AI)
### Architettura ### Architettura
- Repository educativo con struttura basata sulle lezioni - 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) - Progetti autonomi in directory separate (quiz-app, vari progetti di lezione)
- Sistema di traduzione tramite GitHub Actions (co-op-translator) - Sistema di traduzione tramite GitHub Actions (co-op-translator)
- Documentazione servita tramite Docsify e disponibile in PDF - Documentazione servita tramite Docsify e disponibile in PDF
## Comandi di Configurazione ## 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 ### Configurazione Principale del Repository
@ -41,7 +41,7 @@ npm run build # Compila per la produzione
npm run lint # Esegui ESLint npm run lint # Esegui ESLint
``` ```
### API del Progetto Bancario (Node.js + Express) ### API Progetto Bancario (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -78,35 +78,35 @@ python api.py
## Flusso di Lavoro per lo Sviluppo ## 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 1. **Fork del repository** nel tuo account GitHub
2. **Clonare il fork** localmente 2. **Clona il tuo fork** in locale
3. **Creare un nuovo branch** per le modifiche 3. **Crea un nuovo branch** per le tue modifiche
4. Apportare modifiche ai contenuti delle lezioni o agli esempi di codice 4. Modifica contenuti delle lezioni o esempi di codice
5. Testare eventuali modifiche al codice nelle directory di progetto rilevanti 5. Testa eventuali modifiche al codice nelle directory di progetto rilevanti
6. Inviare pull request seguendo le linee guida di contributo 6. Invia pull request seguendo le linee guida di contributo
### Per gli Studenti ### Per gli Studenti
1. Fare il fork o clonare il repository 1. Fai fork o clona il repository
2. Navigare sequenzialmente nelle directory delle lezioni 2. Naviga nelle cartelle delle lezioni in ordine
3. Leggere i file README di ogni lezione 3. Leggi i file README di ogni lezione
4. Completare i quiz pre-lezione su https://ff-quizzes.netlify.app/web/ 4. Completa i quiz pre-lezione su https://ff-quizzes.netlify.app/web/
5. Lavorare sugli esempi di codice nelle cartelle delle lezioni 5. Lavora sugli esempi di codice nelle cartelle delle lezioni
6. Completare compiti e sfide 6. Completa compiti e sfide
7. Sostenere i quiz post-lezione 7. Sostieni i quiz post-lezione
### Sviluppo Live ### Sviluppo in Diretta
- **Documentazione**: Eseguire `docsify serve` nella root (porta 3000) - **Documentazione**: esegui `docsify serve` nella root (porta 3000)
- **Quiz App**: Eseguire `npm run dev` nella directory quiz-app - **Quiz App**: esegui `npm run dev` nella directory quiz-app
- **Progetti**: Usare l’estensione Live Server di VS Code per progetti HTML - **Progetti**: usa l’estensione Live Server di VS Code per i progetti HTML
- **Progetti API**: Eseguire `npm start` nelle rispettive directory API - **Progetti API**: esegui `npm start` nelle directory API corrispondenti
## Istruzioni per il Testing ## Istruzioni per il Test
### Testing Quiz App ### Test Quiz App
```bash ```bash
cd quiz-app 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 npm run build # Verifica che la compilazione abbia successo
``` ```
### Testing API Bancaria ### Test API Bancaria
```bash ```bash
cd 7-bank-project/api 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 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 - Questo è un repository educativo senza test automatizzati completi
- Il testing manuale si concentra su: - I test manuali si concentrano su:
- Esecuzione degli esempi di codice senza errori - Esecuzione senza errori degli esempi di codice
- Funzionamento corretto dei link nella documentazione - Funzionamento corretto dei link nella documentazione
- Completamento con successo delle build dei progetti - Build dei progetti completati con successo
- Aderenza degli esempi alle migliori pratiche - Gli esempi seguono le migliori pratiche
### Controlli Pre-Invio ### Controlli Pre-Consegna
- Eseguire `npm run lint` nelle directory con package.json - Esegui `npm run lint` nelle directory con package.json
- Verificare che i link markdown siano validi - Verifica che i link markdown siano validi
- Testare gli esempi di codice nel browser o in Node.js - Testa esempi di codice in browser o Node.js
- Controllare che le traduzioni mantengano la struttura corretta - Controlla che le traduzioni mantengano la struttura corretta
## Linee Guida per lo Stile del Codice ## Linee Guida di Stile del Codice
### JavaScript ### JavaScript
- Usare sintassi moderna ES6+ - Usa sintassi moderna ES6+
- Seguire le configurazioni standard ESLint fornite nei progetti - Segui le configurazioni ESLint standard fornite nei progetti
- Usare nomi di variabili e funzioni significativi per chiarezza educativa - Usa nomi di variabili e funzioni significativi per chiarezza educativa
- Aggiungere commenti che spiegano i concetti per gli studenti - Aggiungi commenti che spiegano i concetti agli studenti
- Formattare usando Prettier dove configurato - Format con Prettier dove configurato
### HTML/CSS ### HTML/CSS
- Elementi semantici HTML5 - Elementi HTML5 semantici
- Principi di design responsivo - Principi di design responsive
- Convenzioni chiare per la denominazione delle classi - Convenzioni chiare per nomi delle classi
- Commenti che spiegano tecniche CSS per studenti - Commenti che spiegano tecniche CSS per studenti
### Python ### Python
- Linee guida di stile PEP 8 - Linee guida di stile PEP 8
- Esempi di codice chiari ed educativi - Esempi di codice chiari e didattici
- Annotazioni di tipo dove utili per l’apprendimento - Hint tipi dove utile per l’apprendimento
### Documentazione Markdown ### Documentazione Markdown
- Chiara gerarchia delle intestazioni - Gerarchia chiara delle intestazioni
- Blocchi di codice con specificazione del linguaggio - Blocchi di codice con specifica di linguaggio
- Link a risorse aggiuntive - Link a risorse aggiuntive
- Screenshot e immagini nelle directory `images/` - Screenshot e immagini nelle cartelle `images/`
- Testo alternativo per le immagini per accessibilità - Testo alternativo per immagini per accessibilità
### Organizzazione dei File ### 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 cartelle `solution/` e spesso `start/` o `your-work/` - Ogni progetto ha directory `solution/` e spesso `start/` o `your-work/`
- Immagini conservate nelle cartelle `images/` specifiche delle lezioni - Immagini archiviate in cartelle `images/` specifiche per lezione
- Traduzioni nella struttura `translations/{language-code}/` - Traduzioni nella struttura `translations/{language-code}/`
## Build e Distribuzione ## Build e Distribuzione
@ -185,7 +185,7 @@ La quiz-app è configurata per la distribuzione su Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Crea la cartella dist/ 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: Configurazione Azure Static Web Apps:
@ -204,23 +204,23 @@ npm run convert # Genera PDF da docs
```bash ```bash
npm install -g docsify-cli # Installa Docsify globalmente 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 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 ## Linee Guida per le Pull Request
### Formato del Titolo ### Formato del Titolo
Usare titoli chiari e descrittivi indicando l’area di modifica: Usa titoli chiari e descrittivi che indicano l’area di modifica:
- `[Quiz-app] Aggiungi nuovo quiz per la lezione X` - `[Quiz-app] Aggiungi nuovo quiz per lezione X`
- `[Lesson-3] Correggi errore di battitura nel progetto terrarium` - `[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` - `[Docs] Aggiorna istruzioni di configurazione`
### Controlli Richiesti ### Controlli Richiesti
@ -228,33 +228,33 @@ Usare titoli chiari e descrittivi indicando l’area di modifica:
Prima di inviare una PR: Prima di inviare una PR:
1. **Qualità del Codice**: 1. **Qualità del Codice**:
- Eseguire `npm run lint` nelle directory di progetto interessate - Esegui `npm run lint` nelle directory di progetto interessate
- Correggere tutti gli errori e avvertimenti lint - Risolvi tutti gli errori e avvisi di linting
2. **Verifica della Build**: 2. **Verifica Build**:
- Eseguire `npm run build` se applicabile - Esegui `npm run build` se applicabile
- Assicurarsi che non vi siano errori di build - Assicurati che non ci siano errori di build
3. **Validazione Link**: 3. **Validazione Link**:
- Testare tutti i link markdown - Testa tutti i link markdown
- Verificare che i riferimenti alle immagini funzionino - Verifica che i riferimenti alle immagini funzionino
4. **Revisione Contenuto**: 4. **Revisione Contenuto**:
- Correggere ortografia e grammatica - Controlla ortografia e grammatica
- Assicurarsi che gli esempi di codice siano corretti ed educativi - Assicurati che gli esempi di codice siano corretti e didattici
- Verificare che le traduzioni mantengano il significato originale - Verifica che le traduzioni mantengano il significato originale
### Requisiti di Contributo ### Requisiti per il Contributo
- Accettare il CLA Microsoft (controllo automatico alla prima PR) - Accetta il CLA Microsoft (controllo automatico alla prima PR)
- Seguire il [Codice di Condotta Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/) - Segui il [Codice di Condotta Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Consultare [CONTRIBUTING.md](./CONTRIBUTING.md) per linee guida dettagliate - Consulta [CONTRIBUTING.md](./CONTRIBUTING.md) per linee guida dettagliate
- Fare riferimento ai numeri delle issue nella descrizione PR se applicabile - Riferisci i numeri degli issue nella descrizione della PR se applicabile
### Processo di Revisione ### Processo di Revisione
- Le PR sono revisionate dai responsabili e dalla community - Le PR sono revisionate da manutentori e comunità
- Si dà priorità alla chiarezza educativa - Priorità alla chiarezza educativa
- Gli esempi di codice devono seguire le migliori pratiche correnti - Gli esempi di codice devono seguire le migliori pratiche correnti
- Le traduzioni sono revisionate per accuratezza e adeguatezza culturale - 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 - Usa GitHub Actions con workflow co-op-translator
- Traduce automaticamente in oltre 50 lingue - Traduce automaticamente in oltre 50 lingue
- File sorgente nelle directory principali - 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}/` 1. Trova il file in `translations/{language-code}/`
2. Apportare miglioramenti mantenendo la struttura 2. Effettua miglioramenti mantenendo la struttura
3. Assicurarsi che gli esempi di codice restino funzionanti 3. Assicurati che gli esempi di codice rimangano funzionanti
4. Testare eventuali contenuti del quiz localizzati 4. Testa eventuale contenuto quiz localizzato
### Metadati della Traduzione ### Metadati della Traduzione
I file tradotti includono intestazione metadata: I file tradotti includono header metadati:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -294,102 +294,102 @@ CO_OP_TRANSLATOR_METADATA:
### Problemi Comuni ### Problemi Comuni
**Quiz app non si avvia**: **Quiz app non si avvia**:
- Controllare versione Node.js (consigliata v14+) - Controlla versione Node.js (consigliato v14+)
- Cancellare `node_modules` e `package-lock.json`, eseguire di nuovo `npm install` - Elimina `node_modules` e `package-lock.json`, esegui di nuovo `npm install`
- Verificare conflitti di porta (default: Vite usa porta 5173) - Controlla conflitti di porta (default: Vite usa porta 5173)
**Server API non si avvia**: **Server API non si avvia**:
- Verificare che la versione Node.js sia minima (node >=10) - Verifica versione minima Node.js (node >=10)
- Controllare se la porta è già in uso - Controlla se la porta è già in uso
- Assicurarsi che tutte le dipendenze siano installate con `npm install` - Assicurati che tutte le dipendenze siano installate con `npm install`
**Estensione browser non si carica**: **Estensione browser non si carica**:
- Verificare che manifest.json sia formattato correttamente - Controlla che manifest.json sia formattato correttamente
- Controllare la console del browser per errori - Controlla la console del browser per errori
- Seguire le istruzioni specifiche del browser per l’installazione delle estensioni - Segui istruzioni specifiche per installazione estensioni browser
**Problemi progetto chat Python**: **Problemi progetto chat Python**:
- Assicurarsi che il pacchetto OpenAI sia installato: `pip install openai` - Assicurati che il pacchetto OpenAI sia installato: `pip install openai`
- Verificare che la variabile d’ambiente GITHUB_TOKEN sia impostata - Verifica che la variabile ambiente GITHUB_TOKEN sia impostata
- Controllare i permessi di accesso ai modelli GitHub - Controlla permessi di accesso GitHub Models
**Docsify non serve la documentazione**: **Docsify non serve la documentazione**:
- Installare docsify-cli globalmente: `npm install -g docsify-cli` - Installa docsify-cli globalmente: `npm install -g docsify-cli`
- Eseguire dalla directory root del repository - Esegui dalla directory root del repository
- Verificare che `docs/_sidebar.md` esista - Controlla che `docs/_sidebar.md` esista
### Consigli per l’Ambiente di Sviluppo ### Consigli per l’Ambiente di Sviluppo
- Usare VS Code con estensione Live Server per progetti HTML - Usa VS Code con estensione Live Server per progetti HTML
- Installare estensioni ESLint e Prettier per formattazione coerente - Installa estensioni ESLint e Prettier per formattazione coerente
- Usare gli strumenti DevTools del browser per il debug di JavaScript - Usa DevTools del browser per il debug JavaScript
- Per progetti Vue, installare l’estensione Vue DevTools per browser - Per progetti Vue, installa estensione browser Vue DevTools
### Considerazioni sulle Prestazioni ### Considerazioni sulle Prestazioni
- L’elevato numero di file tradotti (oltre 50 lingue) rende le clone complete grandi - Il gran numero di file tradotti (oltre 50 lingue) rende i clone completi grandi
- Usare clone superficiale se si lavora solo sui contenuti: `git clone --depth 1` - Usa clone superficiale se lavori solo sui contenuti: `git clone --depth 1`
- Escludere le traduzioni dalle ricerche quando si lavora su contenuti in inglese - Escludi traduzioni dalle ricerche quando lavori sui contenuti in inglese
- I processi di build possono essere lenti al primo avvio (npm install, build Vite) - I processi di build possono essere lenti alla prima esecuzione (npm install, build Vite)
## Considerazioni sulla Sicurezza ## Considerazioni sulla Sicurezza
### Variabili di Ambiente ### Variabili d’Ambiente
- Le chiavi API non devono mai essere inserite nel repository - Le chiavi API non devono mai essere committate nel repository
- Usare file `.env` (già inclusi in `.gitignore`) - Usa file `.env` (già in `.gitignore`)
- Documentare le variabili di ambiente richieste nei README dei progetti - Documenta le variabili ambiente richieste nei README dei progetti
### Progetti Python ### Progetti Python
- Usare ambienti virtuali: `python -m venv venv` - Usa ambienti virtuali: `python -m venv venv`
- Mantenere aggiornate le dipendenze - Mantieni aggiornate le dipendenze
- I token GitHub devono avere permessi minimi necessari - 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 - Sono necessari Personal Access Tokens (PAT) per i Modelli GitHub
- I token devono essere conservati come variabili di ambiente - I token devono essere conservati come variabili ambiente
- Non commettere mai token o credenziali - Non committare mai token o credenziali
## Note Aggiuntive ## Note Aggiuntive
### Pubblico di Destinazione ### Pubblico Target
- Principianti completi nello sviluppo web - Principianti completi nello sviluppo web
- Studenti e autodidatti - Studenti e autodidatti
- Insegnanti che usano il curriculum in aula - Insegnanti che utilizzano il curriculum in classe
- Contenuti progettati per accessibilità e acquisizione graduale delle competenze - Contenuti progettati per accessibilità e crescita graduale delle competenze
### Filosofia Educativa ### Filosofia Educativa
- Approccio di apprendimento basato su progetti - Approccio basato su apprendimento tramite progetto
- Verifiche frequenti delle conoscenze (quiz) - Controlli di conoscenza frequenti (quiz)
- Esercizi di programmazione pratici - Esercizi pratici di programmazione
- Esempi applicativi reali - Esempi di applicazione reali
- Focus sui fondamenti prima dei framework - Focus sulle fondamenta prima dei framework
### Manutenzione del Repository ### Manutenzione del Repository
- Comunità attiva di studenti e collaboratori - Comunità attiva di studenti e collaboratori
- Aggiornamenti regolari di dipendenze e contenuti - Aggiornamenti regolari di dipendenze e contenuti
- Issue e discussioni monitorate dai manutentori - Monitoraggio di issue e discussioni da parte dei manutentori
- Aggiornamenti delle traduzioni automatizzati tramite GitHub Actions - Aggiornamenti traduzioni automatizzati tramite GitHub Actions
### Risorse Correlate ### Risorse Correlate
- [Moduli Microsoft Learn](https://docs.microsoft.com/learn/) - [Moduli Microsoft Learn](https://docs.microsoft.com/learn/)
- [Risorse Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Risorse Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) consigliato per studenti - [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 ### 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 - `quiz-app/README.md` - Applicazione quiz Vue 3
- `7-bank-project/README.md` - Applicazione bancaria con autenticazione - `7-bank-project/README.md` - Applicazione bancaria con autenticazione
- `5-browser-extension/README.md` - Sviluppo estensione browser - `5-browser-extension/README.md` - Sviluppo estensione per browser
- `6-space-game/README.md` - Sviluppo gioco basato su canvas - `6-space-game/README.md` - Sviluppo gioco basato su Canvas
- `9-chat-project/README.md` - Progetto assistente chat AI - `9-chat-project/README.md` - Progetto assistente chat AI
### Struttura Monorepo ### 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: Pur non essendo un monorepo tradizionale, questo repository contiene più progetti indipendenti:
- Ogni lezione è autonoma - Ogni lezione è autonoma
- I progetti non condividono dipendenze - I progetti non condividono dipendenze
- Lavorare su singoli progetti senza influenzare gli altri - Lavora su singoli progetti senza influire sugli altri
- Clonare l’intero repository per l’esperienza completa del curriculum - Clona l'intero repository per l’esperienza completa del curriculum
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Dichiarazione di non responsabilità**: **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 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. 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 --> <!-- 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": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T18:44:39+00:00", "translation_date": "2026-03-27T21:53:50+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "pl" "language_code": "pl"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "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", "source_file": "AGENTS.md",
"language_code": "pl" "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 ## 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 ### Kluczowe elementy
- **Treści edukacyjne**: 24 ustrukturyzowane lekcje zorganizowane w moduły oparte na projektach - **Treści edukacyjne**: 24 uporządkowane 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 - **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 i po lekcji) - **Interaktywne quizy**: 48 quizów po 3 pytania każdy (oceny przed/po lekcji)
- **Wsparcie wielojęzyczne**: Automatyczne tłumaczenia na ponad 50 języków przez GitHub Actions - **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) - **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (dla projektów AI)
### Architektura ### Architektura
- Edukacyjne repozytorium z strukturą opartą na lekcjach - Edukacyjne repozytorium o strukturze opartej na lekcjach
- Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania - Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania
- Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcyjne) - Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcyjne)
- System tłumaczeń wykorzystujący GitHub Actions (co-op-translator) - System tłumaczeń wykorzystujący GitHub Actions (co-op-translator)
- Dokumentacja serwowana przez Docsify i dostępna jako PDF - Dokumentacja udostępniana przez Docsify oraz dostępna w formacie PDF
## Komendy konfiguracji ## 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 ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Konfiguracja aplikacji Quiz (Vue 3 + Vite) ### Konfiguracja aplikacji Quiz (Vue 3 + Vite)
```bash ```bash
@ -40,25 +40,25 @@ npm run dev # Uruchom serwer deweloperski
npm run build # Kompiluj do produkcji npm run build # Kompiluj do produkcji
npm run lint # Uruchom ESLint npm run lint # Uruchom ESLint
``` ```
### API projektu bankowego (Node.js + Express) ### Bankowy projekt API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Uruchom serwer API npm start # Uruchom serwer API
npm run lint # Uruchom ESLint 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 ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install 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 ### Projekty gry kosmicznej
```bash ```bash
@ -66,7 +66,7 @@ cd 6-space-game/solution
npm install npm install
# Otwórz index.html w przeglądarce lub użyj Live Server # Otwórz index.html w przeglądarce lub użyj Live Server
``` ```
### Projekt czatu (backend Python) ### Projekt czatu (backend Python)
```bash ```bash
@ -75,34 +75,34 @@ pip install openai
# Ustaw zmienną środowiskową GITHUB_TOKEN # Ustaw zmienną środowiskową GITHUB_TOKEN
python api.py python api.py
``` ```
## Przebieg rozwoju ## Przebieg rozwoju
### Dla osób dodających treści ### Dla współtwórców treści
1. **Sforkuj repozytorium** na swoje konto GitHub 1. **Zrób fork repozytorium** na swoje konto GitHub
2. **Sklonuj swoją kopię** lokalnie 2. **Sklonuj swój fork** lokalnie
3. **Utwórz nową gałąź** dla swoich zmian 3. **Utwórz nową gałąź** dla swoich zmian
4. Wprowadź zmiany w treści lekcji lub przykładach kodu 4. Wprowadź zmiany w treści lekcji lub przykładach kodu
5. Przetestuj zmieniany kod w odpowiednich katalogach projektów 5. Przetestuj zmiany w kodzie w odpowiednich folderach projektów
6. Prześlij pull requesty zgodnie z wytycznymi współpracy 6. Prześlij pull request zgodnie z wytycznymi dotyczącymi kontrybucji
### Dla uczących się ### Dla uczniów
1. Sforkuj lub sklonuj repozytorium 1. Zrób fork lub sklonuj repozytorium
2. Przechodź kolejno do katalogów lekcji 2. Przechodź kolejno do folderów lekcji
3. Czytaj pliki README dla każdej lekcji 3. Czytaj pliki README każdej lekcji
4. Wypełnij quizy przed lekcją na https://ff-quizzes.netlify.app/web/ 4. Wykonaj quizy przed lekcją na https://ff-quizzes.netlify.app/web/
5. Pracuj nad przykładami kodu w folderach lekcji 5. Pracuj poprzez przykłady kodu w folderach lekcji
6. Wykonaj zadania i wyzwania 6. Wykonuj zadania i wyzwania
7. Przystąp do quizów po lekcji 7. Wykonaj quizy po lekcji
### Praca na żywo ### Programowanie na żywo
- **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000) - **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000)
- **Aplikacja Quiz**: Uruchom `npm run dev` w katalogu quiz-app - **Aplikacja Quiz**: Uruchom `npm run dev` w katalogu quiz-app
- **Projekty**: Użyj rozszerzenia VS Code Live Server dla projektów HTML - **Projekty**: Użyj rozszerzenia Live Server w VS Code dla projektów HTML
- **Projekty API**: Uruchom `npm start` w odpowiednich katalogach API - **Projekty API**: Uruchom `npm start` w odpowiednich katalogach API
## Instrukcje testowania ## Instrukcje testowania
@ -111,74 +111,74 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Sprawdź problemy ze stylem kodu 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 ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Sprawdź problemy ze stylem kodu 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 ### Ogólne podejście do testowania
- To jest repozytorium edukacyjne bez kompleksowych testów automatycznych - To repozytorium edukacyjne bez kompleksowych testów automatycznych
- Testowanie manualne koncentruje się na: - Testy manualne koncentrują się na:
- Przykłady kodu działają bez błędów - Prawidłowym działaniu przykładów kodu
- Linki w dokumentacji działają prawidłowo - Poprawności linków w dokumentacji
- Budowy projektów wykonują się poprawnie - Powodzeniu procesu budowania projektów
- Przykłady przestrzegają najlepszych praktyk - Przestrzeganiu najlepszych praktyk w przykładach
### Sprawdzenia przed zatwierdzeniem ### Sprawdzenia przed wysłaniem
- Uruchom w katalogach z package.json `npm run lint` - Uruchom `npm run lint` w katalogach zawierających package.json
- Zweryfikuj poprawność linków markdown - Zweryfikuj poprawność linków w markdownie
- Testuj przykłady kodu w przeglądarce lub Node.js - Przetestuj przykłady kodu w przeglądarce lub Node.js
- Sprawdź czy tłumaczenia zachowują odpowiednią strukturę - Sprawdź, czy tłumaczenia zachowują odpowiednią strukturę
## Wytyczne stylu kodu ## Wytyczne dotyczące stylu kodu
### JavaScript ### JavaScript
- Używaj nowoczesnej składni ES6+ - Używaj nowoczesnej składni ES6+
- Przestrzegaj standardowej konfiguracji ESLint oferowanej w projektach - Przestrzegaj standardowych konfiguracji ESLint udostępnianych w projektach
- Nadawaj znaczące nazwy zmiennym i funkcjom dla czytelności edukacyjnej - Stosuj sensowne nazwy zmiennych i funkcji dla przejrzystości edukacyjnej
- Dodawaj komentarze tłumaczące koncepcje dla uczniów - Dodawaj komentarze wyjaśniające koncepcje dla uczniów
- Formatowanie używaj Prettier tam, gdzie jest skonfigurowany - Formatuj kod za pomocą Prettier tam, gdzie jest skonfigurowany
### HTML/CSS ### HTML/CSS
- Semantyczne elementy HTML5 - Semantyczne elementy HTML5
- Zasady responsywnego designu - Zasady responsywnego projektowania
- Jasne nazewnictwo klas - Jasne konwencje nazewnictwa klas
- Komentarze tłumaczące techniki CSS dla uczniów - Komentarze wyjaśniające techniki CSS dla uczniów
### Python ### Python
- Zasady stylu PEP 8 - Wytyczne stylu PEP 8
- Jasne, edukacyjne przykłady kodu - Przejrzyste, edukacyjne przykłady kodu
- W razie potrzeby wskazówki typów dla nauki - Typowanie tam, gdzie pomaga to w nauce
### Dokumentacja Markdown ### Dokumentacja Markdown
- Jasna hierarchia nagłówków - Jasna hierarchia nagłówków
- Bloki kodu z podaniem języka - Bloki kodu ze wskazaniem języka
- Linki do dodatkowych zasobów - Linki do dodatkowych zasobów
- Zrzuty ekranu i obrazy w katalogach `images/` - Zrzuty ekranu i obrazy w katalogach `images/`
- Teksty alternatywne dla obrazów zapewniające dostępność - 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.) - Lekcje ponumerowane kolejno (1-getting-started-lessons, 2-js-basics, itd.)
- Każdy projekt ma katalogi `solution/` i często `start/` lub `your-work/` - Każdy projekt posiada katalog `solution/` i często `start/` lub `your-work/`
- Obrazy przechowywane w folderach `images/` specyficznych dla lekcji - Obrazy przechowywane w specyficznych dla lekcji folderach `images/`
- Tłumaczenia w strukturze `translations/{language-code}/` - 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: 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/ 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 main
``` ```
Konfiguracja Azure Static Web Apps: Konfiguracja Azure Static Web Apps:
- **Lokalizacja aplikacji**: `/quiz-app` - **Lokalizacja aplikacji**: `/quiz-app`
- **Lokalizacja wynikowa**: `dist` - **Lokalizacja wyjściowa**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generowanie dokumentacji PDF ### Generowanie dokumentacji PDF
```bash ```bash
npm install # Zainstaluj docsify-to-pdf npm install # Zainstaluj docsify-to-pdf
npm run convert # Wygeneruj plik PDF z dokumentów npm run convert # Wygeneruj PDF z docs
``` ```
### Dokumentacja Docsify ### Dokumentacja Docsify
```bash ```bash
npm install -g docsify-cli # Zainstaluj Docsify globalnie npm install -g docsify-cli # Zainstaluj Docsify globalnie
docsify serve # Serwuj na localhost:3000 docsify serve # Serwuj na localhost:3000
``` ```
### Budowy specyficzne dla projektów
Każdy katalog projektowy może mieć własny proces budowy: ### Budowanie projektów specyficznych
- Projekty Vue: `npm run build` tworzy paczki produkcyjne
- Projekty statyczne: brak kroku budowy, służenie plików bezpośrednio 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 ### Format tytułu
Używaj jasnych, opisowych tytułów wskazujących obszar zmian: Używaj jasnych, opisowych tytułów wskazujących obszar zmian:
- `[Quiz-app] Dodaj nowy quiz dla lekcji X` - `[Quiz-app] Dodaj nowy quiz do lekcji X`
- `[Lesson-3] Popraw literówkę w projekcie terrarium` - `[Lesson-3] Popraw literówkę w projekcie terrarium`
- `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5` - `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5`
- `[Docs] Aktualizuj instrukcje konfiguracji` - `[Docs] Zaktualizuj instrukcje konfiguracji`
### Wymagane sprawdzenia ### Wymagane kontrole
Przed przesłaniem PR: Przed przesłaniem PR:
1. **Jakość kodu**: 1. **Jakość kodu**:
- Uruchom `npm run lint` w dotkniętych katalogach projektów - Uruchom `npm run lint` w dotkniętych katalogach projektów
- Napraw wszystkie błędy i ostrzeżenia - Napraw wszystkie błędy i ostrzeżenia lintingu
2. **Weryfikacja budowy**: 2. **Weryfikacja budowy**:
- Uruchom `npm run build`, jeśli dotyczy - Uruchom `npm run build` jeśli dotyczy
- Upewnij się, że nie występują błędy budowy - Upewnij się, że nie ma błędów budowania
3. **Walidacja linków**: 3. **Weryfikacja linków**:
- Przetestuj wszystkie linki markdown - Przetestuj wszystkie linki markdown
- Zweryfikuj, czy odwołania do obrazów działają - Zweryfikuj odwołania do obrazów
4. **Przegląd treści**: 4. **Przegląd treści**:
- Sprawdź pisownię i gramatykę - Poprawność ortograficzna i gramatyczna
- Upewnij się, że przykłady kodu są poprawne i edukacyjne - Prawidłowość i edukacyjna wartość przykładów kodu
- Zweryfikuj, że tłumaczenia zachowują oryginalne znaczenie - Wierność tłumaczeń oryginalnemu znaczeniu
### Wymagania dotyczące współpracy ### Wymagania dotyczące kontrybucji
- Zgoda na Microsoft CLA (automatyczna kontrola przy pierwszym PR) - Zgoda na Microsoft CLA (automatyczna weryfikacja przy pierwszym PR)
- Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Szczegóły w [CONTRIBUTING.md](./CONTRIBUTING.md) - Zobacz [CONTRIBUTING.md](./CONTRIBUTING.md) dla szczegółowych wytycznych
- Jeśli stosowne, uwzględniaj numery issue w opisie PR - Zamieszczaj numery issue w opisie PR, jeśli dotyczy
### Proces przeglądu ### Proces recenzji
- PRy przeglądane przez opiekunów i społeczność - PR-y są recenzowane przez opiekunów i społeczność
- Priorytetem jest jasność edukacyjna - Priorytet wręczany jasności edukacyjnej
- Przykłady kodu powinny przestrzegać aktualnych najlepszych praktyk - Przykłady kodu powinny stosować aktualne najlepsze praktyki
- Tłumaczenia poddawane przeglądowi pod kątem dokładności i adekwatności kulturowej - Tłumaczenia są sprawdzane pod kątem dokładności i zgodności kulturowej
## System tłumaczeń ## System tłumaczeń
### Tłumaczenia automatyczne ### Automatyczne tłumaczenia
- Wykorzystuje GitHub Actions z workflow co-op-translator - Wykorzystuje GitHub Actions z workflow co-op-translator
- Automatyczne tłumaczenia na ponad 50 języków - Automatycznie tłumaczy na 50+ języków
- Pliki źródłowe w głównych katalogach - Pliki źródłowe w głównych katalogach
- Przetłumaczone pliki w folderach `translations/{language-code}/` - Tłumaczenia w katalogach `translations/{language-code}/`
### Dodawanie ręcznych ulepszeń tłumaczeń ### Dodawanie ręcznych ulepszeń tłumaczeń
1. Znajdź plik w `translations/{language-code}/` 1. Zlokalizuj plik w `translations/{language-code}/`
2. Wprowadź poprawki, zachowując strukturę 2. Wprowadź poprawki zachowując strukturę
3. Upewnij się, że przykłady kodu działają poprawnie 3. Upewnij się, że przykłady kodu pozostają działające
4. Przetestuj przetłumaczone treści quizów 4. Przetestuj wszelki zlokalizowany quiz
### Metadane tłumaczeń ### Metadane tłumaczeń
Przetłumaczone pliki zawierają nagłówek metadanych: Przetłumaczone pliki zawierają nagłówek metadanych:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
} }
--> -->
``` ```
## Debugowanie i rozwiązywanie problemów ## Debugowanie i rozwiązywanie problemów
### Typowe problemy ### Typowe problemy
**Aplikacja quiz nie uruchamia się:** **Aplikacja quiz nie uruchamia się**:
- Sprawdź wersję Node.js (zalecana v14+) - Sprawdź wersję Node.js (zalecana v14+)
- Usuń `node_modules` i `package-lock.json`, uruchom ponownie `npm install` - Usuń `node_modules` i `package-lock.json`, uruchom ponownie `npm install`
- Sprawdź konflikty portów (domyślnie Vite używa portu 5173) - Sprawdź konflikty portów (domyślnie Vite korzysta z portu 5173)
**Serwer API nie startuje:** **Serwer API nie startuje**:
- Upewnij się, że wersja Node.js jest co najmniej 10 - Zweryfikuj minimalną wersję Node.js (node >=10)
- Sprawdź, czy port nie jest zajęty - Sprawdź, czy port nie jest już zajęty
- Zweryfikuj instalację wszystkich zależności (`npm install`) - Upewnij się, że wszystkie zależności są zainstalowane przez `npm install`
**Rozszerzenie przeglądarki się nie ładuje:** **Rozszerzenie przeglądarki się nie ładuje**:
- Sprawdź poprawność manifest.json - Sprawdź poprawność pliku manifest.json
- Sprawdź konsolę przeglądarki pod kątem błędów - Sprawdź konsolę przeglądarki pod kątem błędów
- Postępuj zgodnie z instrukcjami instalacji dla konkretnej przeglądarki - Postępuj zgodnie z instrukcjami instalacji dla przeglądarki
**Problemy z projektem czatu Python:** **Problemy z projektem czatu Python**:
- Sprawdź, czy pakiet OpenAI jest zainstalowany: `pip install openai` - Upewnij się, że pakiet OpenAI jest zainstalowany: `pip install openai`
- Upewnij się, że zmienna środowiskowa GITHUB_TOKEN jest ustawiona - Sprawdź, czy zmienna środowiskowa GITHUB_TOKEN jest ustawiona
- Zweryfikuj uprawnienia dostępu do modeli GitHub - Zweryfikuj uprawnienia dostępu do modeli GitHub
**Docsify nie serwuje dokumentacji:** **Docsify nie serwuje dokumentacji**:
- Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli` - Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli`
- Uruchom z katalogu głównego repozytorium - Uruchom z katalogu głównego repozytorium
- Sprawdź, czy istnieje plik `docs/_sidebar.md` - Sprawdź, czy istnieje `docs/_sidebar.md`
### Wskazówki dotyczące środowiska deweloperskiego ### Wskazówki dotyczące środowiska deweloperskiego
- Używaj VS Code z rozszerzeniem Live Server dla projektów HTML - Używaj VS Code z rozszerzeniem Live Server dla projektów HTML
- Zainstaluj rozszerzenia ESLint i Prettier dla spójnego formatowania - Zainstaluj rozszerzenia ESLint i Prettier dla spójnego formatowania
- Korzystaj z narzędzi DevTools w przeglądarce do debugowania JavaScript - Używaj narzędzi DevTools w przeglądarce do debugowania JavaScript
- Dla projektów Vue zainstaluj Vue DevTools jako rozszerzenie przeglądarki - 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 - Duża liczba przetłumaczonych plików (50+ języków) powoduje duże klony repozytorium
- Używaj klonowania płytkiego, jeśli pracujesz tylko nad treścią: `git clone --depth 1` - Używaj płytkiego klonu, jeśli pracujesz tylko nad treścią: `git clone --depth 1`
- Wyłącz tłumaczenia w wyszukiwaniu podczas pracy nad treściami angielskimi - Wyklucz tłumaczenia z wyszukiwań podczas pracy nad angielską zawartością
- Procesy budowy mogą być powolne przy pierwszym uruchomieniu (npm install, build Vite) - Procesy budowania mogą być wolne przy pierwszym uruchomieniu (npm install, budowa Vite)
## Aspekty bezpieczeństwa ## Rozważania bezpieczeństwa
### Zmienne środowiskowe ### Zmienne środowiskowe
- Klucze API nigdy nie powinny być zatwierdzane do repozytorium - Klucze API nigdy nie powinny być dodawane do repozytorium
- Używaj plików `.env` (już w `.gitignore`) - Używaj plików `.env` (już w `.gitignore`)
- Wymagane zmienne środowiskowe dokumentuj w README projektów - Dokumentuj wymagane zmienne środowiskowe w README projektów
### Projekty Python ### Projekty Python
- Używaj środowisk wirtualnych: `python -m venv venv` - Używaj środowisk wirtualnych: `python -m venv venv`
- Aktualizuj zależności - Aktualizuj zależności na bieżąco
- Tokeny GitHub powinny mieć minimalne wymagane uprawnienia - Tokeny GitHub powinny mieć minimalne niezbędne uprawnienia
### Dostęp do modeli GitHub ### Dostęp do modeli GitHub
- Wymagane osobiste tokeny dostępu (PAT) dla modeli GitHub - Wymagane są Personal Access Tokens (PAT) do modeli GitHub
- Tokeny przechowuj jako zmienne środowiskowe - Tokeny przechowuj jako zmienne środowiskowe
- Nigdy nie zatwierdzaj tokenów ani haseł - Nigdy nie umieszczaj tokenów ani danych uwierzytelniających w repozytorium
## Dodatkowe uwagi ## Dodatkowe uwagi
### Grupa docelowa ### Grupa docelowa
- Kompletnych początkujących w tworzeniu stron internetowych - Całkowici początkujący w tworzeniu stron internetowych
- Studentów i samouków - Studenci i samoucy
- Nauczycieli wykorzystujących program w klasach - Nauczyciele wykorzystujący program nauczania w klasach
- Treści zaprojektowane z myślą o dostępności i stopniowym budowaniu umiejętności - Treści zaprojektowane z myślą o dostępności i stopniowym budowaniu umiejętności
### Filozofia edukacyjna ### Filozofia edukacyjna
- Podejście oparte na nauce przez projekty - Podejście oparte na projektach
- Częste sprawdziany wiedzy (quizy) - Częste sprawdzanie wiedzy (quizy)
- Praktyczne ćwiczenia kodowania - Ćwiczenia praktyczne w kodowaniu
- Przykłady zastosowań w rzeczywistych sytuacjach - Przykłady zastosowań w realnym świecie
- Skupienie na podstawach przed frameworkami - Skupienie na podstawach przed frameworkami
### Utrzymanie repozytorium ### Utrzymanie repozytorium
- Aktywna społeczność uczących się i współtwórców - Aktywna społeczność uczniów i współtwórców
- Regularne aktualizacje zależności i treści - Regularne aktualizacje zależności i treści
- Monitorowanie issue i dyskusji przez opiekunów - Monitorowanie zgłoszeń i dyskusji przez opiekunów
- Automatyczne aktualizacje tłumaczeń przez GitHub Actions - Automatyzacja aktualizacji tłumaczeń przez GitHub Actions
### Powiązane zasoby ### Powiązane zasoby
- [Moduły Microsoft Learn](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Zasoby Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) polecany dla uczących się - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) zalecany dla uczniów
- Dodatkowe kursy: Generatywna AI, Data Science, ML, IoT - Dodatkowe kursy: Generatywne AI, Data Science, ML, IoT dostępne
### Praca z konkretnymi projektami ### Praca z konkretnymi projektami
Szczegółowe instrukcje dotyczące konkretnych projektów znajdują się w README: Szczegółowe instrukcje do poszczególnych projektów znajdują się w plikach README:
- `quiz-app/README.md` - aplikacja quizowa Vue 3 - `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 uwierzytelnianiem
- `5-browser-extension/README.md` - rozwój rozszerzenia przeglądarki - `5-browser-extension/README.md` - rozwój rozszerzeń przeglądarki
- `6-space-game/README.md` - gra oparta na canvas - `6-space-game/README.md` - rozwój gry na canvasie
- `9-chat-project/README.md` - projekt asystenta czatu AI - `9-chat-project/README.md` - projekt asystenta czatu AI
### Struktura monorepo ### Struktura monorepo
Choć to nie tradycyjne monorepo, repozytorium zawiera wiele niezależnych projektów: Chociaż to nie jest tradycyjne monorepo, repozytorium zawiera wiele niezależnych projektów:
- Każda lekcja jest samodzielna - Każda lekcja jest samodzielna
- Projekty nie dzielą zależności - Projekty nie dzielą zależności
- Pracuj nad indywidualnymi projektami bez wpływu na inne - Pracuj nad indywidualnymi projektami bez wpływu na inne
- Sklonuj całe repo dla pełnego doświadczenia programu nauczania - Sklonuj całe repozytorium, aby uzyskać pełne doświadczenie kursu
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Zastrzeżenie**: **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. 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 --> <!-- 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": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T18:50:19+00:00", "translation_date": "2026-03-27T21:57:03+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "tr" "language_code": "tr"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "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", "source_file": "AGENTS.md",
"language_code": "tr" "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ış ## 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 ### Ana Bileşenler
- **Eğitici İçerik**: Proje bazlı modüllere organize edilmiş 24 yapılandırılmış ders - **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, Bankacılık Uygulaması, Kod Editörü ve Yapay Zeka Sohbet Asistanı - **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ğerlendirmeleri) - **Etkileşimli Quizler**: Her biri 3 sorudan oluşan 48 quiz (ders öncesi/sonrası değerlendirmeler)
- **Çok Dilli Destek**: GitHub Actions ile 50+ dilde otomatik çeviriler - **Çoklu Dil Desteği**: GitHub Actions ile 50+ dilde otomatik çeviri
- **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (Yapay Zeka projeleri için) - **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projeleri için)
### Mimari ### 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 - Her ders klasörü README, kod örnekleri ve çözümler içerir
- Ayrı dizinlerde bağımsız projeler (quiz-app, çeşitli ders projeleri) - Ayrı dizinlerde bağımsız projeler (quiz-app, çeşitli ders projeleri)
- GitHub Actions kullanan çeviri sistemi (co-op-translator) - 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ı ## 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 ### Ana Depo Kurulumu
@ -67,42 +67,42 @@ npm install
# index.html dosyasını tarayıcıda açın veya Canlı Sunucu kullanın # index.html dosyasını tarayıcıda açın veya Canlı Sunucu kullanın
``` ```
### Sohbet Projesi (Python Arka Uç) ### Sohbet Projesi (Python Backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# GITHUB_TOKEN ortam değişkenini ayarlayın # GITHUB_TOKEN ortam değişkenini ayarla
python api.py python api.py
``` ```
## Geliştirme İş Akışı ## Geliştirme İş Akışı
### İçerik Katkısı Sağlayanlar için ### İçerik Katkıcıları İçin
1. Depoyu GitHub hesabınıza **forklayın** 1. Depoyu GitHub hesabınıza **forklayın**
2. Forkladığınız depoyu yerel olarak **klonlayın** 2. Forkunuzu yerel olarak **klonlayın**
3. Değişiklikleriniz için yeni bir **dal (branch)** oluşturun 3. Değişiklikleriniz için yeni bir **branch oluşturun**
4. Ders içeriği veya kod örneklerinde değişiklik yapın 4. Ders içeriği veya kod örneklerinde değişiklik yapın
5. İlgili proje klasörlerinde kod değişikliklerini test edin 5. İlgili proje dizinlerinde kod değişikliklerini test edin
6. Katkı yönergelerini takip ederek pull request gönderin 6. Katkı rehberine uygun şekilde pull request gönderin
### Öğrenenler için ### Öğrenenler İçin
1. Depoyu forklayın veya klonlayın 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 3. Her ders için README dosyalarını okuyun
4. Ders öncesi quizlerini https://ff-quizzes.netlify.app/web/ adresinde tamamlayın 4. https://ff-quizzes.netlify.app/web/ adresindeki ders öncesi quizleri tamamlayın
5. Ders klasörlerindeki kod örneklerini uygulayın 5. Ders klasörlerindeki kod örnekleri üzerinde çalışın
6. Ödevleri ve zorlukları tamamlayın 6. Ödevleri ve zorlukları tamamlayın
7. Ders sonrası quizlerine katılın 7. Ders sonrası quizlere katılın
### Canlı Geliştirme ### Canlı Geliştirme
- **Dokümantasyon**: Kök dizinde `docsify serve` çalıştırın (port 3000) - **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 - **Quiz Uygulaması**: quiz-app dizininde `npm run dev` çalıştırın
- **Projeler**: HTML projeleri için VS Code Live Server uzantısını kullanın - **Projeler**: HTML projeleri için VS Code Live Server eklentisini kullanın
- **API Projeleri**: İlgili API dizinlerinde `npm start` komutunu çalıştırın - **API Projeleri**: İlgili API dizinlerinde `npm start` çalıştırın
## Test Talimatları ## Test Talimatları
@ -118,74 +118,74 @@ npm run build # Derlemenin başarılı olduğunu doğrula
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Kod stili sorunlarını kontrol et npm run lint # Kod stili sorunlarını kontrol edin
node server.js # Sunucunun hatasız başlatıldığını doğrula node server.js # Sunucunun hatasız başlamasını doğrulayın
``` ```
### Genel Test Yaklaşımı ### 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: - Manuel testler şunlara odaklanır:
- Kod örnekleri hatasız çalışmalı - Kod örnekleri hatasız çalışıyor
- Dokümantasyon linkleri düzgün çalışmalı - Dokümantasyondaki bağlantılar doğru çalışıyor
- Proje derlemeleri başarılı şekilde tamamlanmalı - Proje derlemeleri başarılı tamamlanıyor
- Örnekler en iyi uygulamaları takip etmeli - Örnekler en iyi uygulamalara uygun
### Gönderim Öncesi Kontroller ### 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 - Markdown bağlantılarının geçerli olduğunu doğrulayın
- Kod örneklerini tarayıcıda veya Node.js'de test edin - Kod örneklerini tarayıcı veya Node.js'de test edin
- Çevirilerin yapısını koruduğundan emin olun - Çevirilerin yapı olarak doğru kaldığını kontrol edin
## Kod Stili Rehberi ## Kod Stili Yönergeleri
### JavaScript ### JavaScript
- Modern ES6+ sözdizimi kullanın - Modern ES6+ sözdizimini kullanın
- Projelerde sağlanan standart ESLint yapılandırmalarını uygulayın - Projelerde sağlanan standart ESLint yapılandırmalarını izleyin
- Eğitim amacıyla anlamlı değişken ve fonksiyon isimleri kullanın - Eğitim için anlaşılır değişken ve fonksiyon isimleri kullanın
- Öğrenenlere kavramları açıklayan yorumlar ekleyin - Öğrenenler için kavramları açıklayan yorumlar ekleyin
- Ayarlanmışsa Prettier ile biçimlendirin - Konfigüre edilmişse Prettier ile biçimlendirin
### HTML/CSS ### HTML/CSS
- Anlamsal HTML5 öğeleri - Semantik HTML5 öğeleri kullanın
- Duyarlı tasarım prensipleri - Duyarlı tasarım prensipleri uygulayın
- Açık sınıf isimlendirme kuralları - Açık sınıf isimlendirme kuralları kullanın
- Öğrenenler için CSS tekniklerini açıklayan yorumlar - CSS tekniklerini öğrencilere açıklayan yorumlar ekleyin
### Python ### Python
- PEP 8 stil yönergeleri - PEP 8 stil rehberini takip edin
- Açık, eğitici kod örnekleri - Açık ve eğitim odaklı kod örnekleri oluşturun
- Öğrenmeye yardımcı olabilecek tip ipuçları - Öğrenme için faydalı olduğunda tip ipuçları ekleyin
### Markdown Dokümantasyonu ### Markdown Dokümantasyon
- Açık başlık hiyerarşisi - Açık başlık hiyerarşisi
- Dil belirtimi içeren kod blokları - Dil belirtmeli kod blokları
- Ek kaynak bağlantıları - Ek kaynaklara bağlantılar
- `images/` klasörlerinde ekran görüntüleri ve resimler - `images/` dizinlerinde ekran görüntüleri ve görseller
- Erişilebilirlik için görüntülerde alt metin - Erişilebilirlik için resimlerde alt metin
### Dosya Organizasyonu ### Dosya Organizasyonu
- Dersler sıralı numaralandırılmış (1-getting-started-lessons, 2-js-basics, vb.) - Dersler sıralı numaralanmış (1-getting-started-lessons, 2-js-basics vb.)
- Her projenin `solution/` ve genellikle `start/` veya `your-work/` klasörleri var - Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri var
- Resimler derslere özgü `images/` klasörlerinde saklanır - Görseller ders bazlı `images/` klasörlerinde depolanır
- Çeviriler `translations/{dil-kodu}/` yapısında - Çeviriler `translations/{language-code}/` yapısında
## Derleme ve Yayınlama ## 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 ```bash
cd quiz-app cd quiz-app
npm run build # dist/ klasörü oluşturur 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ı: Azure Static Web Apps yapılandırması:
@ -196,85 +196,85 @@ Azure Static Web Apps yapılandırması:
### Dokümantasyon PDF Oluşturma ### Dokümantasyon PDF Oluşturma
```bash ```bash
npm install # docsify-to-pdf kur npm install # docsify-to-pdf yükle
npm run convert # Belgelerden PDF oluştur npm run convert # docs'tan PDF oluştur
``` ```
### Docsify Dokümantasyonu ### Docsify Dokümantasyonu
```bash ```bash
npm install -g docsify-cli # Docsify'ı küresel olarak yükleyin npm install -g docsify-cli # Docsify'i global olarak kur
docsify serve # localhost:3000 üzerinde sunun docsify serve # localhost:3000 üzerinde sun
``` ```
### Proje Özel Derlemeler ### Proje Bazlı Derlemeler
Her proje dizini kendi derleme sürecine sahip olabilir: Her proje dizininin kendi derleme süreci olabilir:
- Vue projeleri: `npm run build` üretim paketlerini oluşturur - Vue projeleri: `npm run build` üretim paketleri oluşturur
- Statik projeler: Derleme işlemi yok, dosyalar doğrudan servis edilir - Statik projeler: Derleme adımı yok, dosyalar direkt sunulur
## Pull Request Yönergeleri ## Pull Request İlkeleri
### Başlık Formatı ### 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` - `[Quiz-app] Ders X için yeni quiz ekle`
- `[Lesson-3] Terrarium projesinde yazım hatası düzeltildi` - `[Lesson-3] Terrarium projesindeki yazım hatasını düzelt`
- `[Translation] Ders 5 için İspanyolca çeviri eklendi` - `[Translation] Ders 5 için İspanyolca çeviri ekle`
- `[Docs] Kurulum talimatları güncellendi` - `[Docs] Kurulum talimatlarını güncelle`
### Gerekli Kontroller ### Gereken Kontroller
PR göndermeden önce: PR göndermeden önce:
1. **Kod Kalitesi**: 1. **Kod Kalitesi**:
- Etkilenen proje dizinlerinde `npm run lint` çalıştırın - Etkilenen proje dizinlerinde `npm run lint` komutunu çalıştırın
- Tüm lint hatalarını ve uyarılarını düzeltin - Tüm lint hatalarını ve uyarıları giderin
2. **Derleme Doğrulama**: 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 - Derleme hatası olmadığından emin olun
3. **Bağlantı Doğrulama**: 3. **Bağlantı Geçerliliği**:
- Tüm markdown bağlantılarını test edin - Tüm markdown bağlantıları test edin
- Resim referanslarının çalıştığını kontrol edin - Resim referanslarının çalıştığından emin olun
4. **İçerik İncelemesi**: 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 - Kod örneklerinin doğru ve eğitici olduğundan emin olun
- Çevirilerin orijinal anlamı koruduğunu doğrulayın - Çevirilerin orijinal anlamı koruduğunu doğrulayın
### Katkı Koşulları ### Katkı Gereksinimleri
- Microsoft CLA’ya (ilk PR’de otomatik kontrol) - Microsoft CLA’yı onaylayın (ilk PR’da otomatik kontrol)
- [Microsoft Açık Kaynak Davranış Kurallarına](https://opensource.microsoft.com/codeofconduct/) uyun - [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/) izleyin
- Ayrıntılı yönergeler için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın - Detaylı rehber için [CONTRIBUTING.md](./CONTRIBUTING.md)’yi inceleyin
- Gerekliyse PR açıklamasında ilgili issue numaralarını belirtin - İlgili ise PR açıklamasında issue numaralarını referans gösterin
### İnceleme Süreci ### İnceleme Süreci
- PR’lar bakımcılar ve topluluk tarafından incelenir - PR’lar bakımcılar ve topluluk tarafından incelenir
- Eğitici açıklık önceliklidir - Eğitimsel netlik önceliklidir
- Kod örnekleri güncel en iyi uygulamalara uygun olmalı - Kod örnekleri mevcut en iyi uygulamalara uygun olmalı
- Çeviriler doğruluk ve kültürel uygunluk için denetlenir - Çeviriler doğruluk ve kültürel uygunluk açısından gözden geçirilir
## Çeviri Sistemi ## Çeviri Sistemi
### Otomatik Çeviri ### Otomatik Çeviri
- GitHub Actions ile co-op-translator iş akışı kullanılır - co-op-translator iş akışıyla GitHub Actions kullanılır
- 50+ dile otomatik çeviri yapılır - 50’den fazla dile otomatik çeviri yapılır
- Kaynak dosyalar ana dizinlerde olur - Ana dizinlerde kaynak dosyalar
- Çeviriler `translations/{dil-kodu}/` klasörlerinde bulunur - Ç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 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 4. Yerelleştirilmiş quiz içeriğini test edin
### Çeviri Meta Verileri ### Çeviri Meta Verisi
Çevrilmiş dosyalar meta veri başlığı içerir: Çevrilmiş dosyalar meta veri başlığı içerir:
```markdown ```markdown
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Yaygın Sorunlar ### Yaygın Sorunlar
**Quiz uygulaması başlamıyor**: **Quiz uygulaması başlatılamıyor**:
- Node.js versiyonunu kontrol edin (v14+ önerilir) - Node.js sürümünü kontrol edin (v14+ önerilir)
- `node_modules` ve `package-lock.json` silin, ardından `npm install` çalıştırın - `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 5173 portunu kullanır) - 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 - 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 - Tüm bağımlılıkların `npm install` ile yüklendiğinden emin olun
**Tarayıcı uzantısı yüklenmiyor**: **Tarayıcı uzantısı yüklenmiyor**:
- manifest.json dosyasının düzgün formatlandığını kontrol edin - manifest.json dosyasının düzgün formatlandığını doğrulayın
- Tarayıcı konsolundaki hatalara bakın - Tarayıcı konsolundaki hataları inceleyin
- Tarayıcıya özgü uzantı kurulum talimatlarını takip edin - Tarayıcıya özgü uzantı kurulum talimatlarını izleyin
**Python sohbet projesinde sorunlar**: **Python sohbet projesi sorunları**:
- OpenAI paketi kurulu olmalı: `pip install openai` - OpenAI paketi kurulu olmalı: `pip install openai`
- GITHUB_TOKEN çevre değişkeni ayarlı olmalı - GITHUB_TOKEN ortam değişkeninin ayarlı olduğundan emin olun
- GitHub Models erişim izinleri kontrol edilmeli - GitHub Modellerine erişim izinlerini kontrol edin
**Docsify dokümanları sunmuyor**: **Docsify dokümantasyon sunmuyor**:
- docsify-cli global kurulu değilse: `npm install -g docsify-cli` - docsify-cli global kurulumu yapın: `npm install -g docsify-cli`
- Depo kök dizininden çalıştırın - Depo kök dizininde çalıştırın
- `docs/_sidebar.md` var mı kontrol edin - `docs/_sidebar.md` varlığını doğrulayın
### Geliştirme Ortamı İpuçları ### Geliştirme Ortamı İpuçları
- HTML projeleri için VS Code Live Server uzantısını kullanın - HTML projeleri için VS Code Live Server eklentisini kullanın
- Tutarlı formatlama için ESLint ve Prettier uzantıları yükleyin - Tutarlı biçimlendirme için ESLint ve Prettier eklentilerini kurun
- JavaScript hata ayıklaması için tarayıcı geliştirici araçlarını kullanın - 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 - Vue projeleri için Vue DevTools tarayıcı uzantısını kurun
### Performans Dikkatleri ### Performans Dikkatleri
- 50+ dilde çok sayıda çeviri dosyası olması, tam klonlamayı büyük yapar - Çok sayıda çevrilmiş dosya (50+ dil) tam klonları büyük yapar
- İçerikle çalışıyorsanız sığ klon kullanın: `git clone --depth 1` - Sadece içerikle çalışılıyorsa sığ klon kullanın: `git clone --depth 1`
- İngilizce içerikle çalışırken çevirileri aramalardan hariç tutun - İ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 ## Güvenlik Dikkatleri
### Ortam Değişkenleri ### Ortam Değişkenleri
- API anahtarları asla depoya eklenmemeli - API anahtarları depoya asla eklenmemeli
- `.env` dosyaları kullanılmalı (zaten `.gitignore` içinde) - `.env` dosyaları kullanılmalı (zaten `.gitignore`’da)
- Gerekli ortam değişkenleri proje README’lerinde belgelenmeli - Gerekli ortam değişkenleri proje README dosyalarında belgelenmeli
### Python Projeleri ### Python Projeleri
- Sanal ortamlar kullanılmalı: `python -m venv venv` - Sanal ortam kullanın: `python -m venv venv`
- Bağımlılıklar güncel tutulmalı - Bağımlılıkları güncel tutun
- GitHub tokenları minimum gerekli izinlere sahip olmalı - 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 ortam değişkeni olarak saklanmalı
- Tokenlar veya kimlik bilgileri asla depoya commit edilmemeli - Token veya kimlik bilgileri asla commitlememeli
## Ek Notlar ## Ek Notlar
### Hedef Kitle ### Hedef Kitle
- Web geliştirmeye tamamen yeni başlayanlar - Web geliştirmeye yeni başlayanlar
- Öğrenciler ve kendi kendine öğrenenler - Öğrenciler ve kendi kendine öğrenenler
- Müfredatı sınıflarda kullanan öğretmenler - Müfredatı sınıf ortamında kullanan eğitmenler
- İçerik erişilebilirlik ve aşamalı beceri oluşturma için tasarlanmıştır - İçerik erişilebilirlik ve aşamalı beceri geliştirme için tasarlanmıştır
### Eğitim Felsefesi ### Eğitim Felsefesi
- Proje bazlı öğrenme yaklaşımı - Proje tabanlı öğrenme yaklaşımı
- Sık aralıklarla bilgi kontrolü (quizler) - Sık sık bilgi kontrolü (quizler)
- Uygulamalı kodlama alıştırmaları - Uygulamalı kodlama egzersizleri
- Gerçek dünya uygulama örnekleri - Gerçek dünya uygulama örnekleri
- Frameworklerden önce temellere odaklanma - Frameworklerden önce temellere odaklanma
### Depo Bakımı ### Depo Bakımı
- Aktif öğrenenler ve katkı sağlayanlardan oluşan topluluk - Aktif öğrenenler ve katkıcılar topluluğu
- Bağımlılık ve içerik düzenli güncellenir - Bağımlılık ve içerik düzenli güncelleniyor
- Bakımcılar tarafından sorunlar ve tartışmalar izlenir - Sorunlar ve tartışmalar bakımcılar tarafından izlenir
- Çeviri güncellemeleri GitHub Actions ile otomatik yapılır - Çeviri güncellemeleri GitHub Actions ile otomatik
### İlgili Kaynaklar ### İlgili Kaynaklar
- [Microsoft Learn modülleri](https://docs.microsoft.com/learn/) - [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) - Öğ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 kurslar: Üretken AI, Veri Bilimi, ML, IoT müfredatları mevcut
### Belirli Projelerle Çalışma ### 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ı - `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 - `5-browser-extension/README.md` - Tarayıcı uzantısı geliştirme
- `6-space-game/README.md` - Canvas tabanlı oyun 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ı ### 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 - Her ders kendi içinde bağımsızdır
- Projeler bağımlılık paylaşmaz - Projeler bağımlılıkları paylaşmaz
- Bireysel projeler üzerinde diğerlerini etkilemeden çalışabilirsiniz - Projelere diğerlerini etkilemeden çalışılabilir
- Tam müfredatı deneyimlemek için tüm depo klonlanabilir - Tam müfredat deneyimi için tüm depo klonlanabilir
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Feragatname**: **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 --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save