Skip to content

Latest commit

 

History

History
109 lines (87 loc) · 3.78 KB

File metadata and controls

109 lines (87 loc) · 3.78 KB

LiaScript Blog Taxonomy Guide

Categories (Broad Content Types)

Categories represent the type of content. Each post should have 1-2 categories maximum.

  • Tutorial - Step-by-step guides, how-tos, and educational content
  • Feature - Announcements and explanations of new LiaScript features
  • News - Project updates, events, conferences, and community news
  • Case Study - Real-world examples and showcases of LiaScript usage
  • Documentation - Reference material and technical documentation
  • Community - User stories, interviews, and community contributions

Tags (Specific Topics)

Tags represent what the content is about. Posts can have multiple tags (3-10 recommended).

Technology & Tools

  • AI - Artificial intelligence, LLMs, ChatGPT, etc.
  • GitHub - GitHub-related content, workflows, Actions
  • GitLab - GitLab integration and features
  • VS Code - Visual Studio Code integration
  • LiveEditor - LiaScript LiveEditor features
  • Exporter - Export functionality and formats
  • 3D - 3D models and A-Frame integration

Content Types

  • Video - Video content and embedding
  • Audio - Audio features and podcasts
  • Podcast - Podcast episodes and audio shows
  • Images - Image handling and galleries
  • Multimedia - General multimedia content
  • Interactive - Interactive elements and features
  • Animation - Animation and transitions

Features

  • TTS - Text-to-Speech functionality
  • Quizzes - Quiz and assessment features
  • Survey - Surveys and polls
  • Code - Code execution and programming
  • Charts - Data visualization and charts
  • Tables - Table features
  • Comments - Comment functionality
  • Macros - Macro system
  • Tooltips - Tooltip functionality
  • Preview - Preview and card features
  • Classroom - Classroom and teaching features

Topics

  • OER - Open Educational Resources
  • Accessibility - Accessibility features
  • Education - Educational use cases
  • TVET - Technical and vocational education
  • Science - Scientific content and use cases
  • Programming - Programming education
  • Collaboration - Collaborative editing and content creation
  • Sharing - Content sharing and distribution

Integration

  • OPAL - OPAL LMS integration
  • LMS - Learning Management Systems
  • MOOC - Massive Open Online Courses
  • SCORM - SCORM packages
  • Nextcloud - Nextcloud integration
  • WebTorrent - Peer-to-peer sharing
  • P2P - Peer-to-peer technology
  • oEmbed - oEmbed protocol for embedding content

Languages & Formats

  • Markdown - Markdown-specific content
  • Python - Python-related content
  • JavaScript - JavaScript-related content
  • LiaScript - Core LiaScript language features

Guidelines

When to use Categories vs Tags

Categories answer: "What kind of post is this?"

  • Tutorial, Feature announcement, News, Case study, etc.

Tags answer: "What specific topics does this cover?"

  • AI, Video, TTS, GitHub, OER, etc.

Examples

Post: "From PDF to LiaScript Course — Speedrun with AI"

  • Categories: Tutorial, Case Study
  • Tags: AI, Video, TTS, Animation, GitHub, OER, Multimedia, LiveEditor

Post: "Multimedia Comments - This Changes Everything"

  • Categories: Feature, Tutorial
  • Tags: Video, Audio, TTS, Comments, Multimedia, Accessibility

Post: "LiaScript Meets OPAL"

  • Categories: News, Feature
  • Tags: OPAL, LMS, Integration, GitLab

Post: "6 Quizzes in 100 Seconds"

  • Categories: Tutorial
  • Tags: Quizzes, Interactive, Education, Video

Common Duplicates to Avoid

  • Use "TTS" not "Text-to-Speech"
  • Use "OER" not "Open Educational Resources"
  • Use "VS Code" not "VSCode" or "Visual Studio Code"
  • Use "LiveEditor" not "Live Editor"
  • Use "LiaScript" for core features, not as a tag for every post