Refactor documentation structure and update links; remove outdated content

This commit is contained in:
2026-04-25 13:53:11 +03:00
parent f622c09fd4
commit 8cee39ad1c
20 changed files with 12 additions and 525 deletions

View File

@@ -1,7 +1,6 @@
import { defineConfig } from 'astro/config'; import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight'; import starlight from '@astrojs/starlight';
const showEditorDocs = process.env.PUBLIC_SHOW_EDITOR_DOCS === 'true';
export default defineConfig({ export default defineConfig({
site: 'https://wiki.example.com', site: 'https://wiki.example.com',
@@ -82,19 +81,8 @@ export default defineConfig({
{ label: 'Все IP', link: '/all-ip/' }, { label: 'Все IP', link: '/all-ip/' },
{ label: 'Контакты и ссылки', link: '/contacts/' } { label: 'Контакты и ссылки', link: '/contacts/' }
] ]
},
...(showEditorDocs
? [
{
label: 'Для редакторов',
items: [
{ label: 'Как редактировать wiki', link: '/editing/' },
{ label: 'Шаблон новой страницы', link: '/templates/new-page-template/' }
]
} }
] ]
: [])
]
}) })
] ]
}); });

View File

@@ -10,8 +10,8 @@ const shouldRenderSearch =
const topLinks = [ const topLinks = [
{ label: 'Старт', href: '/getting-started/' }, { label: 'Старт', href: '/getting-started/' },
{ label: 'Гайды', href: '/guides/' }, { label: 'Команды', href: '/commands/' },
{ label: 'Механики', href: '/mechanics/' }, { label: 'Города', href: '/cities/' },
{ label: 'FAQ', href: '/faq/' }, { label: 'FAQ', href: '/faq/' },
{ label: 'Правила', href: '/rules/' } { label: 'Правила', href: '/rules/' }
]; ];
@@ -427,7 +427,8 @@ const topLinks = [
}; };
const enhanceSidebarGroupLinks = () => { const enhanceSidebarGroupLinks = () => {
const targets = [{ label: 'Алкоголь', href: '/alcohol/' }]; const targets = [];
if (targets.length === 0) return;
const labelNodes = document.querySelectorAll('.sidebar-content details > summary .group-label .large'); const labelNodes = document.querySelectorAll('.sidebar-content details > summary .group-label .large');
labelNodes.forEach((labelNode) => { labelNodes.forEach((labelNode) => {

View File

@@ -23,7 +23,7 @@ description: "Концепция мира, формат сервера и осн
<div class="see-also"> <div class="see-also">
<p>Смотри также</p> <p>Смотри также</p>
<a href="/mechanics/">Механики</a> · <a href="/team/">Команда проекта</a> <a href="/general/">Общее</a> · <a href="/faq/">FAQ</a>
</div> </div>

View File

@@ -1,19 +0,0 @@
---
title: "Алкоголь"
description: "Переход к подразделам алкогольной системы."
---
## Подразделы
Выберите нужный раздел:
<div class="lore-grid alcohol-nav-grid">
<a class="lore-card alcohol-nav-card" href="/alcohol-brewing/">
<h3>Как варить</h3>
<p>Ферментация, бочки, качество напитков, алкогольность и эффекты.</p>
</a>
<a class="lore-card alcohol-nav-card" href="/alcohol-recipes/">
<h3>Рецепты напитков</h3>
<p>Полный список рецептов, ингредиентов и параметров приготовления.</p>
</a>
</div>

View File

@@ -11,8 +11,8 @@ description: "Адреса и порты сервера PARABOX для Java и B
<ul> <ul>
<li> <li>
Основной: Основной:
<button class="copy-ip-chip" type="button" data-copy-ip="mc.rpcm.su" aria-label="Скопировать: mc.rpcm.su"> <button class="copy-ip-chip" type="button" data-copy-ip="mc.parabox.su" aria-label="Скопировать: mc.parabox.su">
<code>mc.rpcm.su</code> <code>mc.parabox.su</code>
</button> </button>
</li> </li>
<li> <li>
@@ -29,8 +29,8 @@ description: "Адреса и порты сервера PARABOX для Java и B
<ul> <ul>
<li> <li>
Основной: Основной:
<button class="copy-ip-chip" type="button" data-copy-ip="mc.rpcm.su" aria-label="Скопировать: mc.rpcm.su"> <button class="copy-ip-chip" type="button" data-copy-ip="mc.parabox.su" aria-label="Скопировать: mc.parabox.su">
<code>mc.rpcm.su</code> <code>mc.parabox.su</code>
</button> </button>
</li> </li>
<li> <li>

View File

@@ -1,47 +0,0 @@
---
title: "Города и регистрация"
description: "Как пройти регистрацию, вступить в город или запустить собственный проектный город."
---
## Как попасть на сервер
1. Перейдите в бота заявок: <a href="https://t.me/RPCM_MINE_BOT" target="_blank" rel="noopener noreferrer"><strong>@RPCM_MINE_BOT</strong></a>.
2. Заполните анкету и дождитесь подтверждения.
3. Подключитесь по адресу `mc.rpcm.su`.
4. Пройдите регистрацию в игре.
## Как выбрать город
После входа у вас есть два рабочих сценария:
- вступить в уже существующий город;
- создать собственный город проекта.
Если вступаете в существующий город, проверьте его правила и требования к жителям. Если создаете новый, подготовьте описание, цели и формат набора.
## Как запустить свой город
### Минимальный шаблон объявления
```text
Название города:
Координаты:
Мэр / управляющий орган:
Описание:
Набор жителей: да / нет
Правила города:
```
### Что важно указать сразу
- чем город занимается и какой стиль игры поддерживает;
- кого вы ищете в первую очередь;
- есть ли внутренние ограничения и роли;
- как с вами связаться.
## Где смотреть полезную информацию
- IP и резервные адреса: <a href="/all-ip/">Все IP</a>
- Базовые правила: <a href="/rules/">Правила</a>
- Частые вопросы: <a href="/faq/">FAQ</a>
- Раздел по городам: <a href="/cities/">Города</a>

View File

@@ -33,7 +33,7 @@ description: "Раздел для представления городов и
Правила города: Правила города:
``` ```
Подробный процесс входа на сервер и запуска города описан в статье <a href="/cities-registration/">«Города и регистрация»</a>. Подробный процесс входа на сервер описан в статье <a href="/getting-started/">«Начало игры»</a>.
:::tip :::tip
Чем понятнее и полнее описание города, тем быстрее к вам присоединятся игроки. Чем понятнее и полнее описание города, тем быстрее к вам присоединятся игроки.

View File

@@ -1,33 +0,0 @@
---
title: "Донат / привилегии"
description: "Добровольная поддержка сервера, наборы и прозрачные правила привилегий."
---
## Принципы
- Донат не должен ломать баланс мира.
- Боевые преимущества ограничены и прозрачны.
- Все пакеты имеют чёткое описание.
## Уровни поддержки
| Уровень | Что входит |
| --- | --- |
| Traveler | Косметика + расширенный /home |
| Patron | Больше слотов хранилища + титул |
| Curator | Эксклюзивные визуальные эффекты |
## Политика возвратов
Возвраты рассматриваются через тикет-систему в течение 7 дней после покупки.
:::note
Покупка привилегий - способ поддержать развитие сервера, а не обязательное условие комфортной игры.
:::
<div class="see-also">
<p>Смотри также</p>
<a href="/rules/">Правила</a> · <a href="/contacts/">Контакты / ссылки</a>
</div>

View File

@@ -1,38 +0,0 @@
---
title: "Экономика"
description: "Валюты, рынки, аукцион, контракты и рекомендации по торговле."
---
## Валюты
- `Aurum` - базовая торговая валюта.
- `Echo` - редкая валютная единица для реликвий.
## Как работает рынок
### Аукцион
Игроки выставляют предметы на открытый рынок.
### Контракты
Сделки между игроками с фиксированными условиями.
## Мини-стратегия для старта
| Шаг | Действие | Ожидаемый эффект |
| --- | --- | --- |
| 1 | Продавать излишки еды | Быстрый стартовый капитал |
| 2 | Копить железо и редстоун | Стабильный спрос |
| 3 | Вкладываться в алхимию | Высокая маржа |
:::caution
Не держи все активы в одном виде ресурса: цены цикличны.
:::
<div class="see-also">
<p>Смотри также</p>
<a href="/items-resources/">Предметы и ресурсы</a> · <a href="/donate/">Донат / привилегии</a>
</div>

View File

@@ -1,64 +0,0 @@
---
title: "Как редактировать wiki"
description: "Простая инструкция по добавлению и изменению страниц в Markdown."
---
## Быстрый принцип
Каждая статья - отдельный `.md`-файл в `src/content/docs/`.
## Минимальный frontmatter
```yaml
---
title: "Название страницы"
description: "Короткое описание страницы"
---
```
## Как добавить новую страницу
1. Создай файл в `src/content/docs/`, например `new-biome.md`.
2. Добавь frontmatter (`title`, `description`).
3. Напиши контент в Markdown (заголовки, списки, таблицы, код).
4. Добавь ссылку в `sidebar` в `astro.config.mjs`.
## Полезные блоки Starlight
```md
:::note
Заметка
:::
:::tip
Подсказка
:::
:::caution
Предупреждение
:::
:::danger
Опасность
:::
```
## Пример spoiler/details
```md
<details>
<summary>Показать секрет</summary>
Здесь скрытый текст.
</details>
```
## Где редактируется меню
Меню и порядок разделов настраиваются в `astro.config.mjs` -> `starlight({ sidebar: [...] })`.
<div class="see-also">
<p>Смотри также</p>
<a href="/templates/new-page-template/">Шаблон новой страницы</a>
</div>

View File

@@ -1,50 +0,0 @@
---
title: "Гайды"
description: "Практические сценарии: выживание, прогресс, босс-раны и командная игра."
---
## Навигатор по гайдам
<div class="lore-grid">
<article class="lore-card">
<h3>Соло-старт</h3>
<p>Как стабильно развиться одному игроку за первые два вечера.</p>
</article>
<article class="lore-card">
<h3>Гильдейский старт</h3>
<p>Роли в группе, распределение ресурсов и ротация задач.</p>
</article>
<article class="lore-card">
<h3>Босс-раны</h3>
<p>Минимальный набор, тактики и контроль рисков на арене.</p>
</article>
</div>
## Пример структурированного гайда
### Подготовка
- 32+ еды
- Броня не ниже железной
- 2 тотема или 3 зелья лечения
### Выполнение
1. Активируй обелиск.
2. Удерживай центральную платформу 3 волны.
3. Сфокусируй урон по призывателю на 4-й фазе.
### Завершение
Разбери добычу по ролям: танк, саппорт, дамагер.
:::danger
Не заходи в событие с поломанной бронёй: штраф на урон и критический риск потери лута.
:::
<div class="see-also">
<p>Смотри также</p>
<a href="/mechanics/">Механики</a> · <a href="/professions/">Профессии / классы / расы</a>
</div>

View File

@@ -25,7 +25,7 @@ Project PARABOX объединяет проекты РПКМ и игроков
4. Выберите город для вступления или создайте свой проектный город. 4. Выберите город для вступления или создайте свой проектный город.
5. Ознакомьтесь с правилами и базовыми механиками. 5. Ознакомьтесь с правилами и базовыми механиками.
Подробный разбор процесса вступления и запуска города находится в статье <a href="/cities-registration/">«Города и регистрация»</a>. Подробный разбор процесса вступления находится в статье <a href="/getting-started/">«Начало игры»</a>, а информация по городам — в разделе <a href="/cities/">«Города»</a>.
## Основные особенности ## Основные особенности

View File

@@ -1,42 +0,0 @@
---
title: "Предметы и ресурсы"
description: "Каталог ключевых материалов, редких артефактов и их применение."
---
## Базовые ресурсы
- Древесина
- Камень
- Железо
- Кварц
## Редкие материалы
### Пыль кометы
Используется для усиления портальных якорей.
### Лунный обсидиан
Нужен для защитных печатей и высокоуровневых рецептов.
## Пример блока внимания
:::danger
Артефакты с меткой «Связанный» нельзя передавать или продавать.
:::
## Таблица предметов
| Предмет | Где найти | Для чего нужен |
| --- | --- | --- |
| Пыль кометы | Небесный дождь | Ритуалы усиления |
| Лунный обсидиан | Глубинные разломы | Структуры защиты |
| Эхо-кристалл | Рейдовые боссы | Улучшение реликвий |
<div class="see-also">
<p>Смотри также</p>
<a href="/mechanics/">Механики</a> · <a href="/guides/">Гайды</a>
</div>

View File

@@ -1,41 +0,0 @@
---
title: "Механики"
description: "Основные игровые системы: энергия, климат, аномалии и мировые события."
---
## Энергия эфира
Эфир усиливает способности и влияет на доступ к скрытым зонам.
| Уровень эфира | Эффект |
| --- | --- |
| 0-20 | Базовые действия |
| 21-60 | Бонус к добыче и скорости |
| 61+ | Открываются артефактные узлы |
### Как повышать эфир
- Выполнять ежедневные контракты.
- Закрывать аномалии в группе.
- Исследовать архивные башни.
## Мировые события
### Разломы
Появляются раз в несколько часов и требуют командной обороны.
### Небесный дождь
Даёт редкие ингредиенты, но привлекает элитных мобов.
:::note
`h2` и `h3` автоматически попадают в оглавление страницы справа.
:::
<div class="see-also">
<p>Смотри также</p>
<a href="/items-resources/">Предметы и ресурсы</a> · <a href="/rules/">Правила</a>
</div>

View File

@@ -1,42 +0,0 @@
---
title: "Профессии / классы / расы"
description: "Гибкая RPG-система: роли, бонусы, ограничения и синергия в группе."
---
## Расы
- Астралы: бонус к мане и исследованию.
- Форджеры: ускоренный крафт и переработка руд.
- Вейлборны: скрытность и мобильность.
## Классы
### Страж
Высокая выживаемость и контроль зоны.
### Проводник
Баффы команды и лечение в бою.
### Пилигрим
Урон по одиночным целям и ускорение перемещения.
## Профессии
1. Алхимик
2. Инженер
3. Хранитель ферм
4. Архивариус-торговец
:::tip
Лучше выбрать профессию, которая дополняет класс, а не дублирует его сильные стороны.
:::
<div class="see-also">
<p>Смотри также</p>
<a href="/economy/">Экономика</a> · <a href="/guides/">Гайды</a>
</div>

View File

@@ -1,18 +0,0 @@
---
title: "Приват и защита"
description: "Базовые принципы защиты территорий и имущества игроков."
---
## Статус раздела
Раздел в подготовке. Здесь будет структурированная инструкция по привату.
## Что появится
- команды для создания и управления приватами;
- добавление участников и права доступа;
- ограничения и практики безопасного хранения ресурсов.
:::caution
Пока раздел не заполнен, согласовывайте спорные ситуации по территории через администрацию.
:::

View File

@@ -1,18 +0,0 @@
---
title: "SkinRestore"
description: "Настройка и восстановление скина на сервере PARABOX."
---
## Статус раздела
Раздел в подготовке. Здесь будет инструкция по установке и обновлению скинов.
## Что появится
- базовые команды SkinRestore;
- рекомендации для лицензии и оффлайн-режима;
- список частых проблем и решений.
:::tip
До выхода полной инструкции используйте стандартную команду смены скина и проверяйте корректность ника.
:::

View File

@@ -1,8 +0,0 @@
---
title: "Сюжет"
description: "Раздел сюжета сервера."
---
## Сюжет
СЕРЕЖА РЕСПЕШИ МНЕ СЮЖЕТИК И ВЧЕ ЧТО С НИМ СВЯЗАНО

View File

@@ -1,34 +0,0 @@
---
title: "Команда проекта"
description: "Кто развивает сервер: роли, ответственность и зоны поддержки."
---
## Состав команды
| Роль | Зона ответственности |
| --- | --- |
| Lead Admin | Архитектура мира и баланс |
| Content Designer | Квесты, лор, события |
| Tech Admin | Стабильность, плагины, бэкапы |
| Community Manager | Коммуникация с игроками |
## Как мы работаем
### Принцип 1
Решения по балансу принимаются на основе статистики, а не эмоций.
### Принцип 2
Критические правки публикуются с changelog.
## Как присоединиться
Следи за открытыми ролями в Discord и оставляй заявку с примерами работ.
<div class="see-also">
<p>Смотри также</p>
<a href="/contacts/">Контакты / ссылки</a> · <a href="/about-server/">О сервере</a>
</div>

View File

@@ -1,48 +0,0 @@
---
title: "Шаблон новой страницы"
description: "Готовый шаблон Markdown-страницы для быстрого добавления новых материалов."
---
## Копируй и используй
```md
---
title: "Название раздела"
description: "Краткое описание страницы"
---
## Введение
Коротко опиши, что на странице.
## Основной раздел
### Подраздел
- Пункт 1
- Пункт 2
:::tip
Добавляй подсказки через стандартные блоки Starlight.
:::
## Таблица
| Колонка | Значение |
| --- | --- |
| Пример | Текст |
<div class="see-also">
<p>Смотри также</p>
<a href="/getting-started/">Начало игры</a>
</div>
```
## Рекомендации по структуре
- Один файл = одна тема.
- Пиши короткие абзацы.
- Используй `h2` и `h3`, чтобы оглавление было полезным.
- Добавляй блок «Смотри также» в конце страницы.