Предложение через GitHub#

Откройте формы предложений, выберите новую статью или исправление на русском либо английском. Укажите страницу, суть изменения, версию X4, источники и что действительно проверено. Нажмите Create: обсуждение будет в GitHub Issues.

Готовый текст можно прислать через Fork и Pull Request: положите заполненный шаблон в proposals/. Пошаговая инструкция с примером и шаблоны статьи находятся в репозитории. Можно отправить предложение без Git и локальной установки вики.

Редактор проверяет материал и переносит его в рабочую копию сайта, затем обновляет перевод и публикует после проверки. Issue и слияние PR не запускают автоматическую публикацию. Для изменения существующей страницы скачайте её Markdown и приложите исправленный вариант со ссылкой на оригинал.

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

Дальше описана работа редактора в основной рабочей копии сайта. Это отдельная папка от репозитория предложений: статьи лежат в wiki/content/*.md. dist генерируется; оформление находится в assets, разделы - в site.config.mjs, главная - в scripts/home.mjs.

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

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

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

Синхронизация, репликация, авторитет хоста и разборы сетевого проекта относятся к 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. Значение статусов.

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

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

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

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

Сборка#

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

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

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