|
| 1 | +# LiaScript Blog Taxonomy Guide |
| 2 | + |
| 3 | +## Categories (Broad Content Types) |
| 4 | + |
| 5 | +Categories represent the **type** of content. Each post should have 1-2 categories maximum. |
| 6 | + |
| 7 | +- **Tutorial** - Step-by-step guides, how-tos, and educational content |
| 8 | +- **Feature** - Announcements and explanations of new LiaScript features |
| 9 | +- **News** - Project updates, events, conferences, and community news |
| 10 | +- **Case Study** - Real-world examples and showcases of LiaScript usage |
| 11 | +- **Documentation** - Reference material and technical documentation |
| 12 | +- **Community** - User stories, interviews, and community contributions |
| 13 | + |
| 14 | +## Tags (Specific Topics) |
| 15 | + |
| 16 | +Tags represent **what** the content is about. Posts can have multiple tags (3-10 recommended). |
| 17 | + |
| 18 | +### Technology & Tools |
| 19 | +- **AI** - Artificial intelligence, LLMs, ChatGPT, etc. |
| 20 | +- **GitHub** - GitHub-related content, workflows, Actions |
| 21 | +- **GitLab** - GitLab integration and features |
| 22 | +- **VS Code** - Visual Studio Code integration |
| 23 | +- **LiveEditor** - LiaScript LiveEditor features |
| 24 | +- **Exporter** - Export functionality and formats |
| 25 | +- **3D** - 3D models and A-Frame integration |
| 26 | + |
| 27 | +### Content Types |
| 28 | +- **Video** - Video content and embedding |
| 29 | +- **Audio** - Audio features and podcasts |
| 30 | +- **Podcast** - Podcast episodes and audio shows |
| 31 | +- **Images** - Image handling and galleries |
| 32 | +- **Multimedia** - General multimedia content |
| 33 | +- **Interactive** - Interactive elements and features |
| 34 | +- **Animation** - Animation and transitions |
| 35 | + |
| 36 | +### Features |
| 37 | +- **TTS** - Text-to-Speech functionality |
| 38 | +- **Quizzes** - Quiz and assessment features |
| 39 | +- **Survey** - Surveys and polls |
| 40 | +- **Code** - Code execution and programming |
| 41 | +- **Charts** - Data visualization and charts |
| 42 | +- **Tables** - Table features |
| 43 | +- **Comments** - Comment functionality |
| 44 | +- **Macros** - Macro system |
| 45 | +- **Tooltips** - Tooltip functionality |
| 46 | +- **Preview** - Preview and card features |
| 47 | +- **Classroom** - Classroom and teaching features |
| 48 | + |
| 49 | +### Topics |
| 50 | +- **OER** - Open Educational Resources |
| 51 | +- **Accessibility** - Accessibility features |
| 52 | +- **Education** - Educational use cases |
| 53 | +- **TVET** - Technical and vocational education |
| 54 | +- **Science** - Scientific content and use cases |
| 55 | +- **Programming** - Programming education |
| 56 | +- **Collaboration** - Collaborative editing and content creation |
| 57 | +- **Sharing** - Content sharing and distribution |
| 58 | + |
| 59 | +### Integration |
| 60 | +- **OPAL** - OPAL LMS integration |
| 61 | +- **LMS** - Learning Management Systems |
| 62 | +- **MOOC** - Massive Open Online Courses |
| 63 | +- **SCORM** - SCORM packages |
| 64 | +- **Nextcloud** - Nextcloud integration |
| 65 | +- **WebTorrent** - Peer-to-peer sharing |
| 66 | +- **P2P** - Peer-to-peer technology |
| 67 | +- **oEmbed** - oEmbed protocol for embedding content |
| 68 | + |
| 69 | +### Languages & Formats |
| 70 | +- **Markdown** - Markdown-specific content |
| 71 | +- **Python** - Python-related content |
| 72 | +- **JavaScript** - JavaScript-related content |
| 73 | +- **LiaScript** - Core LiaScript language features |
| 74 | + |
| 75 | +## Guidelines |
| 76 | + |
| 77 | +### When to use Categories vs Tags |
| 78 | + |
| 79 | +**Categories** answer: "What kind of post is this?" |
| 80 | +- Tutorial, Feature announcement, News, Case study, etc. |
| 81 | + |
| 82 | +**Tags** answer: "What specific topics does this cover?" |
| 83 | +- AI, Video, TTS, GitHub, OER, etc. |
| 84 | + |
| 85 | +### Examples |
| 86 | + |
| 87 | +**Post: "From PDF to LiaScript Course — Speedrun with AI"** |
| 88 | +- Categories: Tutorial, Case Study |
| 89 | +- Tags: AI, Video, TTS, Animation, GitHub, OER, Multimedia, LiveEditor |
| 90 | + |
| 91 | +**Post: "Multimedia Comments - This Changes Everything"** |
| 92 | +- Categories: Feature, Tutorial |
| 93 | +- Tags: Video, Audio, TTS, Comments, Multimedia, Accessibility |
| 94 | + |
| 95 | +**Post: "LiaScript Meets OPAL"** |
| 96 | +- Categories: News, Feature |
| 97 | +- Tags: OPAL, LMS, Integration, GitLab |
| 98 | + |
| 99 | +**Post: "6 Quizzes in 100 Seconds"** |
| 100 | +- Categories: Tutorial |
| 101 | +- Tags: Quizzes, Interactive, Education, Video |
| 102 | + |
| 103 | +## Common Duplicates to Avoid |
| 104 | + |
| 105 | +- Use "TTS" not "Text-to-Speech" |
| 106 | +- Use "OER" not "Open Educational Resources" |
| 107 | +- Use "VS Code" not "VSCode" or "Visual Studio Code" |
| 108 | +- Use "LiveEditor" not "Live Editor" |
| 109 | +- Use "LiaScript" for core features, not as a tag for every post |
0 commit comments