Перекрёстные ссылки

Обычный текст статей не преобразуется автоматически — так мы не ломаем формулировки и не получаем ложных ссылок (например, на слово «данные» в бытовом смысле). Связи добавляются только явно — в разметке пишут [[SQL]], [[Данные]] и т.п.

Синтаксис [[...]] в тексте

Запись	Результат
[[Данные]]	Ссылка на термин в глоссарии (если есть заголовок ## Данные)
[[SQL]]	Ссылка на раздел энциклопедии из словаря или по уникальному заголовку статьи
[[Данные|модель данных]]	Та же ссылка, но подпись «модель данных»
[[/encyclopedia/1-basics/1-08-kak-rabotaet-kompyuter/2]]	Прямой путь
[[/glossary/Д#данные|данные]]	Прямой путь с якорем

Если термин не найден в индексе, в тексте остаётся исходная запись [[...]] без ссылки.

Не срабатывает внутри кода, существующих ссылок и JSX — только в обычных абзацах.

Пример

В реляционных СУБД [[Данные]] хранятся в таблицах; подробнее — в разделе [[SQL]].

Блок «Связанные темы» (front matter)

В начале файла можно задать список без правки абзацев:

---
title: Моя статья
related:
  - title: Данные
    href: /glossary/Д#данные
  - title: Основы баз данных
    doc: encyclopedia/3-data-markup/3-05-osnovy-baz-dannyh/intro
---

Блок выводится под текстом статьи, перед «См. также».

Связи в разделе «Основы»

npm run docs:basics-crosslinks

Только блок related в intro.md подразделов (секция «Связанные темы» внизу страницы). Не вставляйте [[...]] массово в текст — в MDX они отображаются как сырой текст, если не настроен отдельный плагин при сборке.

Откат ошибочной разметки [[...]] в «Основах»:

npm run docs:revert-basics-wiki

Индекс ссылок

Перед сборкой сайта обновляется индекс:

npm run docs:wiki-links

Он собирает:

• все термины глоссария (## в docs/glossary/);
• уникальные заголовки статей энциклопедии;
• ручной словарь src/data/encyclopediaTermLinks.json (приоритетнее автоматики).

Результат: src/data/wikiLinkIndex.json.

Ручные соответствия

Файл src/data/encyclopediaTermLinks.json — для частых терминов и синонимов (операционная система, ОС, бэкенд). Добавляйте пары «термин → путь» по мере работы над разделами.

---