Как вставить ссылку в конфлюенсе
Как работать с вложениями в Confluence
Не знаете куда правильнее выложить файл? Читайте об этом здесь.
Добавили вложение, а теперь нужно удалить? Об этом здесь.
К каждой странице в Confluence можно добавить вложения. Для загрузки вложения нажмите Вставить файлы и изображения. Опция доступна на панели инструментов или через инструмент Добавить прочий контент.
В окне Вставить файлы и изображения нажмите кнопку Загрузить файлы. Укажите путь к файлу на компьютере, нажмите Выбрать. Файл будет загружен в систему. Разрешается добавить сразу несколько файлов. Все загруженные файлы будут храниться и отображаться на подстранице Вложения.
Чтобы добавить вложение на страницу статьи, отметьте вложения и нажмите Вставить.
Вложение будет отображено на странице статьи.
Вложения могут быть отображены как ссылки или как мини-картинка файла.
Для выбора типа отображения кликните по вложению, отобразится инструмент настройки. Нажмите Показать как ссылку. Вложение отобразится как ссылка.
Страницы, которые содержат вложения, имеют кнопку Вложения.
При переходе к вложениям отображается подстраница с таблицей вложений. В таблице вложений отображены все ранее загруженные файлы, создатель, размер, дата создания, комментарий и кнопки Действия.
Confluence поддерживает версионность вложений. По умолчанию на странице статьи всегда будет отображена и открываться текущая (последнее по времени загруженное вложение) версия.
Важно! Для версионности необходимо, чтобы документ имел всегда одно наименование.
Для работы с вложениями в Confluence предусмотрены макросы.
Макрос Вложения позволяет отобразить вложения в табличном виде, а также установить инструмент для загрузки файлов без входа в Редактирование.
Для добавления макроса нажмите Вставить прочий контент – Другие макросы – Вложения.
В окне настройки макроса отображаются все имеющиеся вложения.
Окно страницы со всеми установленными чекбоксами:
Добавление файлов и ссылок
При публикации сообщений на форумах часто требуется добавить к сообщению файл (реферат, доклад, картинку, скриншот и т.п.), добавить ссылку на файл или ссылку на сайт в сети Интернет. В этом разделе рассказано, как правильно это сделать:
Прикрепление файла к сообщению
В текущей версии СДО сообщение на форуме можно редактировать в течение 5 минут после публикации.
Вставка в сообщение ссылки на файл или на сайт
Вставка в сообщение иллюстрации
Вложенные файлы сообщений
У каждого сообщения на форумах есть область вложенных файлов, которую можно открыть из меню редактора сообщения:
В эту область автоматически сохраняются все файлы, которые прикрепляются к сообщению.
Если в сообщении требуется добавить сразу несколько файлов, то удобнее вначале загрузить их в область вложенных файлов:
А затем использовать в тексте сообщения, выбирая их в окне выбора файлов из раздела «Вложенные файлы»:
Если Вы загрузили файл в сообщение, но затем решили его не использовать, то этот файл будет отображаться в области вложенных файлов, как неиспользуемый:
Пожалуйста, удаляйте неиспользуемые файлы, чтобы они не занимали место на сервере.
Это нормально!
The programmer’s worst friend
Ссылки в 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/
Если изменить заголовок страницы на «Англ 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 терминов, ой-вэй).
Ссылки на разделы внутри страницы
» data-medium-file=»https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=300″ data-large-file=»https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=500″ src=»https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=500&h=462″ alt=»Confluence Heading» width=»500″ height=»462″ srcset=»https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=500&h=462 500w, https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=150&h=139 150w, https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg?w=300&h=277 300w, https://testitquickly.files.wordpress.com/2015/11/confluenceheading.jpg 676w» sizes=»(max-width: 500px) 100vw, 500px» />
Confluence Advanced Links
» data-medium-file=»https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=300″ data-large-file=»https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=500″ src=»https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=500&h=353″ alt=»Confluence Advanced Links» width=»500″ height=»353″ srcset=»https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=500&h=353 500w, https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=1000&h=706 1000w, https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=150&h=106 150w, https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=300&h=212 300w, https://testitquickly.files.wordpress.com/2015/11/confluenceadvancedlinks.jpg?w=768&h=542 768w» sizes=»(max-width: 500px) 100vw, 500px» />
Confluence Advanced Links
// Внимание : 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 Space Key Disappear
» data-medium-file=»https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=300″ data-large-file=»https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=500″ src=»https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=500&h=352″ alt=»Confluence Space Key Disappear» width=»500″ height=»352″ srcset=»https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=500&h=352 500w, https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=1000&h=704 1000w, https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=150&h=106 150w, https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=300&h=211 300w, https://testitquickly.files.wordpress.com/2015/11/confluencespacekeydisappear.jpg?w=768&h=541 768w» sizes=»(max-width: 500px) 100vw, 500px» />
Confluence Space Key Disappear
3)
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
» 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 рулит неимоверно!
Просто надо немного оторвать ноги/руки тем, кто реализовал механизм работы с ссылками, и мир во всем моем мире наступит.
Добавление ссылки на локальный файл в Confluence
Я хотел бы добавить ссылку на локальный файл в слиянии. Очевидно, что эта ссылка будет работать только в том случае, если файл локально находится на компьютере пользователя. Я это понимаю.
Если я добавлю адрес следующим образом:
Браузер отправляет меня в:
Если я попытаюсь добавить его с такими кавычками:
Как это возможно в слиянии?
Как вы упомянули при добавлении веб-ссылки в Confluence, указывающей файл с использованием файлового протокола (file:///), вы можете столкнуться с проблемой, что она не работает.
Очевидно, что эта ссылка будет работать только в том случае, если файл локально находится на компьютере пользователя.
Это не совсем правда. Если вы откроете инструменты для разработчиков, скорее всего, вы получите сообщение об ошибке » Не разрешено загружать локальный ресурс «,
В качестве меры безопасности браузер не позволит вам получать доступ к файлам из другого источника, особенно с компьютера пользователей (это будет серьезным риском для безопасности). Только представьте, можете ли вы получить доступ к файлам в каталоге Windows из браузера, вы можете мгновенно разбить операционную систему (или украсть пользовательские данные).
Если вы поместите файл в тот же сервер, что и Confluence, он должен работать нормально. Однако я считаю, что вы можете сэкономить время, просто добавив страницу в качестве вложения и загрузив ее (Confluence довольно приличный при управлении версиями, если вы хотите изменить html файл).
Ссылки на конкретную часть статьи (якорь в статье)
Если вам нужно сослаться на конкретную часть статьи, вам на помощь придет макрос Анкер (Якорь). В этой статье будет рассмотрено, как разместить макрос и сделать ссылку.
Макрос Анкер (Якорь) добавляется так же, как остальные макросы — через меню вставки.
Добавляем название якоря.
Название составляется из букв латинского алфавита или цифр.
Вот так будет выглядеть якорь в редакторе статьи:
Чтобы потом сделать ссылку на этот якорь, нужно нажать на кнопку Вставить ссылку.
Выберите пункт Дополнительно и действуйте одним из следующих способов:
Если вы разместите в начале статьи макрос Оглавление и откроете статью, вы сможете скопировать ссылку на конкретный пункт статьи.
Например, статья Как делать скриншоты в Monosnap нажмите правой кнопкой мыши на пункте оглавления и в выпадающем меню выберите Копировать адрес ссылки.