Ссылки на конкретную часть статьи (якорь в статье)
Если вам нужно сослаться на конкретную часть статьи, вам на помощь придет макрос Анкер (Якорь). В этой статье будет рассмотрено, как разместить макрос и сделать ссылку.
Макрос Анкер (Якорь) добавляется так же, как остальные макросы — через меню вставки.
Добавляем название якоря.
Название составляется из букв латинского алфавита или цифр.
Вот так будет выглядеть якорь в редакторе статьи:
Чтобы потом сделать ссылку на этот якорь, нужно нажать на кнопку Вставить ссылку.
Выберите пункт Дополнительно и действуйте одним из следующих способов:
Если вы разместите в начале статьи макрос Оглавление и откроете статью, вы сможете скопировать ссылку на конкретный пункт статьи.
Например, статья Как делать скриншоты в Monosnap нажмите правой кнопкой мыши на пункте оглавления и в выпадающем меню выберите Копировать адрес ссылки.
You can use anchors to enable linking to specific locations on a page, and they can be especially useful for allowing your readers to navigate to specific parts of a long document. Anchors are invisible to the reader when the page is displayed.
There are two steps to using an anchor:
Step 1: Create the anchor
Add the Anchor Macro to mark the location you want to link to:
On this page:
Related pages:
Macro options (parameters)
Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets ( example ).
Anchor Name
This is the anchor name that you will use when creating the link.
Step 2: Create a link to the anchor
Link to an anchor on the same Confluence site:
Choose Advanced and enter the anchor name in the Link field, following the format below.
Anchor location
Link syntax for anchor
Examples
Same page
#anchor name
My page#important information
DOC:My page#important information
Screenshot: The ‘Advanced’ option in the link dialog
Link to an anchor from another web page or another Confluence site:
Add the Anchor macro to a page to link to a specific part of a page.
This is useful on long pages, where you want to link to specific parts of the page.
Don’t see the Anchor macro? This macro isn’t available in the new Confluence Cloud editor. See We’re cleaning up our macros for alternative ways to link.
The example below shows an example of an Anchor macro as it appears in the editor, and as it would appear to someone viewing the page.
On this page:
Add the anchor macro to your page
To add the Anchor macro to a page:
You can then add a link to your macro from this page or another page.
Linking to an anchor
To link to an anchor on the same page:
You can also link to an anchor on another page. See Anchors for more information on the different link syntax you can use.
Animation: Adding the Anchor macro to a page, then linking to that macro.
Change the macro parameters
Macro parameters are used to change the behaviour of a macro.
To change the macro parameters:
Here’s a list of the parameters available in this macro.
Anchor Name
This is the anchor name that you will use when creating the link.
Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets ( example ).
Other ways to add this macro
Add this macro as you type
Add this macro using wiki markup
This is useful when you want to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.
Давайте более детально рассмотрим якоря HTML и особенности их использования.
Навигация по статье:
Якоря HTML представляют собой ссылки на определённые блоки на странице. Они очень часто применяются на страницах с большим количеством текста для более удобной навигации. Якорные ссылки HTML чаще всего применяют для создания меню на лендингах, а так же для навигации по статье.
Как поставить якорь в HTML?
Или же просто ставят пустой HTML тег без содержимого.
Как вставит якорную ссылку?
Для этого пишем код обычной ссылки и в атрибуте href ставим сначала символ #, а затем пишем названия якоря, который мы задали ранее.
После этих нехитрых махинаций с HTML кодом при клике на созданной вами ссылке страница должна прокручиваться к тому блоку, которому присвоен атрибут ID или name, указанный в ссылке.
Как вставит якорную ссылку с переходом на другую страницу?
При использовании якорей HTML для создания навигации часто возникает ситуация, когда вам нужно настроить переход к якорю, который находится на другой странице. К счастью, такое тоже возможно!
Для этого нам нужно всего лишь в атрибуте ссылки href указать сначала название страницы, на которую нужно перейти, потом поставить знак # и указать название нужного якоря.
Особенности использования якорей HTML
Поэтому если вы решите воспользоваться кнопкой «Назад» для возврата на предыдущую страницу, то вас перекинет сначала на эту же страницу, и только после повторного нажатия «Назад» вы вернётесь на предыдущую страницу.
Confluence 5.5.2 — прекрасная SaaS-система, пользуюсь ежедневно. Полностью интегрируется с Jira, все дела.
В Confluence можно грамотно разметить оглавления в тексте, заголовками уровня 1-6.
Можно вставить автоматически собираемое «Содержание» всех заголовков на странице (макрос ‘Table of Contents’).
Можно вставлять в тело страницы другую страницу, целиком (макрос ‘Include Page’).
Даже можно сделать на странице, содержимое которой надо встроить, специальное выделение текста (макрос ‘Excerpt’), и вставлять ТОЛЬКО то содержимое, которое было помеченное таким хитрым образом (макрос ‘Excerpt Include’).
Можно вставлять ссылки на другие страницы внутри Confluence аж двумя способами: по-простому (по-дурацки) и грамотно.
Вставляем по-дурацки
Буквально copy/paste ‘ httр://confluence.test/display/
a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process ‘ в тело открытой на редактирование страницы.
Но вероятно не будет работать в будущем, если в названии страницы изменится хотя бы один символ — ссылка просто «умрёт».
Например, если в названии только дружественные англо-символы (вроде «Action Verbs to be used in Goal setting process«), URL страницы будет выглядеть как ‘ httр://confluence.test/display/
Если изменить заголовок страницы на «Англ Action Verbs to be used in Goal setting process» (добавить неанглоалфавитный символ, или двоеточия, или что-то еще неординарное), URL страницы поменяется на что-то вроде ‘ httр://confluence.test/pages/viewpage.action?pageId=54598262 ‘
Всё потому, что URL страниц в Confluence создается динамически, изменяясь «на лету» в зависимости от названия страницы.
А ссылки на страницы в Confluence существуют в системе как самостоятельные сущности (переменные). Поэтому привязываться надо не к ссылкам, а к сущностям, которые хранят в себе ссылки. Поэтому
Вставляем грамотно
Будет мелкий неудобняк:
Поэтому более точный и удобный способ: в окне настроек макроса ‘Insert Link’ открыть раздел ‘Recently viewed‘. Нужная страница там безусловно найдется, практически всегда окажется, что я её уже открывал. Клик по её ‘Title’, и всё готово.
Confluence Recently Viewed
Теперь название страницы, на которую поставлена ссылка, может изменяться как угодно, вплоть до появления ‘ pageId=54598262 ‘ — ссылка всё равно сохраняется «живой и невредимой».
Как быстро вставить ссылку, не подергивая свою мышь:
Ссылки на имена юзеров вызываются через ‘ @ ‘.
Можно внутри страницы организовать огневые перекрестные внутренние ссылки, что дичайше котируется в больших документах вроде ‘QA Vocabulary’ (например, в нашем 226 терминов, ой-вэй).
// Внимание : The anchor name is case sensitive. You must use the same pattern of upper and lower case letters as you used when creating the Anchor.
// После обработки текст превратится в #DefinitionsofSelectedFunctionalVerbs (ибо справка: The anchor name in the full URL is concatenated into a single word, with all spaces removed).
Итоговая ссылка на заголовок ‘ Definitions of Selected Functional Verbs ‘ будет выглядеть так: httр://confluence.test/display/
Мелкий неудобняк: ничто не подсказывает, что надо вставить ‘ # ‘. GTFO, если не знаешь про этот хинт. Я про него знаю, и вроде не дурак, но иногда забываю вписать эту чертову решеточку…
Серьезный, раздражающий неудобняк: если заголовок раздела ‘ Definitions of Selected Functional Verbs ‘ когда-нибудь изменится хоть на одну букву, ссылка внешне останется активной, но превратится в ссылку, просто закрытую заглушкой ‘#’.
Ок, это был простейший сценарий, ссылки внутри страницы. Теперь дело посложнее:
Поставить ссылку на заголовок с другой страницы, которая находится в другом space
Учли, что прямой Copy/Paste возможен, но потенциально недолговечен, и надо действовать через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).
И пусть там можно найти только общий Title нужной страницы, внутренние ссылки оттуда недоступны, однако действовать надо именно через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K). Если в будущем изменится название страницы, в которой находится заголовок, на который надо ссылаться, Confluence эту ссылку грамотно обновит. Confluence рулит!
Вот если внтури страницы изменится тот самый внутренний заголовок, на который сделана «ссылка внутри страницы», тогда уж увы.
И всё равно придется действовать через раздел Advanced, да еще и вручную вписывать название страницы.
А это уже раздражающий неудобняк.
Если страница с внутренней ссылкой, на которую надо сослаться, находится в том же space:
Если страница с внутренней ссылкой, на которую надо сослаться, находится в другом space:
ВНЕЗАПНОСТИ
1) Полностью URL на определенный заголовок внутри определенной страницы выглядит так: httр://confluence.test/display/
Ответ такой: все в порядке.
The page name is repeated in the URL, after the # sign. The second occurrence of the page name is concatenated into a single word, with all spaces removed.
Ок, учтем, что в виде ссылки надо использовать только то, что идет за решеткой, но только после дефиса.
Неочевиднейший подход. Пока это поймешь…
2) Если продолжить редактировать страницу, отсылка продолжает оставаться рабочей.
Но если я решу отредактировать эту ссылку… в ней исчезает spacekey, и вместо ‘
a.lupan:Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘
там будет написано ‘ Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘.
Но также зачем-то существуют отдельные страницы справка для разных версий Confluence. Например, справка для Confluenct версии 5.6 находится тут: https://confluence.atlassian.com/conf56/confluence-user-s-guide/creating-content/using-the-editor/working-with-links
Между всеми тремя версиями справки разницы НЕТ, количество слов в двух документах идентично. Wtf?
Confluence Help Links Word Count
» data-medium-file=»https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg?w=300″ data-large-file=»https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg?w=379″ src=»https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg?w=500″ alt=»Confluence Help Links Word Count» srcset=»https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg 379w, https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg?w=150 150w, https://testitquickly.files.wordpress.com/2015/11/confluence-help-links-word-count.jpg?w=300 300w» sizes=»(max-width: 379px) 100vw, 379px» />
Confluence Help Links Word Count
В целом Confluence рулит неимоверно!
Просто надо немного оторвать ноги/руки тем, кто реализовал механизм работы с ссылками, и мир во всем моем мире наступит.
