Что админ должен дать сотруднику

Перед настройкой сотрудник должен получить от администратора конкретные данные. Без них не нужно угадывать настройки самому.

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. Подробнее: Как открыть проект в Obsidian.

6. Настройки Digital Garden plugin

Админ должен дать готовую таблицу значений:

Если в плагине поле называется чуть иначе, сотрудник не придумывает значение сам, а спрашивает админа.

7. Правила главной страницы

Админ должен сказать, кто отвечает за главную страницу:

Главную страницу редактирует только админ

или:

Сотрудник может редактировать Home note по согласованию

Для обычных заметок сотруднику не нужно вручную задавать адрес страницы. Подробнее: Ссылки, картинки и главная страница.

8. Правила картинок

Админ должен сказать:

• куда складывать картинки внутри vault;
• как называть файлы;
• можно ли использовать русские названия файлов;
• можно ли загружать тяжёлые изображения;
• какие форматы разрешены.

Базовый безопасный вариант:

папка: foto
названия: латиница, цифры, дефисы
форматы: jpg, png, webp, svg

9. Кому писать при проблемах

Админ должен дать контакт:

Telegram: @...
Email: ...
Рабочий чат: ...

Для проблемы лучше отправлять не “у меня не работает”, а отчёт по шаблону: Шаблон отчёта админу о проблеме.

Навигация

Предыдущий шаг: Карта гайда
Следующий шаг: Что сотрудник должен отправить админу