Как сделать якорь в confluence

Добавил пользователь Валентин П.
Обновлено: 04.10.2024

Якорем называется закладка с уникальным именем на определённом месте веб-страницы, предназначенная для перехода к ней по ссылке. Якоря удобно применять в документах большого объёма, чтобы можно было быстро переходить к нужному разделу.

Пример 1. Создание якоря

При щелчке по такой ссылке произойдёт переход к элементу в окне браузера.

Ссылку также можно сделать на якорь на другой веб-странице и даже на другом сайте. Для этого в атрибуте href элемента надо указать полный адрес документа и в конце добавить символ решётки и имя якоря (пример 2).

Давайте более детально рассмотрим якоря HTML и особенности их использования.

Навигация по статье:

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

Как поставить якорь в HTML?

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

Или же просто ставят пустой HTML тег без содержимого.

В большинстве случаев в современной вёрстке используют задание якоря в HTML при помощи атрибута ID, однако есть движки или отдельные модули, для работы которых принципиально важно чтобы он был задан через атрибут name.

Как вставит якорную ссылку?

После этих нехитрых махинаций с HTML кодом при клике на созданной вами ссылке страница должна прокручиваться к тому блоку, которому присвоен атрибут ID или name, указанный в ссылке.

Как вставит якорную ссылку с переходом на другую страницу?

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

В этом есть несколько недостатков:

Я предполагаю URL-адрес, который включает в себя логику кода, где я не хочу этого URL-адрес, который я угадываю, может измениться при активации аддона, такого как Scroll Viewport Возможно, система не может различать гиперссылку (страница-внешняя) и перекрестная ссылка (страница-страница), например. для обнаружения неопределенных или осиротевших страниц.

Я ищу способ создания правильной перекрестной ссылки с одной страницы на другую при создании/обновлении этих страниц через REST. Я пробовал:

Регулярная гиперссылка HTML на URL-адрес страницы, который я предполагаю, не желаемый по причинам, описанным выше. Используя синтаксис "[link text | link + target]", это просто отображает квадратные скобки на странице и не создает ссылку Поиск макроса для использования, но, похоже, для этого нет макроса. Макрос Якоря не то, что я ищу, поскольку это будет работать только для целей ссылки на одной странице.

Я думаю, что смогу разрешить все необходимые идентификаторы страницы. Кроме того, макросы, похоже, поддерживаются REST, поэтому макрос для перекрестных ссылок кажется идеальным.

Якорь в HTML – это закладка на поле веб-страницы. Вся эта статья сделана закладками-якорями. Кликая по ссылкам в этой статье и перемещаясь по закладкам на этой странице можно легко понять, что такое якоря, зачем они нужны и как они работают.

Пример использования якоря в HTML

Пример практического использования якорей в HTML – настоящая статья с меню-оглавлением. В этом случае, в ключевые разделы и заголовки текста статьи были установлены якоря, а пункты меню оглавления – выступают ссылками на них. Кликая по ссылкам в меню оглавления статьи, пользователь перемещается в нужные места и разделы в теле самой статьи.

Действие якоря

Показания к применению якоря

Как создать и установить якорь на веб-странице

Чтобы создать и установить якорь на веб-странице,
нужно вставить код якоря в код html-документа и
присвоить якорю уникальное имя в пределах его страницы.

Имя якоря

Имя якоря – это его условный идентификатор, по которому браузер находит якорь на странице. Имя якоря может быть любым. Желательно, оно должно соответствовать тематике страницы и содержать, минимум три символа. Имя якоря может содержать цифры и латинские буквы в любой комбинации. Выбор имени для якоря ничем не ограничивается, кроме одного – оно должно быть уникальным в пределах страницы своего месторасположения.

На одной странице (по одному веб-адресу) не может быть двух якорей с одинаковым именем. Если на одной странице будут находиться якоря с одинаковым именем, то они – либо совсем не будут работать, либо будет открываться только первый из них (это зависит от браузера пользователя).

