Структура контента

LIK-Learn использует трёхуровневую иерархию для организации учебного материала.

Paths → Tracks → Concepts

Concept (Концепт)

Минимальная единица обучения — одна идея, один навык, одна тема.

Характеристики:

• Время: 5-20 минут
• Файл: content/concepts/{id}/index.md
• Полностью самодостаточен (можно изучить отдельно)
• Содержит проверяющие атомы (quiz, flashcard, text-select) и визуальный слой подачи (dropcap, illustration, claim, marginalia, compare, chronicle, breather)

Визуальные шорткоды атомами не считаются: гейт не засчитывает их в разнообразие проверяющих. Метки достоверности ставит claim.

Пример: «Опричнина», «Хемосинтез», «Спрос и предложение», «Факт или мнение»

Track (Трек)

Связанная последовательность концептов по одной теме.

Характеристики:

• Время: 1-3 часа
• Требует 2 файла:
  • data/tracks/{id}.yaml — данные (список концептов, метаданные)
  • content/tracks/{id}.md — страница (для Hugo routing)
• Режимы: free (любой порядок) или sequential (строгий порядок)

Пример: “HTML Basics” (содержит: Tags, Attributes, Forms, Semantic HTML…)

Path (Путь)

Образовательный маршрут — комбинация треков и концептов для достижения цели.

Характеристики:

• Время: 5+ часов
• Требует 2 файла:
  • data/paths/{id}.yaml — данные (список треков/концептов)
  • content/paths/{id}.md — страница (для Hugo routing)
• Может содержать как треки, так и отдельные концепты

Пример: “Web Developer” (HTML Basics → CSS Basics → JavaScript Basics → Projects)

Визуализация структуры

Path: Web Developer (5+ часов)
├── Track: HTML Basics (1.5 часа)
│   ├── Concept: HTML Tags (10 мин)
│   ├── Concept: HTML Forms (15 мин)
│   └── Concept: Semantic HTML (12 мин)
│
├── Track: CSS Basics (2 часа)
│   ├── Concept: CSS Selectors (8 мин)
│   └── Concept: Flexbox (20 мин)
│
└── Track: JS Basics (3 часа)
    ├── Concept: Variables (10 мин)
    └── Concept: Functions (15 мин)

Пример: Web Developer Path

Правильная структура:

Path: Web Developer (5+ часов)
│
├─ Track: HTML Basics (1.5 часа)
│  ├─ Concept: HTML Tags (10 мин)
│  ├─ Concept: HTML Forms (15 мин)
│  └─ Concept: Semantic HTML (12 мин)
│
├─ Track: CSS Basics (2 часа)
│  ├─ Concept: CSS Selectors (8 мин)
│  ├─ Concept: Flexbox (20 мин)
│  └─ Concept: Grid (18 мин)
│
└─ Track: JavaScript Basics (3 часа)
   ├─ Concept: Variables (10 мин)
   ├─ Concept: Functions (15 мин)
   └─ Concept: DOM (20 мин)

Структура файлов

Concept (1 файл)

content/concepts/oprichnina/
└── index.md

Front Matter:

---
id: oprichnina
title: "Опричнина: что учредили и о чём спорят"
description: "Как Иван IV разделил страну на два двора и почему у историков нет одной версии"
concept_type: material
tags: [история, россия-xvi-век, егэ]
level: 5
duration: "20 мин"
hero:
  motif: divide
  theme: ink
  eyebrow: "История, XVI век"
  lead: "Царь уехал из столицы и прислал две грамоты."
  stats:
    - value: "1565-1572"
      label: "семь лет опричного порядка"
learning_objectives:
  - "Объяснить, как опричнина и земщина делили управление страной"
  - "Различить документ, свидетельство современника и версию историка"
  - "Взвесить доводы историков по тому, на что каждый опирается"
content_graph:
  topics:
    - id: main
      label: "Опричнина 1565-1572"
      expanded: true
      children:
        - id: nachalo
          label: "Как началась"
          children:
            - { label: "Отъезд из Москвы", note: "декабрь 1564" }
---

Track (2 файла!)

data/tracks/
└── html-basics.yaml

content/tracks/
└── html-basics.md

1. Data file (data/tracks/html-basics.yaml):

id: "html-basics"
title: "HTML Basics"
description: "Learn HTML fundamentals"
duration: "1.5 hours"
level: 1
tags: ["html", "web", "beginner"]
concepts:
  - html-tags
  - html-forms
  - semantic-html
mode: "free"  # or "sequential"

2. Page file (content/tracks/html-basics.md):

---
title: "HTML Basics"
dataFile: "html-basics"
---

Path (2 файла!)

data/paths/
└── web-developer.yaml

content/paths/
└── web-developer.md

1. Data file (data/paths/web-developer.yaml):

id: "web-developer"
title: "Web Developer"
description: "Become a web developer from scratch"
duration: "20 hours"
level: 1
items:
  - type: track
    id: html-basics
  - type: concept
    id: how-browser-works
  - type: track
    id: css-basics
  - type: track
    id: js-basics

2. Page file (content/paths/web-developer.md):

---
title: "Web Developer"
dataFile: "web-developer"
---

Режимы трека

Free mode (свободный)

mode: "free"

• Можно изучать концепты в любом порядке
• Нет строгих зависимостей
• Подходит для обзорных тем

Sequential mode (последовательный)

mode: "sequential"

• Строгий порядок изучения
• Каждый концепт открывается только после предыдущего
• Подходит для технических тем с зависимостями

Проверка понимания

Следующие шаги

• Front Matter полная спецификация полей
• Связи как связывать концепты через граф знаний
• Шорткоды что вставлять в Markdown