Отсутствующие якоря

Проверьте фрагмент#

Часть после # называется фрагментом, например #installation в /docs/setup#installation. Для обычной ссылки на раздел она должна совпадать с ID элемента на целевой странице. Страница может вернуть HTTP 200, даже если якорь отсутствует.

Откройте полный URL, дождитесь загрузки целевой страницы и проверьте, происходит ли переход к нужному разделу. Сравните фрагмент с фактическим ID, а не с видимым заголовком. Регистр и закодированные символы могут иметь значение.

1. Прочитайте полный URL, включая #fragment.
2. Откройте его во вкладке браузера.
3. Найдите заголовок или элемент, на который обещает перейти ссылка.
4. Проверьте его ID в редакторе или инструментах разработчика браузера.
5. Сравните этот ID с фрагментом.

Исправление#

Если у раздела есть стабильный ID, измените исходную ссылку так, чтобы она ему соответствовала. Если другие статьи всё ещё используют старый фрагмент, рассмотрите возможность сохранить этот ID в нужном месте, чтобы не нарушать работу существующих ссылок.

Опубликуйте изменение и проверьте полную ссылку со страницы-источника. Удаление фрагмента позволяет открыть страницу, но не сохраняет обещание перейти непосредственно к нужному разделу.

Динамическое содержимое#

Некоторые сайты создают ID после выполнения JavaScript или раскрытия содержимого пользователем. Проверка всего сайта изучает полученный HTML, который может отличаться от отображаемой страницы. Сканирование текущей страницы может проверить ID, уже доступные в активной вкладке.

Прежде чем менять работающую ссылку, загрузите соответствующее содержимое и проверьте её в новой вкладке. Если ссылка работает только после определённого действия, убедитесь, что новые посетители могут выполнить это действие и что на странице-источнике не нужны более понятные инструкции.

Отличайте ссылки-заглушки от ссылок на разделы#

Пустая ссылка, одиночный # или адрес javascript: могут быть заглушкой интерфейса, а не отсутствующим разделом. Включите параметр «Проверять ссылки-заглушки» в настройках, чтобы вывести их отдельно.

Для навигации используйте содержательный адрес назначения или фрагмент. Для действия интерфейса изучите предполагаемое поведение, прежде чем считать элемент управления ссылкой на отсутствующую HTTP-страницу.

Проверьте связанные ссылки#

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

После публикации выполните ещё одну проверку. Существующий отчёт остаётся снимком результатов; повторное открытие не подтверждает, что якорь теперь существует.