You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
408 lines
28 KiB
408 lines
28 KiB
# AGENTS.md
|
|
|
|
## Project Overview
|
|
|
|
ഇത് വെബ് വികസനത്തിന്റെ അടിസ്ഥാനങ്ങളെ തുടക്കക്കാരെ പഠിപ്പിക്കുന്നതിനുള്ള ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി റെപ്പോസിറ്ററിയാണ്. മൈക്രോസോഫ്റ്റ് ക്ലൗഡ് അഡ്വക്കേറ്റുകൾ വികസിപ്പിച്ചെടുത്ത 12 ആഴ്ചകളിലെ സമഗ്ര കോഴ്സ് ആണ് ഈ പാഠ്യപദ്ധതി, അതിൽ ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML തുടങ്ങിയ വിഷയങ്ങളെക്കുറിച്ചുള്ള 24 പ്രായോഗിക പാഠങ്ങൾ ഉൾക്കൊള്ളുന്നു.
|
|
|
|
### Key Components
|
|
|
|
- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പദ്ധതിപരമായി ക്രമീകരിച്ച 24 ഘടനാപരമായ പാഠങ്ങൾ
|
|
- **പ്രായോഗിക പ്രോജക്ടുകൾ**: Terrarium, ടൈപ്പിങ്ങ് ഗെയിം, ബ്രൗസർ എക്സ്ടൻഷൻ, സ്പേസ് ഗെയിം, ബാങ്കിംഗ് ആപ്പ്, കോഡ് എഡിറ്റർ, AI ചാറ്റ് അസിസ്റ്റന്റ്
|
|
- **ഇന്ററാക്ടീവ് ക്വിസുകൾ**: ഓരോത്തിലും 3 ചോദ്യങ്ങളുള്ള 48 ക്വിസുകൾ (പാഠം മുമ്പും ശേഷവും)
|
|
- **ബഹുഭാഷാ പിന്തുണ**: GitHub Actions ഉപയോഗിച്ച് 50+ ഭാഷകളിലേക്ക് സ്വಯമാറ്റം
|
|
- **ടെക്നോളജികൾ**: HTML, CSS, ജാവാസ്ക്രിപ്റ്റ്, Vue.js 3, Vite, Node.js, Express, Python (AI പ്രോജക്ടുകൾക്ക്)
|
|
|
|
### Architecture
|
|
|
|
- പാഠം അധിഷ്ഠിത ഘടനയോടെ വിദ്യാഭ്യാസ റെപ്പോസിറ്ററി
|
|
- ഓരോ പാഠ ഫോളഡറിൽ README, കോഡ് ഉദാഹരണങ്ങൾ, പരിഹാരങ്ങൾ അടങ്ങിയിരിക്കുന്നു
|
|
- സ്വതന്ത്ര പ്രോജക്ടുകൾ വേർതിരിച്ച ഫോളഡറുകളിൽ (quiz-app, വ്യത്യസ്ത പാഠ പ്രോജക്ടുകൾ)
|
|
- GitHub Actions ഉപയോഗിച്ചുള്ള വിവർത്തന സംവിധാനം (co-op-translator)
|
|
- ഡോക്യൂമെന്റേഷൻ Docsify വഴി സർവ് ചെയ്യുന്നു കൂടാതെ PDF രൂപത്തിൽ ലഭ്യമാണ്
|
|
|
|
## Setup Commands
|
|
|
|
ഈ റെപ്പോസിറ്ററി പ്രധാനമായും വിദ്യാഭ്യാസ ഉള്ളടക്കം ഉപയോഗിക്കാൻ ആണ്. പ്രത്യേക പ്രോജക്ടുകൾ ഉപയോഗിക്കാൻ:
|
|
|
|
### Main Repository Setup
|
|
|
|
```bash
|
|
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
|
|
cd Web-Dev-For-Beginners
|
|
```
|
|
|
|
### Quiz App Setup (Vue 3 + Vite)
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm install
|
|
npm run dev # ഡെവലപ്പ്മെന്റ് സർവർ തുടങ്ങിയ്ക്കുക
|
|
npm run build # പ്രൊഡക്ഷനായി നിർമ്മിക്കുക
|
|
npm run lint # ESLint ഓടിക്കൂ
|
|
```
|
|
|
|
### Bank Project API (Node.js + Express)
|
|
|
|
```bash
|
|
cd 7-bank-project/api
|
|
npm install
|
|
npm start # എപിഐ സര്വര് ആരംഭിക്കുക
|
|
npm run lint # ഇഎസ്എലിന്റ് ഓടിക്കുക
|
|
npm run format # പ്രിസ്റ്റിയറോടെ ഫോര്മാറ്റ് ചെയ്യുക
|
|
```
|
|
|
|
### Browser Extension Projects
|
|
|
|
```bash
|
|
cd 5-browser-extension/solution
|
|
npm install
|
|
# ബ്രൗസര്-സവിശേഷമായ എക്സ്ടന്ഷന് ലോഡിംഗ് നിർദ്ദേശങ്ങൾ പിന്തുടരുക
|
|
```
|
|
|
|
### Space Game Projects
|
|
|
|
```bash
|
|
cd 6-space-game/solution
|
|
npm install
|
|
# ബ്രൗസറിൽ index.html തുറക്കുക അല്ലെങ്കിൽ ലൈവ് സർവർ ഉപയോഗിക്കുക
|
|
```
|
|
|
|
### Chat Project (Python Backend)
|
|
|
|
```bash
|
|
cd 9-chat-project/solution/backend/python
|
|
pip install openai
|
|
# GITHUB_TOKEN പരിസ്ഥിതി സ്വഭാവിക ഘടകമായി സജ്ജമാക്കുക
|
|
python api.py
|
|
```
|
|
|
|
## Development Workflow
|
|
|
|
### For Content Contributors
|
|
|
|
1. നിങ്ങളുടെ GitHub അക്കൗണ്ടിൽ റെപ്പോസിറ്ററി **ഫോർക്ക് ചെയ്യുക**
|
|
2. നിങ്ങളുടെ ഫോർക്ക് ലൊക്കലായി **ക്ലോൺ ചെയ്യുക**
|
|
3. നിങ്ങളുടെ മാറ്റങ്ങൾക്കായി **പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കുക**
|
|
4. പാഠ ഉള്ളടക്കം അല്ലെങ്കിൽ കോഡ് ഉദാഹരണങ്ങളിൽ മാറ്റങ്ങൾ വരുത്തുക
|
|
5. ബന്ധപ്പെട്ട പ്രോജക്ട് ഡയറക്ടറികളിൽ കോഡ് മാറ്റങ്ങൾ പരിശോധന നടത്തുക
|
|
6. കൺട്രിബ്യൂഷൻ മാർഗനിർദേശങ്ങൾ പാലിച്ച് പുൾ റിക്വസ്റ്റുകൾ സമർപ്പിക്കുക
|
|
|
|
### For Learners
|
|
|
|
1. റെപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുകയോ ക്ലോൺ ചെയ്യുകയോ ചെയ്യുക
|
|
2. പാഠ ഡയറക്ടറികളിലേക്ക് ക്രമാശ്രിതമായി പോകുക
|
|
3. ഓരോ പാഠത്തിനും README ഫയലുകൾ വായിക്കുക
|
|
4. https://ff-quizzes.netlify.app/web/ ൽ പാഠത്തിനു മുമ്പുള്ള ക്വിസുകൾ പൂർത്തിയാക്കുക
|
|
5. പാഠ ഫോളഡറുകളിൽ കോഡ് ഉദാഹരണങ്ങൽ പാസാക്കുക
|
|
6. അസൈൻമെന്റുകളും കൂടുതൽ ചൈലഞ്ചുകളും പൂർത്തിയാക്കുക
|
|
7. പാഠത്തിനു ശേഷമുള്ള ക്വിസുകൾ എടുക്കുക
|
|
|
|
### Live Development
|
|
|
|
- **ഡോക്യൂമെന്റേഷൻ**: റൂട്ടിൽ `docsify serve` ഓടിക്കുക (പോർട്ട് 3000)
|
|
- **Quiz App**: quiz-app ഡയറക്ടറിയിൽ `npm run dev` ഓടിക്കുക
|
|
- **പ്രോജക്ടുകൾ**: HTML പ്രോജക്ടുകൾക്ക് VS Code Live Server എക്സ്റ്റെൻഷൻ ഉപയോഗിക്കുക
|
|
- **API Projects**:អതിരേഷമുള്ള API ഡയറക്ടറികളിൽ `npm start` ഓടിക്കുക
|
|
|
|
## Testing Instructions
|
|
|
|
### Quiz App Testing
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
|
|
npm run build # ബിൽഡ് വിജയിക്കുന്നത് സ്ഥിരീകരിക്കുക
|
|
```
|
|
|
|
### Bank API Testing
|
|
|
|
```bash
|
|
cd 7-bank-project/api
|
|
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
|
|
node server.js # പിഴവുകൾ ഇല്ലാതെ സെർവർ തുടങ്ങുന്നത് സ്ഥിരീകരിക്കുക
|
|
```
|
|
|
|
### General Testing Approach
|
|
|
|
- ഇത് സമഗ്രമായ സ്വയംപരീക്ഷണ പരീക്ഷണങ്ങളില്ലാത്തൊരു വിദ്യാഭ്യാസ റെപ്പോസിറ്ററിയാണ്
|
|
- മാനുവൽ ടെസ്റ്റിംഗിന്റെ പ്രധാന ലക്ഷ്യം:
|
|
- കോഡ് ഉദാഹരണങ്ങൾ പിശക് രഹിതമായ പ്രവർത്തനം
|
|
- ഡോക്യുമെന്റേഷൻ ലിങ്കുകൾ ശരിയായ പ്രവർത്തനം
|
|
- പ്രോജക്ട് ബിൽഡുകൾ പൂര്ണ്ണത
|
|
- ഉദാഹരണങ്ങൾ മികച്ച അനുഭവരീതികൾ പാലിക്കുന്നു
|
|
|
|
### Pre-submission Checks
|
|
|
|
- package.json അടങ്ങിയ ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
|
|
- മാർക്ക്ഡൗൺ ലിങ്കുകൾ സാധുവാണെന്ന് പരിശോധിക്കുക
|
|
- ബ്രൗസറിലോ Node.js-ലോ കോഡ് ഉദാഹരണങ്ങൾ പരീക്ഷിക്കുക
|
|
- വിവർത്തനങ്ങളുടെ ഘടന കൃത്യമായി നിലനിൽക്കുന്നു എന്ന് ഉറപ്പാക്കുക
|
|
|
|
## Code Style Guidelines
|
|
|
|
### JavaScript
|
|
|
|
- ആധുനിക ES6+ ലിപി ഉപയോഗിക്കുക
|
|
- പ്രോജക്ടുകളിൽ ലഭ്യമായ സാധാരണ ESLint കോൺഫിഗറേഷനുകൾ പാലിക്കുക
|
|
- വിദ്യാർത്ഥികൾക്ക് മനസ്സിലാക്കാൻ സാധിക്കുന്ന രീതിയിൽ നാമങ്ങൾ ഉപയോഗിക്കുക
|
|
- ആശയങ്ങൾ വിശദീകരിക്കുന്ന കുറിപ്പുകൾ ചേർക്കുക
|
|
- Prettier ഉപയോഗിച്ച് സജ്ജമാക്കിയ സ്ഥലങ്ങളിൽ ഫോർമാറ്റ് ചെയ്യുക
|
|
|
|
### HTML/CSS
|
|
|
|
- സേമാന്റിക് HTML5 ഘടകങ്ങൾ
|
|
- പ്രതികരണാത്മക ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
|
|
- സ്പష్టం ക്ലാസ് നാമകരണ പാട്
|
|
- വിദ്യാർത്ഥികൾക്ക് സഹായകമായ CSS സാങ്കേതികത വിശദീകരിക്കുന്ന കുറിപ്പുകൾ
|
|
|
|
### Python
|
|
|
|
- PEP 8 ശൈലി മാർഗനിർദേശങ്ങൾ
|
|
- വ്യക്തവും പഠനാർത്ഥകവുമായ കോഡ് ഉദാഹരണങ്ങൾ
|
|
- പഠനത്തിന് സഹായകരമായ ടൈപ്പ് നിർദ്ദേശങ്ങൾ
|
|
|
|
### Markdown Documentation
|
|
|
|
- വ്യക്തമായ തലശ്രീനി ക്രമീകരണം
|
|
- ഭാഷ നിർദേശങ്ങളോടുകൂടിയ കോഡ് ബ്ലോക്കുകൾ
|
|
- അധിക വിഭവങ്ങളുടെ ലിങ്കുകൾ
|
|
- `images/` ഡയറക്ടറികളിൽ സ്ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
|
|
- ആക്സസിബിലിറ്റിക്ക് ചിത്രം മാറ്റിനോട്ടുകൾ
|
|
|
|
### File Organization
|
|
|
|
- പാഠങ്ങൾ ക്രമീകരിച്ച സംഖ്യകൾ (1-getting-started-lessons, 2-js-basics, മുതലായവ)
|
|
- ഓരോ പ്രോജക്ടിനും `solution/` കൂടാതെ പലപ്പോഴും `start/` അല്ലെങ്കിൽ `your-work/` ഡയറക്ടറികൾ
|
|
- പാഠം പ്രത്യേക `images/` ഫോൾഡറുകളിൽ ചിത്രങ്ങൾ സൂക്ഷിക്കുന്നു
|
|
- വിവർത്തനങ്ങൾ `translations/{language-code}/` ഘടനയിൽ
|
|
|
|
## Build and Deployment
|
|
|
|
### Quiz App Deployment (Azure Static Web Apps)
|
|
|
|
quiz-app Azure Static Web Apps ലോചനത്തിന് ക്രമീകരിച്ചിരിക്കുന്നു:
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm run build # dist/ ഫോളדער് സൃഷ്ടിക്കുന്നു
|
|
# പ്രധാന ബ്രാഞ്ചിലേക്ക് പുഷ് ചെയ്യുമ്പോൾ GitHub Actions വർക്ഫ്ലോ ഉപയോഗിച്ച് വിന്യസിക്കുന്നു
|
|
```
|
|
|
|
Azure Static Web Apps ക്രമീകരണം:
|
|
- **ആപ്പ് സ്ഥലം**: `/quiz-app`
|
|
- **ഔട്ട്പുട്ട് സ്ഥലം**: `dist`
|
|
- **വർക്ഫ്ലോ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
|
|
|
|
### Documentation PDF Generation
|
|
|
|
```bash
|
|
npm install # docsify-to-pdf ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
npm run convert # ഡോക്സിൽ നിന്ന് PDF സൃഷ്ടിക്കുക
|
|
```
|
|
|
|
### Docsify Documentation
|
|
|
|
```bash
|
|
npm install -g docsify-cli # ഡോക്സിഫൈ ആഗോളതലത്തിൽ ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
docsify serve # localhost:3000-ൽ സർവ് ചെയ്യുക
|
|
```
|
|
|
|
### Project-specific Builds
|
|
|
|
ഓരോ പ്രോജക്ട് ഡയറക്ടറിയിലും വ്യത്യസ്ത ബിൽഡ് പ്രക്രിയകൾ ഉണ്ടായി കിടക്കാം:
|
|
- Vue പ്രോജക്ടുകൾ: `npm run build` പ്രൊഡക്ഷൻ ബണ്ടлів സൃഷ്ടിക്കുന്നു
|
|
- സ്റ്റാറ്റിക് പ്രോജക്ടുകൾ: ബില്ഡ് സ്റ്റെപ്പ് ഇല്ല, ഫയലുകൾ നേരിട്ട് സർവ് ചെയ്യുക
|
|
|
|
## Pull Request Guidelines
|
|
|
|
### Title Format
|
|
|
|
മാറ്റത്തിന്റെ മേഖലയെ വ്യക്തമായി സൂചിപ്പിക്കുന്ന തലക്കെട്ടുകൾ ഉപയോഗിക്കുക:
|
|
- `[Quiz-app] Add new quiz for lesson X`
|
|
- `[Lesson-3] Fix typo in terrarium project`
|
|
- `[Translation] Add Spanish translation for lesson 5`
|
|
- `[Docs] Update setup instructions`
|
|
|
|
### Required Checks
|
|
|
|
പി ആർ സമർപ്പിക്കുന്നതിന് മുമ്പ്:
|
|
|
|
1. **കോഡ് ഗുണമേന്മ**:
|
|
- ബാധകമായ പ്രോജക്ട് ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
|
|
- എല്ലാ ലിന്റ് പിശകുകളും മുന്നറിയിപ്പുകളും പരിഹരിക്കുക
|
|
|
|
2. **ബിൽഡ് പരിശോധന**:
|
|
- ബാധകമുള്ള പക്ഷം `npm run build` ഓടിക്കുക
|
|
- ബിൽഡ് പിശകുകൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക
|
|
|
|
3. **ലിങ്ക് പരിശോധന**:
|
|
- എല്ലാ മാർക്ക്ഡൗൺ ലിങ്കുകളും പരിശോധിക്കുക
|
|
- ഇമേജ് റഫറൻസുകൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക
|
|
|
|
4. **ഉള്ളടക്കം അവലോകനം**:
|
|
- വൃത്തിപരിശോധനയും വ്യാകരണമികവ് പരിശോധിക്കൽ
|
|
- കോഡ് ഉദാഹരണങ്ങൾ ശരിയായും വിദ്യാഭ്യാസപരവുമായുണ്ടെന്ന് ഉറപ്പാക്കുക
|
|
- വിവർത്തനങ്ങൾ യഥാ അർത്ഥത്തെ നിലനിർത്തുന്നുണ്ടെന്ന് പരിശോധിക്കുക
|
|
|
|
### Contribution Requirements
|
|
|
|
- Microsoft CLA യുമായി അംഗീകരിക്കുക (ആദ്യ PR-ൽ ഓട്ടോമാറ്റിക് പരിശോധന)
|
|
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക
|
|
- വിശദമായ മാർഗനിർദേശങ്ങൾക്ക് [CONTRIBUTING.md](./CONTRIBUTING.md) നോക്കുക
|
|
- ആവശ്യമായ പക്ഷം പുൾ റിക്ക്വസ്റ്റ് വിവരണത്തിൽ ഇഷ്യൂ നമ്പറുകൾ ഉൾപ്പെടുത്തുക
|
|
|
|
### Review Process
|
|
|
|
- PR കൾ മെയിന്റെയ്നർമാർക്കും സമൂഹത്തിനും റിവ്യൂ ചെയ്യപ്പെടും
|
|
- വിദ്യാഭ്യാസ വ്യക്തത മുൻഗണനയാണ്
|
|
- കോഡ് ഉദാഹരണങ്ങൾ നിലവിലുള്ള മികച്ച രീതികൾ പാലിക്കണം
|
|
- വിവർത്തനങ്ങൾ കൃത്യതയോടെ സംസ്ക്കാരപരമായ അനുയോജ്യതയോടെ പരിശോധിക്കും
|
|
|
|
## Translation System
|
|
|
|
### Automated Translation
|
|
|
|
- GitHub Actions ഉപയോഗിച്ച് co-op-translator വർക്ഫ്ലോ ഉപയോഗിക്കുന്നു
|
|
- 50+ ഭാഷകളിലേക്ക് ഓട്ടോമാറ്റിക് വിവർത്തനം നൽകുന്നു
|
|
- പ്രധാനം ഡയറക്ടറികളിലുള്ള സ്രോത് ഫയലുകൾ
|
|
- വിവർത്തന ഫയലുകൾ `translations/{language-code}/` ഡയറക്ടറിയിലാണ്
|
|
|
|
### Adding Manual Translation Improvements
|
|
|
|
1. `translations/{language-code}/`യിൽ സ്ഥിതിചെയ്യുന്ന ഫയൽ കണ്ടെത്തുക
|
|
2. ഘടന നിലനിർത്തികൊണ്ട് പരിഷ്ക്കാരങ്ങൾ ചെയ്യുക
|
|
3. കോഡ് ഉദാഹരണങ്ങൾ പ്രവർത്തനക്ഷമമാണെന്ന് ഉറപ്പാക്കുക
|
|
4. ഏതെങ്കിലും പ്രാദേശിക ക്വിസ് ഉള്ളടക്കം പരീക്ഷിക്കുക
|
|
|
|
### Translation Metadata
|
|
|
|
വിവർത്തന ഫയലുകളിൽ മെറ്റാഡേറ്റ ഹedersറുകൾ ഉൾപ്പെടുന്നു:
|
|
```markdown
|
|
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "...",
|
|
"translation_date": "...",
|
|
"source_file": "...",
|
|
"language_code": "..."
|
|
}
|
|
-->
|
|
```
|
|
|
|
## Debugging and Troubleshooting
|
|
|
|
### Common Issues
|
|
|
|
**Quiz app fails to start**:
|
|
- Node.js പതിപ്പ് പരിശോധിക്കുക (v14+ ശുപാർശ)
|
|
- `node_modules`യും `package-lock.json`യും ഇല്ലാതാക്കി വീണ്ടും `npm install` ഓടിക്കുക
|
|
- പോർട്ട് കോൺഫ്ലിക്റ്റുകൾ പരിശോധിക്കുക (ഡീഫോൾട്ട്: Vite വിഷയം 5173)
|
|
|
|
**API server won't start**:
|
|
- Node.js പതിപ്പ് കുറഞ്ഞത് node >=10 ആണെന്ന് ഉറപ്പാക്കുക
|
|
- പോർട്ട് ഉപയോഗത്തിലാണ് എന്ന് പരിശോധിക്കുക
|
|
- എല്ലാം ഡെപൻഡൻസികളും `npm install` വഴി ഇൻസ്റ്റാൾ ചെയ്തുണ്ടെന്ന് ഉറപ്പാക്കുക
|
|
|
|
**Browser extension won't load**:
|
|
- manifest.json ശരിയായ ഫോർമാറ്റിൽ ആണെന്ന് പരിശോധിക്കുക
|
|
- ബ്രൗസർ കോൺസോൾ പിശകുകൾ കാണുക
|
|
- ബ്രൗസറിനനുസരിച്ച് എക്സ്ടൻഷൻ ഇൻസ്റ്റലേഷൻ മാർഗനിർദേശങ്ങൾ പാലിക്കുക
|
|
|
|
**Python chat project issues**:
|
|
- OpenAI പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടോ പരിശോധിക്കുക: `pip install openai`
|
|
- GITHUB_TOKEN എൻവയോണ്മെന്റ് വേരിയബിൾ സജ്ജമാണെന്ന് ഉറപ്പാക്കുക
|
|
- GitHub മോഡൽസ് ആക്സസ് അനുമതികൾ പരിശോധിക്കുക
|
|
|
|
**Docsify not serving docs**:
|
|
- docsify-cli ഗ്ലോബലായി ഇൻസ്റ്റാൾ ചെയ്യുക: `npm install -g docsify-cli`
|
|
- റെപ്പോസിറ്ററി റൂട്ടിൽ നിന്നു ഓടിക്കുക
|
|
- `docs/_sidebar.md` നിലവിലുണ്ടെന്ന് ഉറപ്പാക്കുക
|
|
|
|
### Development Environment Tips
|
|
|
|
- HTML പ്രോജക്ടുകൾക്കുള്ള VS Code Live Server എക്സ്റ്റെൻഷൻ ഉപയോഗിക്കുക
|
|
- ഏകാസംബന്ധിതമായ ഫോർമാറ്റ്ക്കായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
- JavaScript ഡീബഗ് ചെയ്യാൻ ബ്രൗസർ ഡെവ്ടൂൾസ് ഉപയോഗിക്കുക
|
|
- Vue പ്രോജക്ടുകൾക്കായി Vue DevTools ബ്രൗസർ എക്സ്ടൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
|
|
### Performance Considerations
|
|
|
|
- 50+ ഭാഷകളിലുള്ള വിവർത്തിത ഫയലുകളുടെ എണ്ണം വലിയതാണ്, ഫുൾ ക്ലോണുകൾ വലിയതാണ്
|
|
- ഉള്ളടക്കത്തിൽ മാത്രം പ്രവർത്തിക്കുന്നവർക്ക് ഷാലോ ക്ലോൺ ഉപയോഗിക്കുക: `git clone --depth 1`
|
|
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ നടത്തിയപ്പോൾ വിവർത്തനങ്ങൾ തിരയൽ പുറത്താകുന്നതായി ഒഴിവാക്കുക
|
|
- ആദ്യ ഓടിയിൽ ബിൽഡ് പ്രക്രിയകൾ (npm install, Vite build) നിത്യം സാധാരണയായി ക്ഷീണാകും
|
|
|
|
## Security Considerations
|
|
|
|
### Environment Variables
|
|
|
|
- API കീകൾ രെപ്പോസിറ്ററിയിൽ ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
|
|
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇതെല്ലാം `.gitignore`-ലുണ്ട്)
|
|
- ആവശ്യമായ എൻവയോൺമെന്റ് വേരിയബിളുകൾ പ്രോജക്ട് READMEs-ൽ രേഖപ്പെടുത്തുക
|
|
|
|
### Python Projects
|
|
|
|
- വെർച്ച്വൽ എൻവയോൺമെന്റ് ഉപയോഗിക്കുക: `python -m venv venv`
|
|
- ഡെപൻഡൻസികൾ അപ്ഡേറ്റ് ചെയ്ത് വയ്ക്കുക
|
|
- GitHub ടോക്കണുകൾക്ക് കുറഞ്ഞ ആവശ്യമായ അനുമതികൾ മാത്രം നൽകുക
|
|
|
|
### GitHub Models Access
|
|
|
|
- GitHub മോഡലുകളിലേക്കുള്ള വ്യക്തിഗത ആക്സസ് ടോക്കണുകൾ ആവശ്യമാണ് (PAT)
|
|
- ടോക്കണുകൾ എൻവയോൺമെന്റ് വേരിയബിളുകളായി സൂക്ഷിക്കുക
|
|
- ടോക്കണുകൾ അല്ലെങ്കിൽ ക്രെഡൻഷ്യലുകൾ ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
|
|
|
|
## Additional Notes
|
|
|
|
### Target Audience
|
|
|
|
- വെബ് വികസനത്തിൽ പൊതുവായി തുടങ്ങുന്നവർ
|
|
- വിദ്യാർത്ഥികളും സവാൽ പഠനക്കാരും
|
|
- ക്ലാസറूमിൽ പാഠ്യപദ്ധതി ഉപയോഗിക്കുന്ന അധ്യാപകർ
|
|
- പ്രവേശന യോഗ്യതയും നേതൃത്വപരവും ഉള്ള ഉള്ളടക്കം
|
|
|
|
### Educational Philosophy
|
|
|
|
- പദ്ധതിപരമായ പഠന സമീപനം
|
|
- സ്ഥിരം അറിവ് പരിശോധിക്കൽ (ക്വിസുകൾ)
|
|
- പ്രായോഗിക കോഡിംഗ് അഭ്യാസങ്ങൾ
|
|
- യാഥാർത്ഥ്യ ലോക ഉദാത്തങ്ങൾ
|
|
- ഫ്രെയിംവർക്കുകളുടെ മുമ്പ് അടിസ്ഥാന സിദ്ധാന്തങ്ങൾ
|
|
|
|
### Repository Maintenance
|
|
|
|
- സജീവമായ പഠനക്കാരുടെയും പങ്കാളികളുടെയും സമൂഹം
|
|
- ഡെപെൻഡൻസികളും ഉള്ളടക്കവും নিয়മിതമായി നവീകരിക്കുന്നു
|
|
- മെയിന്റെയ്നർമാരും ചര്ച്ചകളും ശ്രദ്ധിക്കുന്നു
|
|
- GitHub Actions മുഖേന വിവർത്തന അപ്ഡേറ്റുകൾ സ്വയംനടത്തുന്നു
|
|
|
|
### Related Resources
|
|
|
|
- [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) പഠനാർത്ഥികൾക്ക് ശുപാർശ ചെയ്യുന്നു
|
|
- അധിക കോഴ്സുകൾ: Generative AI, Data Science, ML, IoT പാഠ്യങ്ങള്
|
|
|
|
### Working with Specific Projects
|
|
|
|
തനതു പ്രോജക്ടുകൾക്കുള്ള വിശദമായ നിർദ്ദേശങ്ങൾക്കായി വായിക്കുക:
|
|
- `quiz-app/README.md` - Vue 3 ക്യൂvis് ആപ്പ്
|
|
- `7-bank-project/README.md` - ബാൻക് ആപ്പ് ഓത്തന്റിക്കേഷൻ സെറ്റ് ചെയ്യപ്പെട്ടത്
|
|
- `5-browser-extension/README.md` - ബ്രൗസർ എക്സ്റ്റെൻഷൻ വികസനം
|
|
- `6-space-game/README.md` - കാൻവാസ് അടിസ്ഥാനമായ ഗെയിം വികസനം
|
|
- `9-chat-project/README.md` - AI ചാറ്റ് അസിസ്റ്റന്റ് പ്രോജക്ട്
|
|
|
|
### Monorepo Structure
|
|
|
|
പരമ്പരാഗത മോനോറിപ്പോ അല്ലെങ്കിലും, ഈ റെപ്പോസിറ്ററി പല സ്വതന്ത്ര പ്രോജക്ടുകൾ ഉൾക്കൊള്ളുന്നു:
|
|
- ഓരോ പാഠവും സ്വതന്ത്രമാണ്
|
|
- പ്രോജക്ടുകൾ പരസ്പരം ഡെപൻഡൻസികൾ പങ്കിടുന്നില്ല
|
|
- മറ്റുള്ളവരെ ബാധിക്കാതെ വ്യക്തിഗത പ്രോജക്ടുകളിൽ പ്രവർത്തിക്കുക
|
|
- മുഴുവൻ പാഠ്യപദ്ധതി അനുഭവത്തിനായി മുഴുവൻ റെപ്പോ ക്ലോൺ ചെയ്യുക
|
|
|
|
---
|
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
|
**അസൂയാനിർദ്ദേശം**:
|
|
ഈ രേഖ AI വിവർത്തനം സേവനം [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. ഞങ്ങൾ പരമാവധി ശരിക്കും ശ്രമിക്കുന്നുവെങ്കിലും, സ്വയംക്രമിത വിവർത്തനങ്ങളിൽ പിഴവുകളോ അസാധ്യതകളോ ഉണ്ടാകാൻ സാധ്യതയുള്ളതാണ്. അതിനാൽ, ദയവായി ശ്രദ്ധിക്കേണ്ടത്, ഈ രേഖയുടെ മുമ്ബ് ഉള്ള ഭാഷയിലുള്ള യുഗ്മം പ്രാമാണിക സ്രോതസ്സായി കണക്കാക്കണം. നിർണായക വിവരങ്ങൾക്ക് പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശിപാർശ ചെയ്യുന്നു. ഈ വിവർത്തനത്തിന്റെ ഉപയോഗത്തെത്തുടർന്ന് ഉണ്ടാകുന്ന ഏതെങ്കിലും തെറ്റിദ്ധാരണകൾക്കും അർത്ഥവിമർശങ്ങൾക്കും ഞങ്ങൾ ഉത്തരവാദികളല്ല.
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |