Страницы с ошибкой 404 являются важным элементом любого сайта; даже если сайт хорошо управляется, всегда есть вероятность, что кто-то неправильно введет ссылку или изменит URL страницы без очистки связанных ссылок. С помощью страницы с ошибкой вы можете не только сообщить пользователям, что что-то пошло не так, но и перенаправить их на альтернативные ресурсы, чтобы побудить их продолжать просматривать ваш сайт.

Хотя предыдущие бета-версии Publii не включали 404 страницы, июльское обновление представило встроенную поддержку 404 страниц во всех темах, включенных в стандартный пакет Publii.

Настройка страниц 404 в темах Publii

В файле конфигурации темы (config.json) есть раздел renderer; здесь мы можем увидеть, включено ли в теме 404 страницы и какие имена будут у файлов.

Примечание: Как только страница 404 будет включена, будет создан новый файл с именем 404.hbs, который содержит содержимое страницы 404.

В разделе рендеринга есть один, а в URL (Настройках) - второй параметр, который вы можете настроить для своих страниц с ошибками:

...
"renderer": {
    ...
    "create404page": false
    ...
},
...

Параметр create404page используется для включения или отключения страниц ошибок; по умолчанию для него установлено значение false на новых общедоступных сайтах. Раздел URLs (Настройки) предлагает возможность определить имя файла, содержащего страницу с ошибкой 404, которая будет отображаться при создании веб-сайта.

Конфигурация страницы 404, зависящая от хоста

Конфигурация страницы 404 зависит от того, где хранится страница, и типа используемого хостинга. Давайте рассмотрим конфигурацию для каждого типа по очереди:

Серверы Apache (синхронизация через FTP, FTPS, SFTP)

Для большинства стандартных серверов в файл .htaccess следует добавить следующую строку:

ErrorDocument 404 /404.html

404.html Часть этой строки может отличаться в зависимости от имени страницы, заданного в разделе средства визуализации файла конфигурации, упомянутого ранее.

Если файлы вашего веб-сайта расположены где-то еще, кроме основной папки вашего FTP, вам нужно будет изменить путь к файлу 404.html, чтобы указать на папку веб-сайта, например:

ErrorDocument 404 /name/folder/404.html

Для редактирования файла .htaccess мы можем использовать редактор .htaccess, встроенный в Publii; после открытия Publii щелкните раздел "Инструменты" в левом меню, затем выберите опцию ".htaccess Editor", чтобы открыть редактор.

Примечание: Если у вас уже был файл .htaccess на вашем сервере до синхронизации с ним Publii, то существующий файл будет заменен новым, сгенерированным Publii.

Страницы Github, Netlify, Google Cloud

Эти хосты обычно не нуждаются в дополнительной настройке; достаточно просто иметь файл 404.html. Страница 404 будет отображаться в том случае, если других файлов нет.

Единственное, о чем следует позаботиться, это убедиться, что имя файла 404 в конфигурации темы оставлено по умолчанию 404.html.

Amazon S3

При активации сервиса размещения страниц в конфигурации Amazon S3 вам необходимо будет определить правило перенаправления на случай возникновения ошибки 404: