| 1 | # KTI Quick Reference Guide |
| 2 | |
| 3 | ## 🚀 Quick Start |
| 4 | |
| 5 | ### View KTI |
| 6 | - **Listing**: https://smbcloud.xyz/kti |
| 7 | - **Example Term**: https://smbcloud.xyz/kti/apa-itu-docker |
| 8 | |
| 9 | ### Add New Term |
| 10 | |
| 11 | 1. **Create MDX file**: `content/kti/your-term.mdx` |
| 12 | 2. **Add frontmatter**: |
| 13 | ```yaml |
| 14 | --- |
| 15 | title: "Your Term Title" |
| 16 | term: "apa-itu-your-term" |
| 17 | category: "Category Name" |
| 18 | tags: ["tag1", "tag2"] |
| 19 | description: "Short description (150 chars max)" |
| 20 | englishTerm: "English Term (optional)" |
| 21 | acronym: "ACRONYM (optional)" |
| 22 | relatedTerms: ["apa-itu-term1", "apa-itu-term2"] |
| 23 | difficulty: "pemula" | "menengah" | "lanjut" |
| 24 | lastmod: 2024-01-15 |
| 25 | published: true |
| 26 | --- |
| 27 | |
| 28 | # Content starts here... |
| 29 | ``` |
| 30 | |
| 31 | 3. **Build**: `npm run build:content && npm run build` |
| 32 | 4. **Test**: `npm run dev` and visit `/kti/apa-itu-your-term` |
| 33 | |
| 34 | ## 📋 Categories |
| 35 | |
| 36 | - **Pemrograman** - Programming, APIs, frameworks |
| 37 | - **Cloud & Infrastructure** - Cloud, Docker, Kubernetes |
| 38 | - **Software Development** - Git, DevOps, CI/CD |
| 39 | - **Database** - SQL, NoSQL, data |
| 40 | - **Keamanan** - Security, encryption |
| 41 | - **Networking** - HTTP, TCP/IP, DNS |
| 42 | - **Frontend** - HTML, CSS, JavaScript |
| 43 | - **Backend** - Server, APIs, microservices |
| 44 | |
| 45 | ## 🎯 Difficulty Levels |
| 46 | |
| 47 | - **pemula** 🌱 - Beginner (basic concepts) |
| 48 | - **menengah** 📈 - Intermediate (practical skills) |
| 49 | - **lanjut** 🚀 - Advanced (expert topics) |
| 50 | |
| 51 | ## 🔗 Current Terms (7) |
| 52 | |
| 53 | 1. `/kti/apa-itu-api` - API (pemula) |
| 54 | 2. `/kti/apa-itu-cloud-computing` - Cloud Computing (pemula) |
| 55 | 3. `/kti/apa-itu-git` - Git (pemula) |
| 56 | 4. `/kti/apa-itu-rest` - REST API (menengah) |
| 57 | 5. `/kti/apa-itu-devops` - DevOps (menengah) |
| 58 | 6. `/kti/apa-itu-docker` - Docker (menengah) |
| 59 | 7. `/kti/apa-itu-kubernetes` - Kubernetes (lanjut) |
| 60 | |
| 61 | ## 💡 SEO Strategy |
| 62 | |
| 63 | ### Why "apa-itu-"? |
| 64 | |
| 65 | Indonesians search: "apa itu docker" (2,400+ monthly) |
| 66 | |
| 67 | **Our URLs**: `/kti/apa-itu-docker` = exact match! |
| 68 | |
| 69 | ### Benefits |
| 70 | - ✅ Match search queries exactly |
| 71 | - ✅ Low competition keywords |
| 72 | - ✅ Voice search ready |
| 73 | - ✅ Featured snippet optimized |
| 74 | |
| 75 | ## 📝 Content Template |
| 76 | |
| 77 | ```markdown |
| 78 | --- |
| 79 | title: "[Technology] - Full Name" |
| 80 | term: "apa-itu-[technology]" |
| 81 | category: "Category" |
| 82 | tags: ["tag1", "tag2", "tag3"] |
| 83 | description: "Apa itu [technology]? [Clear definition in 150 chars]" |
| 84 | englishTerm: "English Name" |
| 85 | relatedTerms: ["apa-itu-term1", "apa-itu-term2"] |
| 86 | difficulty: "pemula" |
| 87 | lastmod: 2024-01-15 |
| 88 | published: true |
| 89 | --- |
| 90 | |
| 91 | ## Apa itu [Technology]? |
| 92 | |
| 93 | **[Technology]** adalah [clear definition]. |
| 94 | |
| 95 | ## Mengapa [Technology] Penting? |
| 96 | |
| 97 | 1. **Benefit 1** - Description |
| 98 | 2. **Benefit 2** - Description |
| 99 | 3. **Benefit 3** - Description |
| 100 | |
| 101 | ## Cara Kerja [Technology] |
| 102 | |
| 103 | [Explanation with diagrams/examples] |
| 104 | |
| 105 | ## Contoh Penggunaan |
| 106 | |
| 107 | ```language |
| 108 | // Code example |
| 109 | ``` |
| 110 | |
| 111 | ## Best Practices |
| 112 | |
| 113 | 1. Practice 1 |
| 114 | 2. Practice 2 |
| 115 | 3. Practice 3 |
| 116 | |
| 117 | ## Kesalahan Umum |
| 118 | |
| 119 | - ❌ Mistake 1 |
| 120 | - ❌ Mistake 2 |
| 121 | - ✅ Correct way |
| 122 | |
| 123 | ## [Technology] dengan smbCloud |
| 124 | |
| 125 | [Natural integration of smbCloud features] |
| 126 | |
| 127 | ## Tips untuk Pemula |
| 128 | |
| 129 | 1. Tip 1 |
| 130 | 2. Tip 2 |
| 131 | 3. Tip 3 |
| 132 | |
| 133 | ## Kesimpulan |
| 134 | |
| 135 | [Summary and next steps] |
| 136 | ``` |
| 137 | |
| 138 | ## 🛠️ Commands |
| 139 | |
| 140 | ```bash |
| 141 | # Generate content |
| 142 | npm run build:content |
| 143 | |
| 144 | # Build site |
| 145 | npm run build |
| 146 | |
| 147 | # Dev server |
| 148 | npm run dev |
| 149 | |
| 150 | # Full rebuild |
| 151 | rm -rf .contentlayer && npm run build:content && npm run build |
| 152 | ``` |
| 153 | |
| 154 | ## 🐛 Troubleshooting |
| 155 | |
| 156 | ### MDX Error |
| 157 | **Problem**: `Unexpected character` |
| 158 | **Solution**: Escape HTML chars (`<` → `<`, `>` → `>`) |
| 159 | |
| 160 | ### Build Error |
| 161 | **Problem**: `Cannot resolve 'contentlayer/generated'` |
| 162 | **Solution**: Run `npm run build:content` first |
| 163 | |
| 164 | ### Async Params Error |
| 165 | **Problem**: `params is a Promise` |
| 166 | **Solution**: Already fixed - params are awaited |
| 167 | |
| 168 | ## 📊 File Structure |
| 169 | |
| 170 | ``` |
| 171 | content/kti/ |
| 172 | ├── README.md # Guidelines |
| 173 | ├── api.mdx → /kti/apa-itu-api |
| 174 | ├── cloud-computing.mdx → /kti/apa-itu-cloud-computing |
| 175 | ├── devops.mdx → /kti/apa-itu-devops |
| 176 | ├── docker.mdx → /kti/apa-itu-docker |
| 177 | ├── git.mdx → /kti/apa-itu-git |
| 178 | ├── kubernetes.mdx → /kti/apa-itu-kubernetes |
| 179 | └── rest.mdx → /kti/apa-itu-rest |
| 180 | |
| 181 | app/kti/ |
| 182 | ├── page.tsx # Listing page |
| 183 | └── [term]/ |
| 184 | └── page.tsx # Detail page (async) |
| 185 | ``` |
| 186 | |
| 187 | ## ✅ Checklist for New Term |
| 188 | |
| 189 | - [ ] File: `content/kti/[term].mdx` (no "apa-itu-" in filename) |
| 190 | - [ ] Frontmatter: `term: "apa-itu-[term]"` |
| 191 | - [ ] Related terms: Use "apa-itu-" prefix |
| 192 | - [ ] Content: 1000+ words |
| 193 | - [ ] Code examples included |
| 194 | - [ ] Bahasa Indonesia + English terms |
| 195 | - [ ] Build: No errors |
| 196 | - [ ] Test: Page loads correctly |
| 197 | |
| 198 | ## 🎨 Styling |
| 199 | |
| 200 | ### Badge Colors |
| 201 | - **pemula**: Green (`bg-green-100 dark:bg-green-900`) |
| 202 | - **menengah**: Blue (`bg-blue-100 dark:bg-blue-900`) |
| 203 | - **lanjut**: Purple (`bg-purple-100 dark:bg-purple-900`) |
| 204 | |
| 205 | ### Typography |
| 206 | - H1: Term title |
| 207 | - H2: Major sections |
| 208 | - H3: Subsections |
| 209 | - Code blocks: With language tags |
| 210 | |
| 211 | ## 📈 Next Terms to Add |
| 212 | |
| 213 | ### High Priority (Pemula) |
| 214 | - [ ] HTML/CSS |
| 215 | - [ ] JavaScript |
| 216 | - [ ] HTTP/HTTPS |
| 217 | - [ ] Database |
| 218 | - [ ] SQL |
| 219 | - [ ] JSON |
| 220 | - [ ] Frontend/Backend |
| 221 | |
| 222 | ### Medium Priority (Menengah) |
| 223 | - [ ] TypeScript |
| 224 | - [ ] React |
| 225 | - [ ] Node.js |
| 226 | - [ ] PostgreSQL |
| 227 | - [ ] MongoDB |
| 228 | - [ ] JWT |
| 229 | |
| 230 | ### Advanced Priority (Lanjut) |
| 231 | - [ ] Microservices |
| 232 | - [ ] GraphQL |
| 233 | - [ ] Redis |
| 234 | - [ ] Message Queue |
| 235 | - [ ] Observability |
| 236 | |
| 237 | ## 🔍 SEO Checklist |
| 238 | |
| 239 | - [ ] Title: "Apa Itu [Tech]..." format |
| 240 | - [ ] Description: Starts with definition |
| 241 | - [ ] Keywords: Natural placement |
| 242 | - [ ] H1: "Apa itu [Technology]?" |
| 243 | - [ ] First paragraph: Direct answer |
| 244 | - [ ] Internal links: Related terms |
| 245 | - [ ] Code examples: Syntax highlighted |
| 246 | - [ ] Length: 1000+ words |
| 247 | - [ ] Mobile friendly |
| 248 | |
| 249 | ## 📞 Support |
| 250 | |
| 251 | - **Technical Issues**: Check `KTI_SUMMARY.md` |
| 252 | - **SEO Questions**: See `APA-ITU-SEO-STRATEGY.md` |
| 253 | - **Content Guidelines**: Read `content/kti/README.md` |
| 254 | - **Deployment**: Use `KTI_DEPLOYMENT_CHECKLIST.md` |
| 255 | - **Contact**: support@smbcloud.xyz |
| 256 | |
| 257 | ## 🎯 Success Metrics |
| 258 | |
| 259 | ### Current |
| 260 | - ✅ 7 terms published |
| 261 | - ✅ All categories represented |
| 262 | - ✅ All difficulty levels covered |
| 263 | - ✅ Build passing |
| 264 | - ✅ SEO optimized |
| 265 | |
| 266 | ### Goals (Month 1) |
| 267 | - 🎯 20+ terms |
| 268 | - 🎯 Top 10 for 10+ queries |
| 269 | - 🎯 100+ visits/day |
| 270 | |
| 271 | ### Goals (Month 6) |
| 272 | - 🎯 50+ terms |
| 273 | - 🎯 Top 3 for 30+ queries |
| 274 | - 🎯 1,000+ visits/day |
| 275 | - 🎯 Recognized brand |
| 276 | |
| 277 | --- |
| 278 | |
| 279 | **Version**: 1.0.0 |
| 280 | **Last Updated**: January 2024 |
| 281 | **Status**: Production Ready ✅ |