---
title: Как дополнить вики
summary: Предложите статью, исправление или перевод через GitHub; приложите источники, пример и границы проверки.
section: wiki
kind: guide
status: reference
updated: 2026-10-26
tags: ["contributing","markdown","build","статья","вики"]
sources: ["https://github.com/dmitriishobolov/x4wiki-Contribute"]
---
## Предложение через GitHub


Откройте [формы предложений](https://github.com/dmitriishobolov/x4wiki-Contribute/issues/new/choose), выберите новую статью или исправление на русском либо английском. Укажите страницу, суть изменения, версию X4, источники и что действительно проверено. Нажмите **Create**: обсуждение будет в GitHub Issues.



Готовый текст можно прислать через Fork и Pull Request: положите заполненный шаблон в `proposals/`. [Пошаговая инструкция с примером](https://github.com/dmitriishobolov/x4wiki-Contribute/blob/main/CONTRIBUTING.md) и [шаблоны статьи](https://github.com/dmitriishobolov/x4wiki-Contribute/tree/main/templates) находятся в репозитории. Можно отправить предложение без 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:evidence).






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



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


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



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



## Сборка


```powershell
npm ci
npm run build
npm run check
npm run dev
```



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



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