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

Метки и теги

Чтобы облегчить поиск и систематизировать материал по определенной теме, рекомендуентся использовать единые метки (теги) в JIRA и Confluence.

Confluence метки

Добавление метки (labels) в Confluence

Метки в Confluence можно добавить к любой статье даже не открывая редактор:

Добавление меток происходит через пробел. Введите метки и нажмите кнопку Добавить:

Если статья открыта для редактирования, то для добавления меток необходимо нажать на иконку над названием статьи:

Макрос для вывода связанных по одной метке статей в Confluence

Чтобы вывести статьи с определенной меткой, добавьте макрос Содержимое по меткам.

В настройках макроса укажите метки, по которым выводить статьи:

Метки в JIRA

Добавление метки в задаче

Добавить метки в JIRA можно так же двумя способами:

в уже созданной задаче:

Вывод задач по Метке из JIRA в Confluence странице

Чтобы вывести задачи JIRA с определенной меткой, необходимо добавить макрос Jira:

В настройках макроса нужно ввести labels= и в кавычках указать метку для вывода.

Ссылки на конкретную часть статьи (якорь в статье)

Если вам нужно сослаться на конкретную часть статьи, вам на помощь придет макрос Анкер (Якорь). В этой статье будет рассмотрено, как разместить макрос и сделать ссылку.

Макрос Анкер (Якорь) добавляется так же, как остальные макросы — через меню вставки.

Добавляем название якоря.

Название составляется из букв латинского алфавита или цифр.

Вот так будет выглядеть якорь в редакторе статьи:

Чтобы потом сделать ссылку на этот якорь, нужно нажать на кнопку Вставить ссылку.

Выберите пункт Дополнительно и действуйте одним из следующих способов:

чтобы сделать ссылку на якорь в той же статье — в поле Ссылка добавьте название якоря через #. Например , #AnchorName;
чтобы сделать ссылку на якорь в другой статье — в поле Ссылка укажите название статьи, а потом к нему добавьте имя якоря через #. Например, Для новичков#endofarticle.
чтобы сделать ссылку на якорь в другой статье, которая находится в ином пространстве — в поле Ссылка укажите ключ пространства, поставьте двоеточие, укажите название статьи и через # имя якоря. Например, SPASE_KEY: 2017 релизы сайта Example.exp#listofrelease.

Если вы разместите в начале статьи макрос Оглавление и откроете статью, вы сможете скопировать ссылку на конкретный пункт статьи.

Например, статья Как делать скриншоты в Monosnap нажмите правой кнопкой мыши на пункте оглавления и в выпадающем меню выберите Копировать адрес ссылки.

Ссылки в Confluence. Mazafaka

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/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+proces s ‘

Если изменить заголовок страницы на “Англ Action Verbs to be used in Goal setting process” (добавить неанглоалфавитный символ, или двоеточия, или что-то еще неординарное), URL страницы поменяется на что-то вроде ‘ httр://confluence.test/pages/viewpage.action?pageId=54598262 ‘

Всё потому, что URL страниц в Confluence создается динамически, изменяясь “на лету” в зависимости от названия страницы.

А ссылки на страницы в Confluence существуют в системе как самостоятельные сущности (переменные). Поэтому привязываться надо не к ссылкам, а к сущностям, которые хранят в себе ссылки. Поэтому

Вставляем грамотно

Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).
В окне настроек выбрать Search > искать по названию страницы.

Будет мелкий неудобняк:

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

Поэтому более точный и удобный способ: в окне настроек макроса ‘Insert Link’ открыть раздел ‘Recently viewed‘. Нужная страница там безусловно найдется, практически всегда окажется, что я её уже открывал. Клик по её ‘Title’, и всё готово.

Confluence Recently Viewed

Теперь название страницы, на которую поставлена ссылка, может изменяться как угодно, вплоть до появления ‘ pageId=54598262 ‘ — ссылка всё равно сохраняется “живой и невредимой”.

Как быстро вставить ссылку, не подергивая свою мышь:

В открытой на редактирование странице нажать на клавиатуре клавишу ‘ [ ‘ — появится окно ‘Link suggestions’, аналог ‘Recently viewed’.

Ссылки на имена юзеров вызываются через ‘ @ ‘.

Вставлять картинки: через ‘ ! ‘.

Можно внутри страницы организовать огневые перекрестные внутренние ссылки, что дичайше котируется в больших документах вроде ‘QA Vocabulary’ (например, в нашем 226 терминов, ой-вэй).

Ссылки на разделы внутри страницы

Confluence Heading

Confluence Advanced Links

Итоговая ссылка на заголовок ‘ Definitions of Selected Functional Verbs ‘ будет выглядеть так: httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process#ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs

Мелкий неудобняк: ничто не подсказывает, что надо вставить ‘ # ‘. GTFO, если не знаешь про этот хинт. Я про него знаю, и вроде не дурак, но иногда забываю вписать эту чертову решеточку…

Серьезный, раздражающий неудобняк: если заголовок раздела ‘ Definitions of Selected Functional Verbs ‘ когда-нибудь изменится хоть на одну букву, ссылка внешне останется активной, но превратится в ссылку, просто закрытую заглушкой ‘#’.

Ок, это был простейший сценарий, ссылки внутри страницы. Теперь дело посложнее:

Поставить ссылку на заголовок с другой страницы, которая находится в другом space

Учли, что прямой Copy/Paste возможен, но потенциально недолговечен, и надо действовать через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).

