Где редактировать#

Статьи лежат в wiki/content/*.md. dist генерируется; оформление находится в assets, разделы — в site.config.mjs, главная — в scripts/home.mjs.

Веб-редактора и аккаунтов нет. Кнопка «Скачать Markdown» отдаёт исходник текущей статьи; изменения вносятся в файлы проекта.

Английские статьи находятся в content/en/ с теми же именами файлов. У перевода есть title, summary и sourceHash исходной русской статьи. После правки проверьте обе версии и обновите хеш только после сверки перевода. Имена API и исходные фрагменты кода сохраняются. Сборка отклоняет отсутствующий или устаревший перевод.

Главная редакционная граница#

Основной материал относится к одиночному моддингу: кораблям, параметрам, данным, скриптам и UI. Он должен быть понятен без знания X4FO.

Синхронизация, репликация, авторитет хоста и разборы сетевого проекта относятся к section: network. Ссылки на них допустимы как явно выделенное самостоятельное направление; они не подменяют обычный путь решения задачи.

Новая статья#

Используйте устойчивое латинское имя файла. Пример frontmatter:

MARKDOWN
---
title: Название материала
summary: Что читатель изменит и какой результат получит.
section: ships
kind: guide
status: example
tags: ["ship", "macro"]
sources: ["wiki/references/vanilla-9.00.md"]
---
## Задача

Опишите результат и нужные исходные данные.

Корневой H1 берётся из title; начинайте тело с ##. Поддерживаются Markdown-списки, таблицы, цитаты и fenced code blocks. Произвольный HTML выводится текстом.

Поля#

Разделы: start, ships, data, scripting, ui, native, reference, network, wiki.

Вид: guide, api, example. Статус: verified, observed, example, reference. Значение статусов.

Массивы tags и sources записываются в JSON-синтаксисе. Источником может быть HTTPS-страница или разрешённый авторский материал в docs, notes, extension, native, x4_online, tools, wiki/references.

Не включайте личные данные, ключи, сейвы или извлечённые оригинальные исходники игры. Краткие факты чтения можно записать своими словами в wiki/references.

Внутренние ссылки#

MARKDOWN
[Новый корабль](wiki:adding-ship)
[Своё окно](wiki:create-ui)

Сборка обновляет навигацию, оглавления и поиск. Рекомендации не смешивают общий материал с сетевым разделом; поиск имеет явный выбор направления.

Сборка#

POWERSHELL
npm ci
npm run build
npm run check
npm run dev

Установка нужна при первом запуске или изменении lock-файла. dev следит за статьями и assets; после изменения обновите браузер. Скрипты сборки и конфигурация требуют перезапуска сервера.

У примера укажите точку вставки, типы значений и предпосылки. Если его не запускали в игре, оставьте учебный статус.