what-admin-gives-you
Что админ должен дать сотруднику
Перед настройкой сотрудник должен получить от администратора конкретные данные. Без них не нужно угадывать настройки самому.
1. Название garden
Пример:
Obsidian Duck Guide
Это человеческое название проекта. Оно нужно, чтобы сотрудник понимал, с каким garden он работает.
2. Публичный адрес сайта
Пример:
https://example-garden.example.com
Этот адрес нужен для проверки: после публикации заметка должна открываться на этом сайте.
3. GitHub repo
Админ должен дать ссылку на GitHub-репозиторий garden.
Пример:
https://github.com/<owner>/<garden-repo>
И отдельно лучше дать:
GitHub owner: <owner>
Repository name: <garden-repo>
Branch: main
Эти значения понадобятся в Digital Garden plugin и Git.
4. Доступ к repo
Админ должен добавить сотрудника в GitHub repo или дать другой согласованный способ доступа.
Сотрудник должен получить invite в GitHub и принять его. Подробнее: GitHub-доступ.
5. Название vault-папки
Админ должен сказать, какую папку открывать в Obsidian.
Пример:
<slug>-vault
Важно: открывать нужно именно vault-папку, а не весь GitHub repo. Подробнее: как открыть vault.
6. Настройки Digital Garden plugin
Админ должен дать готовую таблицу значений:
| Поле | Что вставлять |
|---|---|
| GitHub username / owner | <owner> |
| GitHub repo name | <garden-repo> |
| Branch | main или другое значение от админа |
| Site URL / Garden URL | публичный адрес сайта |
| Publish folder / Export folder | значение от админа |
| Token | сотрудник создаёт сам и никому не отправляет |
Если в плагине поле называется чуть иначе, сотрудник не придумывает значение сам, а спрашивает админа.
7. Правила главной страницы
Админ должен сказать, кто отвечает за главную страницу:
Главную страницу редактирует только админ
или:
Сотрудник может редактировать Home note по согласованию
Для обычных заметок сотруднику не нужно вручную задавать адрес страницы. Подробнее: ссылки, картинки и главная.
8. Правила картинок
Админ должен сказать:
- куда складывать картинки внутри vault;
- как называть файлы;
- можно ли использовать русские названия файлов;
- можно ли загружать тяжёлые изображения;
- какие форматы разрешены.
Базовый безопасный вариант:
папка: foto
названия: латиница, цифры, дефисы
форматы: jpg, png, webp, svg
9. Кому писать при проблемах
Админ должен дать контакт:
Telegram: @...
Email: ...
Рабочий чат: ...
Для проблемы лучше отправлять не “у меня не работает”, а отчёт по шаблону: problem report.