И пусть там можно найти только общий Title нужной страницы, внутренние ссылки оттуда недоступны, однако действовать надо именно через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K). Если в будущем изменится название страницы, в которой находится заголовок, на который надо ссылаться, Confluence эту ссылку грамотно обновит. Confluence рулит!

Вот если внтури страницы изменится тот самый внутренний заголовок, на который сделана “ссылка внутри страницы”, тогда уж увы.

И всё равно придется действовать через раздел Advanced, да еще и вручную вписывать название страницы.

А это уже раздражающий неудобняк.

Если страница с внутренней ссылкой, на которую надо сослаться, находится в том же space:

Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K) > Advanced
Вставить ссылку по шаблону ‘ Page Name#MyHeading ‘.
В моем случае это ‘ Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘
Insert.

Если страница с внутренней ссылкой, на которую надо сослаться, находится в другом space:

Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K) > Advanced
Вставить ссылку по шаблону ‘ spacekey:Page Name#MyHeading ‘.
В моем случае это ‘ ~a.lupan:Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘
Insert.

ВНЕЗАПНОСТИ

Полностью URL на определенный заголовок внутри определенной страницы выглядит так: httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process#ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs

Что же это за #ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs , если я вписывал только #DefinitionsofSelectedFunctionalVerbs ? Что за Wtf?

Ответ такой: все в порядке.

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.

Ок, учтем, что в виде ссылки надо использовать только то, что идет за решеткой, но только после дефиса.

Неочевиднейший подход. Пока это поймешь…

Если продолжить редактировать страницу, отсылка продолжает оставаться рабочей.

Но если я решу отредактировать эту ссылку… в ней исчезает spacekey, и вместо

‘ ~a.lupan:Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘

там будет написано

‘ Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs ‘.

Всё, ссылка сдохла.

Не обратишь на это пристальное внимание — увы , блеать…

Confluence Space Key Disappear

Confluence Help организован не по-взрослому.

Но также зачем-то существуют отдельные страницы справка для разных версий 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

В целом Confluence рулит неимоверно!

Просто надо немного оторвать ноги/руки тем, кто реализовал механизм работы с ссылками, и мир во всем моем мире наступит.

Послать ссылку другу по электронной почте (Открывается в новом окне)
Нажмите, чтобы поделиться на Twitter (Открывается в новом окне)
Нажмите, чтобы поделиться в Mastodon (Открывается в новом окне)
Нажмите, чтобы поделиться в Telegram (Открывается в новом окне)
Нажмите, чтобы поделиться на LinkedIn (Открывается в новом окне)
Нажмите, чтобы открыть на Facebook (Открывается в новом окне)

Вставить/Редактировать якорь #2411

С помощью так называемых «якорей» Вы можете вставлять невидимые ссылки с уникальными названиями в текст внутри страницы.

Например, если текст страницы очень объемный и состоит из нескольких подразделов, заголовок каждого из подразделов можно оформить в виде «якоря», задав каждому из «якорей» уникальные названия. Скажем, на странице «http://example/about» три раздела, каждый из них выделен в виде «якоря» с названиями «razdel-1», «razdel-2» и «rasdel-3», соответственно, чтобы пройти к любому из разделов, достаточно к адресу страницы дописать имя «якоря» через решетку — «http://example/about#razdel-3» — страница откроется именно в области третьего заголовка. При необходимости Вы можете сделать в начале документа оглавление, оформив ссылки на «якоря» в виде пунктов списка.

Рассмотрим, как можно вставить якорь в текст.

Шаг 1

Поместите курсор в то место, где Вы хотите разместить «якорь» или выделите текст, который хотите использовать в качестве «якоря» и нажмите на кнопку вставки якоря.

php7qIDOO

Шаг 2

Откроется окно вставки «якоря». Укажите название (оно будет использоваться в ссылке на «якорь») и нажмите «Вставить «.

phpix9Sus

Обратите внимание!

Имя якоря может содержать только латинские буквы и цифры, при этом, имя якоря должно начинаться с буквы

Шаг 3

Чтобы вставить в текст ссылку на якорь, например, в оглавлении — воспользуйтесь обычной вставкой ссылки.

На вкладке «Информация о ссылке»:

Выберите «Тип ссылки» — «Ссылка на якорь в тексте».
Появится дополнительный параметр «Выберите якорь», где Вы сможете в списке «По имени» выбрать ранее созданный Вами якорь.

php7z5uGe

Шаг 4

После внесения изменений нажмите «Ок».

Мы создаём веб-сайты для России и зарубежных рынков с 1997 года. Наша команда – более пятисот сотрудников в разных странах и городах.

Понимание потребностей онлайн-бизнеса, опыт взаимодействия с тысячами клиентов, высокая квалификация персонала, собственные «ноу-хау» и хороший объём заказов позволяют веб-студии Мегагрупп.ру предлагать услуги высокого качества по удивительно низким и «вкусным» ценам.

Этот сайт был создан на платформе
CMS S3 от Megagroup.ru

Данный сайт защищен с помощью reCAPTCHA и соответствует
Политике конфиденциальности и Условиям использования Google.