Confluence спойлер как сделать

Артём Санников

Данная книга является руководством для начинающих специалистов в области анализа и обработки данных. В книге рассматривается язык SQL и его процедурное расширение PL/SQL от компании Oracle.

Главная › Социальные сети › ВКонтакте › Wiki разметка › Спойлеры в wiki-разметке

Спойлеры в wiki-разметке

Что такое спойлер?

Спойлер — это открывающиеся / закрывающиеся объект с заголовком и содержанием.

Различные варианты комбинирования спойлера с таблицами и другими спойлерами

Код закрытого спойлера	Результат
Текст >>
Код открытого спойлера	Результат
<Текст >>
Спойлер в спойлере	Результат
Текст >> >>
Совмещение открытых и закрытых спойлеров	Результат
<Открытый спойлер >> >> Текст >> >>
Спойлер внутри таблицы	Результат
<\| \|- \| Текст >> \|>
Сближение спойлеров (2 и более спойлеров в таблице)	Результат
<\| \|- \| Текст >> Текст >> \|>
Таблица внутри спойлера	Результат
<\| \|- ! A !! B !! A+B \|- \| B \|\| A \|\| B+A \|> >>

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

Использование тега в списках спойлера

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

Список в спойлере без использования тега	Результат
* Пункт 1 * Пункт 2 * Пункт 3 >>
Список в спойлере с использованием тега	Результат
* Пункт 1 * Пункт 2 * Пункт 3 >>

С уважением, Артём Санников

Записи по теме

Таблицы в wiki-разметке
Якоря в wiki-разметке
Фотографии в wiki-разметке
Документы в wiki-разметке
Видео в wiki-разметке
Аудио в wiki-разметке
Ссылки в wiki-разметке
Страницы в wiki-разметке

Как использовать макросы в Confluence, чтобы систематизировать и оформить документацию по продукту и процессам?

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

Такой вот немаловажный нюанс.

Всего голосов 5: ↑5 и ↓0 +5
Ответить Добавить в закладки Ещё
Показать предыдущий комментарий

Можно сделать кнопку в самом начале страницы, которая будет разворачивать все спойлеры, после этого поиск будет отрабатывать как и ожидается. Кнопку можно так и назвать «Для поиска на странице».

Всего голосов 2: ↑2 и ↓0 +2
Ответить Добавить в закладки Ещё
Показать предыдущий комментарий

Подскажите, как это реализовать, пожалуйста, вместе со спойлерами этого макроса https://confluence.atlassian.com/doc/expand-macro-223222352.html

Комментарий пока не оценивали 0
Ответить Добавить в закладки Ещё

Спасибо за статью, а каким макросом саму страницу делить на блоки (горизонтальные или вертикальные)? Блоки — как раз пунктир вокруг макроса..

Всего голосов 1: ↑1 и ↓0 +1
Ответить Добавить в закладки Ещё
Показать предыдущий комментарий

Спасибо за фидбек! Рада, что она показалась полезной)

Чтобы разделить страницу на блоки, воспользуйтесь «Разметкой страницы», которая находится в панели простого текстового редактора. Жмете «Добавить раздел», появляется строка, которую можно разделить на 1, 2 или 3 колонки. Чтобы добавить еще строки, снова жмете на «добавить раздел». На одной странице может быть много разделов с разной разметкой)

Комментарий пока не оценивали 0
Ответить Добавить в закладки Ещё
Показать предыдущий комментарий

Еще сюда же добавлю макросы Section и Column. Не очень удобно при заполнении, но достаточно гибко по сути 🙂

Всего голосов 1: ↑1 и ↓0 +1
Ответить Добавить в закладки Ещё

«Таски добавляются через макрос «Фильтр\проблема Jira»‎ — достаточно ввести код проекта и номер задачи». Кровь из глаз, простите. «Таска» — это «задача». И «Проблема» — это тоже «задача». С последнего бомбит особенно. Ну не переводится «problem» в подобных контекстах как «проблема». У Аполлона-13 была проблема. Ещё раз простите, накипело.

Всего голосов 1: ↑1 и ↓0 +1
Ответить Добавить в закладки Ещё
Комментарий пока не оценивали 0
Ответить Добавить в закладки Ещё

Интересный макросы: свойства страницы и отчёт по свойствам страницы. Если таблицу обернуть в свойства страницы, то потом можно автоматизировать сбор различных список и поиск внутри по множеству страниц

Всего голосов 1: ↑1 и ↓0 +1
Ответить Добавить в закладки Ещё

Ещё есть такие фишки:

