GitRiver GitRiver
EN
Навигация

Сайты и Wiki

Хостинг статических сайтов из репозитория и встроенная Wiki с историей ревизий

Pages - статические сайты

GitRiver может размещать статические сайты прямо из репозитория: документация, лендинги, SPA-приложения. Файлы раздаются с вашего домена, без внешнего хостинга.

Включение Pages

  1. Откройте репозиторий -> «Настройки» -> раздел Pages
  2. Включите «Pages включён»
  3. Выберите источник:
    • CI - деплой из CI-пайплайна (по умолчанию). Job с именем pages должен создать директорию public/ в артефактах
    • Вручную - загрузка ZIP через интерфейс
  4. Укажите ветку (по умолчанию main)
  5. Опционально включите режим SPA - если файл не найден, возвращается index.html (для React, Vue, Angular)

Деплой из CI

Создайте workflow .gitriver/workflows/pages.yml:

name: Pages

on:
  push:
    branches: [main]

jobs:
  pages:
    image: node:22
    steps:
      - run: npm ci
      - run: npm run build
    artifacts:
      paths:
        - public/

Важно: директория public/ должна быть в артефактах job с именем pages (или с именем, указанным в настройках). После успешного завершения пайплайна сайт обновится автоматически.

Деплой вручную (ZIP)

  1. Откройте репозиторий -> Pages -> «Загрузить»
  2. Выберите ZIP-архив с файлами сайта
  3. Нажмите «Загрузить»

Ограничения: до 1 ГБ распакованного размера, до 10 000 файлов.

Просмотр сайта

Сайт доступен по адресу: https://git.example.com/_pages/{владелец}/{репозиторий}/

Для приватных репозиториев - требуется авторизация.

Custom domains

Чтобы привязать свой домен:

  1. Откройте Pages -> «Домены» -> «Добавить домен»
  2. Укажите домен (например, docs.example.com)
  3. GitRiver сгенерирует токен верификации
  4. Создайте DNS TXT-запись: _gitriver-pages.docs.example.com со значением токена
  5. Нажмите «Проверить» - GitRiver проверит DNS
  6. После верификации направьте домен на IP сервера GitRiver (A-запись или CNAME)

История деплоев

На странице Pages отображаются последние деплои: статус, размер, дата, автор. Старые деплои удаляются автоматически (хранятся последние 5).

Wiki

Wiki - встроенная документация для репозитория. Страницы пишутся в Markdown и хранятся в отдельном git-репозитории (не засоряя основной код).

Создание страницы

  1. Откройте репозиторий -> вкладка «Wiki»
  2. При первом посещении Wiki создаётся автоматически
  3. Нажмите «Новая страница»
  4. Укажите заголовок (из него генерируется slug: My Page -> My-Page)
  5. Напишите содержимое в Markdown
  6. Опционально укажите сообщение коммита
  7. Нажмите «Сохранить»

Редактирование

  1. Откройте страницу Wiki
  2. Нажмите «Редактировать»
  3. Измените содержимое
  4. Сохраните - изменения фиксируются как git-коммит

Переименование

При редактировании измените заголовок - страница будет переименована (старый slug удаляется, создаётся новый).

История ревизий

Каждое изменение - git-коммит. Для просмотра истории:

  1. Откройте страницу Wiki
  2. Нажмите «История»
  3. Вы увидите список коммитов: автор, дата, сообщение

Боковая навигация

Если в Wiki создана страница _Sidebar, её содержимое отображается в боковой панели на всех страницах. Если _Sidebar нет - навигация генерируется автоматически из списка страниц.

Пример _Sidebar:

### Навигация

- [Главная](/owner/repo/wiki/Home)
- [Установка](/owner/repo/wiki/Installation)
- [API](/owner/repo/wiki/API)

Удаление страницы

Откройте страницу -> «Удалить». Удаление необратимо (но можно восстановить через git-историю wiki-репозитория).