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
29 KiB
408 lines
29 KiB
# AGENTS.md
|
|
|
|
## Project Overview
|
|
|
|
ഇത് ആരംഭികൾക്ക് വെബ് ഡെവലപ്മെന്റ് അടിസ്ഥാനങ്ങൾ പഠിപ്പിക്കാൻ നിർമ്മിച്ച ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി റിപ്പോസിറ്ററിയാണ്. മൈക്രോസോഫ്റ്റ് ക്ലൗഡ് അവോകേറ്റേഴ്സ് വികസിപ്പിച്ചുള്ള ഈ പാഠ്യപരമായ കോഴ്സ് 24 ഹാൻഡ്സ്-ഓൺ പാഠങ്ങൾ ഉൾക്കൊണ്ട് ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവ അടങ്ങിയ ഏകദേശം 12 ആഴ്ചകൾക്കുള്ള പാഠ്യപദ്ധതിയാണ്.
|
|
|
|
### Key Components
|
|
|
|
- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പ്രോജക്ട് അധിഷ്ഠിത മഡ്യൂളുകളായി ക്രമീകരിച്ച 24 ഘടിച്ച പാഠങ്ങൾ
|
|
- **പ്രായോഗിക പ്രോജക്ടുകൾ**: ടെററിയം, ടൈപ്പിംഗ് ഗെയിം, ബ്രൗസർ എക്സ്റ്റൻഷൻ, സ്പേസ് ഗെയിം, ബാങ്കിംങ് ആപ്പ്, കോഡ് എഡിറ്റർ, AI ചാറ്റ് അസിസ്റ്റന്റ്
|
|
- **ഇന്ററാക്ടീവ് ക്വിസുകൾ**: 48 ക്വിസുകൾ, ഓരോതിലും 3 ചോദ്യങ്ങൾ (പഠനത്തിന് മുൻപ്/പഠനത്തിന് ശേഷം നിർവഹിക്കുന്ന വിലയിരുത്തൽ)
|
|
- **ബഹുവിധഭാഷാ പിന്തുണ**: GitHub Actions വഴി 50+ ഭാഷകൾക്ക് സ്വയം പരിഭാഷ
|
|
- **സാങ്കേതിക വിദ്യകൾ**: HTML, CSS, JavaScript, 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 # ESLint പ്രവർത്തിപ്പിക്കുക
|
|
npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ്റ് ചെയ്യുക
|
|
```
|
|
|
|
### 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. റിപ്പോസിറ്ററി Fork അല്ലെങ്കിൽ clone ചെയ്യുക
|
|
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` ഓടിക്കുക
|
|
- **Projects**: 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/` ഡയറക്ടറികളിലുള്ള സ്ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
|
|
- ആക്സസിബിലിറ്റിക്ക് വേണ്ടി ചിത്രങ്ങളുടെ Alt ടെക്സ്റ്റുകൾ
|
|
|
|
### 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 ആഗോളമായി ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
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
|
|
|
|
PR സമർപ്പിക്കുന്നതിന് മുമ്പ്:
|
|
|
|
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) കാണുക
|
|
- PR വിവരണത്തിൽ ബന്ധപ്പെട്ട(issue) നമ്പറുകൾ ഉൾപ്പെടുത്തുക (ഉണ്ടെങ്കിൽ)
|
|
|
|
### 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
|
|
|
|
പരിഭാഷ ഫയലുകൾ metadata ഹെഡറും ഉൾക്കൊള്ളുന്നു:
|
|
```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 Models ആക്സസ് അനുമതികൾ പരിശോധിക്കുക
|
|
|
|
**Docsify not serving docs**:
|
|
- docsify-cli ഗ്ലോബലായി ഇൻസ്റ്റാൾ ചെയ്യുക: `npm install -g docsify-cli`
|
|
- റിപ്പോസിറ്ററി റൂട്ടിൽ നിന്ന് ഓടിക്കുക
|
|
- `docs/_sidebar.md` ഫയൽ നിലവിലുണ്ടെന്ന് പരിശോധിക്കുക
|
|
|
|
### Development Environment Tips
|
|
|
|
- HTML പ്രോജക്ടുകൾക്കായി VS Code Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
|
|
- സ്ഥിരതയുള്ള ഫോർമാറ്റിംഗിന് ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
- ജാവാസ്ക്രിപ്റ്റ് ഡീബഗിനായി ബ്രൗസർ ഡെവ് ടൂളുകൾ ഉപയോഗിക്കുക
|
|
- Vue പ്രോജക്ടുകൾക്ക് Vue DevTools ബ്രൗസർ എക്സ്റ്റൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക
|
|
|
|
### Performance Considerations
|
|
|
|
- 50+ ഭാഷകളിൽ അനേകം പരിഭാഷാ ഫയലുകൾ ഉള്ളതിനാൽ പൂർണ്ണ ക്ലോണുകൾ വലുതാണ്
|
|
- ഉള്ളടക്കത്തിൽ മാത്രം ജോലി ചെയ്ക്കുമ്പോൾ `git clone --depth 1` പോലുള്ള ഷാലോ ക്ലോണിംഗ് ഉപയോഗിക്കുക
|
|
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി ചെയ്തുകൊണ്ടിരിക്കുമ്പോൾ പരിഭാഷകളെ തിരച്ചിൽ നിന്നും ഒഴിവാക്കുക
|
|
- ആദ്യ ഓടgurila npm install, Vite build തുടങ്ങിയവയിൽ ബിൽഡ് പ്രക്രിയകൾ മന്ദഗതിയിലുള്ളതാണ്
|
|
|
|
## Security Considerations
|
|
|
|
### Environment Variables
|
|
|
|
- API കീകൾ റിപ്പോസിറ്ററിയിലേക്ക് കമിറ്റ് ചെയ്യരുത്
|
|
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇതിന്റെ സാഹചര്യത്തിൽ `.gitignore` നല്കപ്പെട്ടിരിക്കുന്നു)
|
|
- ആവശ്യമായ അന്തരീക്ഷ변数കൾ പ്രോജക്ട് README-കളിൽ രേഖപ്പെടുത്തുക
|
|
|
|
### 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
|
|
|
|
വിവിധ പ്രോജക്ടുകൾക്കുള്ള വിശദമായ നിർദ്ദേശങ്ങൾക്കായി താഴെ കാണുന്ന README ഫയലുകൾ കാണുക:
|
|
- `quiz-app/README.md` - Vue 3 ക്വിസ് അപ്ലിക്കേഷൻ
|
|
- `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 --> |