Гайд Duck Obsidian
Duck Obsidian — гайд для сотрудников
Этот гайд объясняет, как сотруднику настроить у себя рабочий Obsidian garden: GitHub, fine-grained token, Obsidian, плагины и публикацию заметок.
Здесь нет технической админской части. Сотруднику не нужно разбираться в инфраструктуре, запуске сайта, обслуживании домена или технических командах публикации. Вся админская часть остаётся у администратора.
Для кого этот гайд
Для сотрудника, который будет:
- писать заметки в Obsidian;
- публиковать выбранные заметки на сайт через Digital Garden plugin;
- работать с GitHub-репозиторием garden;
- безопасно создать и использовать свой fine-grained token;
- понимать, что нужно получить от администратора и что отправить администратору после настройки.
Быстрый маршрут
- Прочитай Что админ должен дать сотруднику.
- Отправь админу данные из Что сотрудник должен отправить админу.
- Настрой Настройка GitHub-доступа.
- Создай Токен для Digital Garden plugin.
- Открой проект в Obsidian по инструкции Как открыть проект в Obsidian.
- Настрой Настройка Digital Garden plugin.
- Сделай первую тестовую публикацию по инструкции Как опубликовать заметку из Obsidian.
- Перед рабочей публикацией используй Чеклист перед публикацией.
- Если что-то не работает, открой Типовые проблемы сотрудника и Что отправить админу при проблеме.
Главное правило
Сотрудник работает только с понятными вещами:
GitHub repo
Obsidian vault
Digital Garden plugin
fine-grained token
заметки
картинки
ссылки
Сотрудник не трогает техническую часть сайта и не пытается чинить публикацию вручную. Если публикация не дошла до сайта, сотрудник собирает понятный отчёт и отправляет админу: см. Шаблон отчёта админу о проблеме.
Структура гайда
getting-started/ что получить от админа и что отправить админу
setup/ первичная настройка GitHub, token, Obsidian, plugin
workflow/ ежедневная работа: публикация, ссылки, картинки, git
quality/ проверка перед публикацией
security/ безопасность token и доступов
troubleshooting/ что делать при типовых проблемах
templates/ готовые сообщения админу
Навигация
Предыдущий шаг: —
Следующий шаг: Карта гайда