Настройка sourcecraft-publisher
Быстрый старт
- Скопируйте
.env.example:cp config/.env.example config/.env - Заполните переменные (см. ниже)
Получение токена SourceCraft
- Откройте SourceCraft
- Перейдите в Settings → Access Tokens
- Создайте токен с правами Contents: Read and Write на нужный репозиторий
- Скопируйте токен в
SOURCECRAFT_TOKEN
Если интерфейс отличается — ищите раздел OAuth/PAT tokens в настройках профиля или организации.
Переменные окружения
| Переменная | Обязательна | Описание |
|---|---|---|
SOURCECRAFT_TOKEN |
да | OAuth2 токен для push в SourceCraft |
SOURCECRAFT_REPO |
да | org/repo — целевой репозиторий |
SOURCECRAFT_BRANCH |
нет | Ветка для push (default: master) |
SOURCECRAFT_SITE_URL |
да | Публичный URL сайта, например https://org.sourcecraft.site/repo |
Структура публикации
Артифакты публикуются в директории:
YYYY/YYYY-MM/page-slug/Итоговый URL:
<SOURCECRAFT_SITE_URL>/YYYY/YYYY-MM/page-slug/SourceCraft Sites конфигурация
Скрипт автоматически создаёт .sourcecraft/sites.yaml в репозитории если его нет:
site:
root: "."
ref: master