Диагностика
Почему после публикации не загружаются картинки
Проверка путей, регистра, кодировки имён и сетевых ответов без случайного переименования всего проекта.
Значок битого изображения означает, что браузер не получил файл по адресу из `src`. Причина обычно видна в панели Network: статус `404` указывает на неверный путь, `403` — на запрет доступа, а ошибка mixed content появляется, когда HTTPS-страница запрашивает ресурс по HTTP.
## Сначала проверить точный адрес
Путь можно скопировать из HTML или панели разработчика и открыть в новой вкладке. Если `https://site.example/img/cover.jpg` не существует, нужно сравнить его с деревом Assets.
```html
<!-- Браузер ищет файл в /img/ -->
<img src="/img/cover.jpg" alt="Обложка">
```
Файл может лежать в `images/cover.jpg`, называться `Cover.JPG` или оказаться внутри лишней папки архива. Все эти варианты дают другой URL.
## Регистр и символы в имени
На сервере `photo.JPG` и `photo.jpg` — разные файлы. Кириллица, пробелы и скобки допустимы в URL, но повышают риск повреждённой кодировки при архивировании. Для новых проектов надёжнее латиница, нижний регистр и дефисы.
Deploya нормализует имена при загрузке и, если точный путь не найден, пробует безопасный совместимый поиск в той же папке. Файл отдаётся только при одном однозначном совпадении. Это помогает старым архивам, но не угадывает, какую из двух похожих фотографий имел в виду HTML.
> Место для скриншота: Network в DevTools с запросом изображения, статусом 404 и полным URL.
## Абсолютный путь с компьютера
Записи `C:\Users\name\Desktop\image.png` и `file:///...` работают только на устройстве автора. Фотография должна находиться внутри проекта, а HTML должен ссылаться на неё относительным или корневым адресом.
В CSS проверяется `url(...)`:
```css
.hero {
background-image: url('../img/hero.webp');
}
```
Этот путь считается относительно файла CSS, а не HTML. Для `css/style.css` запись `../img/hero.webp` поднимается на уровень выше и входит в каталог `img`.
После исправления достаточно загрузить изменённый HTML, CSS или изображение в режиме частичного обновления. Если папки переименованы, полная замена удалит старые дубликаты и даст более чистый результат.