Но! Якоря с одинаковым именем, расположенные на разных веб-страницах (по разным веб-адресам) – будут прекрасно работать. Например, у меня на всех страницах блога стоит якорь "zaglavie" и отлично работает на каждой странице.

Общий вид кода якоря

Общий вид современного кода якоря в HTML представляет собой конструкцию из любого открывающего тега HTML и его атрибута, задающего уникальное имя (идентификатор) для якоря.

Код классического якоря (тег )

Код правильного якоря

И тут возникает вопрос в правильности выбора атрибута.
Какой из них правильней будет использовать – name или id .
Если работают-то оба .

Относительно выбора атрибута name или id, то по отношению тега – прекрасно работают оба варианта, поскольку тег отлично поддерживает оба из них. Лично я, долгое время использовал конструкцию вида

, которую вручную вставлял в HTML-код текста непосредственно перед заголовком (тегом ). При этом, якорь красиво открывал страницу сайта в месте его установки, с небольшим пробелом вверху экрана.

Через некоторое время, после очередного обновления своего HTML-редактора, я заметил, что он автоматически заменяет name на id, и везде ставит якоря, вида

Таким образом получается что, с точки зрения классики веб-языков и истории создания кода якорей, то – более правильным будет атрибут name. Ну, а с точки зрения удобства, универсальности и прогресса, то, естественно – код правильного якоря должен быть написан через атрибут id и иметь вид:

Код самого простого якоря

Но, два раза правильно – так не бывает! Где же истина?
И, как будет более правильно, или ?

Якорь в заголовке, в списке, в таблице.
Якорь в любом открывающем теге элемента HTML.

Таким образом, учитывая что код самого простого якоря имеет вид id="razdel", то код требуемого элемента разметки HTML, с установленным в него якорем, будет выглядеть, примерно так:

для заголовка (h1, h2, h3, h4, h5, h6)

и всё это будут – якоря в открывающих тегах элементов HTML.
(закрывающие теги для элементов, естественно – обязательно)

Прошу прощения за столь вольное обращение с написанием тегов, но я всего лишь хотел подчеркнуть собственное бессилие перед созиданием и проверкой семи десятков почти одинаковых примеров. И так понятно, что код якоря вида id="razdel" можно вставить, практически в любой открывающий тег HTML. И такой якорь должен работать. Для примера, вся эта статья сделана именно такими якорями.

Ссылка на якорь

Все ссылки на якоря можно условно разделить на три группы:

1 группа – Локальные ссылки на якорь,
расположенный в пределах одной страницы Код ссылки на якорь, расположенный в пределах одной и той же страницы, будет выглядеть так: ТЕКСТ ССЫЛКИ где, razdel – это уникальное имя якоря в пределах документа html, а ТЕКСТ ССЫЛКИ – это видимая текстовая часть (анкор) ссылки.

Абсолютная ссылка на якорь

Ссылка с указанием полного пути называется абсолютной ссылкой.
Абсолютные ссылки можно использовать для любых якорей, даже находящихся на одной и той же странице. Абсолютные ссылки наиболее предпочтительны для SEO-оптимизации страницы и сайта, ибо, зачастую – якоря, на которые сделаны абсолютные ссылки – могут быть засчитаны поисковиком за абсолютно разные веб-адреса и тексты. И, даже – якоря, на которые сделаны абсолютные ссылки – могут предлагаться отдельными позициями при выдаче в СЕРП (страницу поисковой выдачи). По крайней мере, у Google такое иногда наблюдается.

Недостаток работы абсолютной ссылки на якорь – полная перезагрузка страницы из сервера. Т.е. переход на якорь происходит с полной перезагрузкой страницы в браузер, даже если якорь и ссылка на него находятся на одной странице. Полная перезагрузка страницы занимает дополнительное время, создаёт дополнительную нагрузку на сетевое подключение, дополнительно жрёт трафик пользователя и самое главное – не работает без подключённого Интернета (в локальном или автономном режиме).

Читайте также: