Наибольший заголовок
Текстовые эффекты используются для изменения форматирования слов и предложений.
*жирный*_выделенный_??цитирование??-удаленный-+вставленный+^верхний индекс^~нижний индекс~bq. Некоторый цитированный блок текстаЧтобы сделать весь параграф цитированным — поместите «bq. » перед ним.
Некоторый цитированный блок текста
Здесь находится подходящее
для цитирования содержание
Цитировать блок текста, длиннее одного абзаца.
Здесь находится подходящее
для цитирования содержание
Смотри, ма - красный текст!
Изменяет цвет блока текста.
Смотри, ма — красный текст!
Текстовые разрывы
В большинстве случаев, явные разрывы старниц не требуются — Вики-рендерер сможет сам правильно разбивать текст на страницы.
(чистая строка)Ссылки
Важно узнать, как быстро создавать ссылки.
[#anchor] [^attachment.ext] [http://jira.atlassian.com] [Atlassian|http://atlassian.com] Создает ссылку на внешний источник. Спецсимволы, которые следуют после URL и не являются его частью должны быть отделены пробелом. Внешние ссылки обозначены иконкой со стрелочкой.
Скобки [] вокруг внешних ссылок ставятся по усмотрению, если вы не хотите использовать никакие псевдонимы для ссылок.
[mailto:legendaryservice@atlassian.com]Создает ссылку на почтовый адрес.
[file:///c:/temp/foo.txt] [file:///z:/file/on/network/share.txt] Создает ссылку на скачивание файла на ваш компьютер или в сетевую папку, которую вы выбрали на диске. Чтобы получить доступ к файлу, надмите правую кнопку на ссылке и выберете «Сохранить Как».
По умолчанию, это работает только в Internet Explorer, но также может быть задействовано в Firefox (Смотрите документацию).
[~username]Списки
Списки позволяют вам представлять информацию в виде серии упорядоченных элементов.
* некоторые * булит ** с отступом ** буллиты * точки Список с буллитами (должен быть в первом столбце). Используйте больше (**) для увеличения глубины списка.
- другой - булит - типы Элементы списка (с -), несколько строк образуют единственный список.
# # нумерованный
# список Нумерованный список (должен быть в первом столбце). Используйте больше (##, ###) для увеличения глубины списка.
# # нумерованный #* с #* вложенные #* булит # список * * с буллитами *# с *# вложенные *# нумерованный * список Вы также можете создавать любые смешанные вложенные списки.
Изображения
Изображения можно вставлять в Вики-поле из вложенных файлов или удаленных источников.
!http://www.host.com/image.gif! или !attached-image.gif! Вставляет изображение на страницу.
Если подходящий URL указан для изображения — оно будет отображаться с удаленного источника, иначе будет отображаться приложенный файл с картинкой.
!image.jpg|thumbnail!Вставить миниатюру на станицу (работает только с изображениями, приложенными к странице).
!image.gif|align=right, vspace=4!Для любого изображения вы можете определить аттрибуты тэга изображения — такие, как список, разделенный запятыми и пр.
Вложения
Некоторые вложения особого типа могут быть вставлены в визуальное Вики-поле из приложенного файла.
!quicktime.mov! !spaceKey:pageTitle^attachment.mov! !quicktime.mov|width=300,height=400! !media.wmv|id=media! Вставка объекта на страницу, вставляя свойства разделенные запятыми.
Форматы, поддерживаемые по умолчанию.:
- Flash (.swf)
- Quicktime клипы (.mov)
- Windows Media (.wma, .wmv)
- Real Media (.rm, .ram)
- MP3 файлы (.mp3)
Прочие типы файлов могут быть использованы, но могут потребовать указание свойств «classid», «codebase» и «pluginspage», чтобы быть распознанными веб-браузерами.
- ширина — ширина медиа-файла
- высота — высота медиа-файла
- ID — ID присвоенный вставленному объекту
Благодаря запросам безопасности файлы, расположенные на удаленных серверах не поддерживают Стилизацию
По умолчанию, каждый вставляемый объект обернут тегом «div». Если вы хотите стилизировать div и его содержимое — перепишите содержимое CSS-класса «embeddedObject». Указание ID в качестве свойства также позволяет вам стилизировать разные вставленные объекты. Используются имена CSS-классов в формате «embeddedObject-ID».
Таблицы
Таблицы позволяют вам организовать содержимое в строки и столбцы с заголовочными строками, если требуется.
||заголовок 1||заголовок 2||заголовок 3|| |col A1|col A2|col A3| |col B1|col B2|col B3| Создает таблицу. Используйте double bars для заголовочных строк таблицы.
Код, заданный здесь, создает таблицу которая выглядит как:
| заголовок 1 | заголовок 2 | заголовок 3 |
|---|---|---|
| col A1 | col A2 | col A3 |
| col B1 | col B2 | col B3 |
Расширенное форматирование
Расширенное форматирование текста.
предварительно отформатированный кусок текста
таким образом, дальнейшее _форматирование_ здесь *не* производится
Делает предварительно отформатированный блок текста без синтаксической подсветки. Все опциональные параметры макроса также действительны для .
- без панели: Окружает блок текста полностью настраиваемой панелью. Опциональные параметры, которые вы можете задать:
предварительно отформатированный кусок текста таким образом, дальнейшее _форматирование_ здесь *не* производится
Некий текст
Некий текст с заголовком
блок текста, окруженный *панелью* еще _другая_ линия
- title: Заголовок панели
- borderStyle: Стиль границы, которая используется в панели (сплошная, пунктирная и любая другая CSS-valid)
- borderColor: Цвет границы, которая используется в панели
- borderWidth: ширина границы, которая используется в панели
- bgColor: Цвет фона этой панели
- titleBGColor: Цвет фона заглавной секции этой панели
Мой заголовок
блок текста, окруженный панелью
еще другая линия
Делает предварительно отформатированный блок текста синтаксически подсвеченным. Все опциональные параметры макроса также действительны для . Язык по умолчанию — Java, но вы такуже можете указать JavaScript, ActionScript, XML или SQL.
Bar.java
// Some comments here public String getFoo() { return foo; }
"attribute"/>
Разное
другие различные возможности синтаксической подсветки.
Графические эмотиконы (смайлы).
| Notation | :) | :( | :P | :D | ;) | (y) | (n) | (i) | (/) | (x) | (!) |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Image |
| Нотация | (+) | (-) | (?) | (on) | (off) | (*) | (*r) | (*g) | (*b) | (*y) |
|---|---|---|---|---|---|---|---|---|---|---|
| Изображение |
Таблица
-
Кликните по нужной области в статье, нажмите на
и выберите Таблица .
По умолчанию добавляется таблица из 3 столбцов и 3 строк.
Редактируем столбцы и строки
- Отредактируйте столбцы. Нажмите на три точки сверху от столбца. Измените заливку, добавьте столбцы слева или справа, переместите столбец влево или вправо, продублируйте или удалите.
Настройте стиль текста для всего столбца.
Если переместите столбец, то он перестанет быть закреплённым.
Используйте сочетания клавиш CTRL + C и CTRL + V , чтобы копировать и вставлять текст в ячейки таблицы, и клавишу Delete , чтобы полностью её удалить.
- Используйте стрелки на клавиатуре, а также клавиши Tab и Enter , чтобы перемещаться по таблице.
| Стрелки | Перемещение вправо, влево, вверх и вниз |
|---|---|
| Tab | Вправо и вниз |
| Shift-Tab | Влево и вверх |
| Enter | Вниз |
Как в конфлюенс закрепить верхнюю строку таблицы
Вопросы по покупке sales@onlyoffice.com
Запросы на партнерство partners@onlyoffice.com
Запросы от прессы press@onlyoffice.com
Следите за нашими новостями:
© Ascensio System SIA 2024. Все права защищены
© Ascensio System SIA 2024. Все права защищены
Не пропустите обновление!
Получайте последние новости ONLYOFFICE на ваш email
Имя не указано.
Email не указан.
На ваш адрес электронной почты отправлено сообщение с подтверждением.
В Справочном центре ONLYOFFICE используются файлы cookie для обеспечения максимального удобства работы пользователей. Продолжая использовать этот сайт, вы соглашаетесь с тем, что мы можем сохранять файлы cookie в вашем браузере.
Как использовать макросы в Confluence, чтобы систематизировать и оформить техническую документацию?
Частая проблема в работе с документацией заключается в том, что команды оформляют и хранят данные как хотят. В тексте рассказываем, как навести порядок и использовать 7 полезных макросов.
Меня зовут Таня Дудо, и я уже 6 лет помогаю людям и командам обмениваться знаниями внутри компаний. Для этого использую Confluence. Да-да, ту самую wiki-систему, которую часто называют неудобной и несовременной. Сегодня выступлю ее адвокатом-обозревателем: расскажу про 7 полезных макросов для систематизации и оформления контента и наглядно покажу, как они работают.
Дисклеймер: с марта Atlassian не продают лицензии в Россию напрямую. Но если у вас уже есть, никто не запрещает ей пользоваться. На сайте Atlassian есть развернутая документация по установке Confluence и Jira. Она охватывает практически все аспекты. Вот, например, одна из статей.
В чем проблема с Confluence или почему я решила написать этот текст
Часто вижу в разных компаниях, что документация в Confluence живет своей жизнью: команды оформляют и хранят данные как хотят, никто сильно не погружается в работу этой системы. Из-за этого она кажется неповоротливой, вызывает раздражение и жаркие споры о том, какой инструмент лучше подойдет для накопления и передачи знаний.
Не буду утверждать, что Confluence — самый лучший в мире инструмент для работы с документацией. Все-таки, это дело привычки, вкуса и корпоративных ограничений. Наоборот, в тексте сосредоточусь на прикладных знаниях о том, как ласково приручить этого непростого зверя и покажу, как документация может преобразиться с использованием конкретных макросов.
Рекомендую к прочтению тем, кто:
- недавно начал с ней работать,
- уже использует и ищет способы сделать работу с Confluence более комфортной.
Что такое макросы и зачем они нужны
Макросы — это программные алгоритмы действий, «упакованные» в понятный графический интерфейс. Если проще, это внутренние инструменты Confluence, которые помогают делать документацию понятнее и удобнее.
Чем макросы круче текстовых редакторов?
Базовая комплектация текстового редактора выполняет простые операции по редактированию. Например, там можно выделить текст жирным или курсивом, изменить цвет символов, выровнять столбцы по середине или по краю.
Макросы эти возможности расширяют: интегрируют контент из внешних источников, помогают настроить навигацию внутри большой базы знаний или сформировать единый тон визуального оформления документации.
В Confluence макросов много — больше 5 тысяч , но я сосредоточусь на трех группах. Это:
- форматирование контента,
- интеграция внутреннего контента,
- интеграция внешнего контента.
Их можно называть «группами быстрого улучшения» — они помогут сделать вашу доку читабельнее всего в пару кликов.
Где находятся макросы
Макросы можно добавить в статью в режиме редактирования. Они прячутся в верхней панели инструментов, за кнопкой с названием «Вставить прочий контент».
Самые популярные макросы — например, «Оглавление» и «Галерея» — лежат в выпадающем меню. Больше возможностей скрываются за строчкой «Другие макросы».
В библиотеке макросы рассортированы по группам. В левой части интерфейса можно сразу перейти к нужной группе.
Если подходящего макроса не нашлось, через кнопку «Найти еще макросы…» можно перейти в Atlassian Market и изучить платные и бесплатные дополнения, совместимые с вашей версией Confluence.
Макросы-блоки и макросы-рамки
Макрос может быть самодостаточным и не требовать вставки чего-то (например, текста, изображений или ссылок) внутри себя. В таком случае он выглядят как блок.
Если для работы макроса что-то нужно поместить внутрь, он выглядит как рамка.
Представьте: вам нужно спрятать под кат какой-то текст. Тогда можно использовать макрос «Раскрыть»: внутрь рамки помещаем текст, а после сохранения ок окажется внутри раскрывающегося меню.
Внутрь одного макроса-рамки можно помещать сколько угодно других макросов. Главное, чтобы в пирамиде была логика. Так, например, можно сделать пирамиду из раскрывающихся пунктов, или спрятать содержание статьи, если оно слишком объемное. Или добавить макрос форматирования текста.
Макросы форматирования: подсказка, предупреждение, примечание и блок кода
Зачем нужны:
- делают важные текстовые вставки заметными,
- задают единый тон визуального оформления,
- позволяют вставить код в статью и подсветить синтаксис.
В работе с документацией в разных компаниях я часто замечала одну и ту же деталь: для внутренней продуктовой документации нет единых правил форматирования. В пространствах может быть отлично настроено дерево страниц, для доки созданы отдельные разделы, могут быть даже ключевые вопросы или примерный план-содержание, но внутри тексты разных статей на одну и ту же тему будут отличаться.
Пожалуй, самый распространенный пример разноформатного подхода — это выделение подсказки, предупреждения и примечания.
Наверняка вы видели, как в самом начале текста капслоком написано «ВНИМАНИЕ», и после этого идет абзац красного текста. Или подсказка отмечена звездочкой, а пояснение дано внизу страницы курсивом, как в печатных книгах.
Опасность разного оформления в том, что при беглом прочтении такие акценты могут проскользнуть мимо внимания читателя. А еще к ним будет сложно вернуться и придется перечитывать текст заново.
Как использовать
В Confluence нашли изящное решение: унифицировали макросы «Подсказка», «Предупреждение», «Примечание» и «Информация».
В режиме редактирования они выглядят как макросы-рамки, внутри которых можно разместить текст.
После публикации блоки с выделенной информацией становятся заметнее, и, главное, выглядят однообразно в разных статьях.
Еще один классный макрос, который поможет сделать доку более удобной и читаемой — блок кода. Он не только форматирует текст, но и подсвечивает синтаксис языка, на котором код написан. Кроме того, подходит для размещения небольших отрывков кода внутри статьи. Например, если пишете инструкцию по созданию формы обратной связи.
Макросы для интеграции внутреннего контента
Зачем нужны:
- создают «зеркало» статьи или ее отрывка в другом пространстве,
- поддерживают автообновление: достаточно внести правки в оригинал, и все интеграции обновятся сами,
- помогают быстро перейти из «зеркала» в оригинальную статью и углубиться в нужный материал.
Бывает, что одна статья полезна для нескольких команд. Чтобы не дублировать ее в разных пространствах, можно использовать макросы «Включить выборку» и «Включить страницу».
Выборка — это небольшой отрывок из исходной статьи, а страница — полное «зеркало» всего текста.
Главный профит этого макроса в обновлении: если в исходной статье что-то поменяется, цитата или страница-зеркало изменится вместе с ней. Это намного эффективнее ручного обновления скопипащенного отрывка.
Чтобы включить цитату из одной статьи в другую, нужно:
- перейти в режим редактирования на той странице, где содержится необходимая информация,
- выделить предложение, абзац или несколько абзацев, которые надо процитировать,
- вставить макрос «Выборка».
Выделенный текст окажется внутри рамки макроса. После сохранения страница в режиме просмотра будет выглядеть так, будто ничего не произошло, но мы-то знаем, что внутри нее есть цитата.
Теперь открываем ту статью, которая будет содержать эту цитату и вставляем макрос «Включить выборку». Вуаля — цитата появилась на странице. Если исходный текст цитаты поменяется, он обновится автоматически во всех статьях, где будет включена эта выборка.
Если нужно процитировать статью целиком, то на помощь придет макрос «Включить страницу». Здесь после выбора макроса нужно ввести название статьи, которую будем транслировать на этой странице. Дополнительно включать выборку на исходной не нужно.
Макросы интеграции внешнего контента
Зачем нужны:
- позволяют размещать контент из внешних источников без дополнительных авторизаций,
- можно вставить задачи из Jira и видеть актуальный статус, не переходя в таск трекер,
- взаимодействие с интерактивным виджетом происходит прямо в Confluence.
В Confluence можно интегрировать контент из внешних источников. Это очень выручает, когда не вся документация хранится в одном месте и есть разница в форматах.
Самый простой пример такой внешней интеграции — добавление на страницу задач из Jira.
Представьте: проводите встречу, записываете meeting notes в Confluence и по итогам определяете задачи. Как их записать, чтобы исполнители точно знали, что нужно сделать и к какому сроку? Завести их в таск-трекер, а потом привязать к странице с результатами встречи.
Таски добавляются через макрос «Фильтр\проблема Jira» — достаточно ввести код проекта и номер задачи. В Confluence подтянется ее название и актуальный статус.
Еще один полезный макрос интеграции внешнего контента — «Коннектор виджета». С его помощью на страницу можно добавить любой контент из интернета, будь то видео с YouTube, Google-документ или таблица. Все будет отображаться прямо в Confluence без дополнительных авторизаций.
Например, можно собрать галерею из выступлений коллег. На скриншоте — наша подборка докладов сотрудников Selectel.
Где больше узнать про макросы
У Confluence есть много возможностей для работы с контентом. И этот текст, конечно же, не является исчерпывающим руководством.
Если макросов «базовой комплектации» не хватает, то на помощь придет Atlassian Market. В нем можно выбрать из тысячи решений именно то, которое подойдет под потребности вашего проекта. Среди дополнений есть предложения и самого Atlassian, и сторонних разработчиков, которые делали макросы для себя, а после удачного запуска представили их широкой аудитории.
Больше полезной информации по работе с Confluence можно найти в корпоративном университете Atlassian Univercity или на ютуб-канале Atlassian.