common-problems
Типовые проблемы сотрудника
Здесь только пользовательские проблемы: GitHub, token, Obsidian, plugin, публикация notes.
Repo не открывается в GitHub
Что проверить:
- ты вошёл в правильный GitHub account;
- invite принят;
- owner/repo написаны правильно;
- админ дал правильную ссылку.
Что отправить админу:
GitHub username: @...
Repo link: ...
Что вижу: 404 / invite не пришёл / нет доступа
Plugin пишет, что нет доступа
Частые причины:
- token не вставлен;
- token истёк;
- token создан не для того owner;
- token создан не для того repo;
- у token нет
Contents: Read and write; - GitHub invite не принят.
Что сделать:
- Проверить GitHub invite.
- Проверить настройки token.
- При необходимости создать новый token по инструкции.
- Если не помогло — отправить админу problem report.
Note не появилась на сайте
Проверить:
- note действительно опубликована через Digital Garden plugin;
- plugin не показал ошибку;
- изменения появились в GitHub repo;
- note не является черновиком;
- у note есть publish-флаг, если команда использует ручную отметку.
Если в GitHub изменений нет, проблема на стороне Obsidian/plugin/token.
Если в GitHub изменения есть, но на сайте не видно — отправь админу отчёт. Не нужно пытаться чинить техническую часть самому.
Ссылка ведёт на страницу ошибки
Чаще всего целевая note не опубликована.
Пример:
Вторая заметка
Проверь, что Вторая заметка тоже опубликована.
Картинка видна в Obsidian, но не видна на сайте
Проверь:
- картинка лежит в разрешённой папке;
- название файла аккуратное;
- файл картинки отправлен в GitHub;
- в note нет ссылки на файл с твоего компьютера вроде
file:///....
Если не помогло, отправь админу:
Название note:
Название картинки:
Где картинка лежит в vault:
Как картинка вставлена в note:
Скриншот из Obsidian:
Ссылка на страницу сайта:
Git conflict
Не решай конфликт наугад.
Отправь админу:
У меня git conflict.
Файлы: ...
Я менял: ...
Что показывает GitHub Desktop / terminal: ...
Obsidian открыл слишком много технических файлов
Скорее всего открыт весь repo, а не vault.
Закрой vault и открой только папку:
<slug>-vault
Подробнее: Obsidian vault.