метки (labels)(помогает для создания облака тегов на стартовой странице Space с использованием соответствующего макроса);

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

Комментарий пока не оценивали 0
Ответить Добавить в закладки Ещё

Самое прикольное с макросами:

В Google Chrome, в режиме редактирования, страница с объемными макросами и текстами, число которых далеко переваливает за 2 десятка начинает страшно тормозить. Больше всего отжирает время ядра как раз скрипт редактора этих макросов (сжатый и объединенный с иными функциями в один .js)

При использовании Firefox, нагрузка разномерно распределяется по нескольким ядрам и страница более отзывчивая, но так же могут быть фризы.

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

Наибольший заголовок

Текстовые эффекты используются для изменения форматирования слов и предложений.

*жирный*

_выделенный_

??цитирование??

-удаленный-

+вставленный+

^верхний индекс^

~нижний индекс~

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 для заголовочных строк таблицы.

Код, заданный здесь, создает таблицу которая выглядит как:

Расширенное форматирование

Расширенное форматирование текста.

 предварительно отформатированный кусок текста 
таким образом, дальнейшее _форматирование_ здесь *не* производится

Делает предварительно отформатированный блок текста без синтаксической подсветки. Все опциональные параметры макроса также действительны для .

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

предварительно отформатированный кусок текста таким образом, дальнейшее _форматирование_ здесь *не* производится

 Некий текст

 Некий текст с заголовком

 блок текста, окруженный *панелью* еще _другая_ линия

title: Заголовок панели
borderStyle: Стиль границы, которая используется в панели (сплошная, пунктирная и любая другая CSS-valid)
borderColor: Цвет границы, которая используется в панели
borderWidth: ширина границы, которая используется в панели
bgColor: Цвет фона этой панели
titleBGColor: Цвет фона заглавной секции этой панели

Мой заголовок
блок текста, окруженный панелью
еще другая линия
// Some comments here public String getFoo()

Делает предварительно отформатированный блок текста синтаксически подсвеченным. Все опциональные параметры макроса также действительны для . Язык по умолчанию — Java, но вы такуже можете указать JavaScript, ActionScript, XML или SQL.

Bar.java

// Some comments here public String getFoo() { return foo; }

 "attribute"/>

Разное

другие различные возможности синтаксической подсветки.

Графические эмотиконы (смайлы).

Макрос спойлера (скрыть-показать)

Макрос спойлера это довольно простой, но очень полезный макрос.

В стандартной поставке он не установлен, поэтому его нужно добавить в вашу систему.

Обратитесь к руководству по добавлению расширений.

Данный макрос называется ShowHide его id:org.xwiki.contrib.showhide:showhide-macro

После его установки, вы сможете добавить его на страницу.

Самый удобный способ это сделать, просто выделить кусок текста который вы хотите разместить внутри спойлера, после чего вызвать меню макросов и выбрать макрос showhide:

Вы можете настроить некоторые параметры макроса.

1 — Сообщение, которое отображается когда спойлер свернут.

2 — Сообщение, которое отображается когда спойлер развернут.

3,4 — Можно настроить некоторые эффекты.

Чтобы увидеть макрос в действии, нажмите на слово «Показать. » ниже.

У лукоморья дуб зелёный;
Златая цепь на дубе том:
И днём и ночью кот учёный
Всё ходит по цепи кругом;
Идёт направо — песнь заводит,
Налево — сказку говорит.
Там чудеса: там леший бродит,
Русалка на ветвях сидит;
Там на неведомых дорожках
Следы невиданных зверей;
Избушка там на курьих ножках
Стоит без окон, без дверей;
Там лес и дол видений полны;
Там о заре прихлынут волны
На брег песчаный и пустой,
И тридцать витязей прекрасных
Чредой из вод выходят ясных,
И с ними дядька их морской;
Там королевич мимоходом
Пленяет грозного царя;
Там в облаках перед народом
Через леса, через моря
Колдун несёт богатыря;
В темнице там царевна тужит,
А бурый волк ей верно служит;
Там ступа с Бабою Ягой
Идёт, бредёт сама собой,
Там царь Кащей над златом чахнет;
Там русский дух. там Русью пахнет!
И там я был, и мёд я пил;
У моря видел дуб зелёный;
Под ним сидел, и кот учёный
Свои мне сказки говорил.

Также мы сделали вложенную страницу на которой вы можете просмотреть примеры макроса скрыть показать с эффектами .

Вы можете обратиться к нам и мы выполним перевод любого не переведенного макроса или расширения!