confluence

Конфлюенс или подобное имеет смысл тогда, когда нужно убедить писать, редактировать и комментировать там ряд людей. Сделать им всем задачу как можно легче — открыл страницу, ткнул, куда надо, и написал. И желательно, чтоб дальше это так и оставалось там лежать :) Комментировать ещё удобно. Впрочем, без норм админа (наблюдаемый случай) будет весело созерцать проблемы с доступом в целом или к отдельным разделам и страницам. Ибо.

Как и любой WYSIWYG, так себе приспособлен для длительной работы с текстами, полнотекстовых поисков, массовых замен и всего такого.

• Если конфлюенс при переходе в редактирование внезапно показывает «неизвестное вложение» вместо картинок, можно попробовать вернуть страницу к последней опубликованной.
• чтобы получить маркированный список как список подпунктом к нумерованному (или наоборот):
  • сделать одноуровневый нумерованный список;
  • выделить ту часть, которая должна уйти в подпункты, нажать сделать отступ;
  • и только теперь на этой части с отступом нажимать на нужный тут тип списка.
• Для экспорта русскоязычных pdf нужно озадачиться шрифтами.
• Плагин Scroll прям рулит для более симпатичного экспорта pdf.
  • И умеет делать на странице блоки «показываю на странице, но не кладу в pdf» и «кладу в pdf, но не показываю на странице». И даже допускает засовывание в такие блоки других макросов. Что очччень полезно при вставке роликов, например: на страницу — ролик, в pdf — строку «Демонстрация ролика».
• Мультимедиа-макрос умеет показывать только mp4-видео. Даже если браузер прекрасно кушает ogg или там webm.
  • Мультимедиа-макрос — существует и отдельный от вставки картинки или иного файла. Причём сначала надо загрузить файл так же, как картинку (но можно не вставлять). Потом уже выбирать мультимедиа-макрос и указывать ему файл, который показывать.
• чтобы показывать svg-файлы, нужно на странице Конфлюенса напечатать ! и выбрать ранее загруженный svg. Тогда он отображается и с ним можно иметь дело как с картинкой. Если вставлять как обычно картинку через макрос в меню, это не работает. (https://bobswift.atlassian.net/wiki/spaces/info/pages/31916055/How+to+display+SVG+attachments+in+Confluence)
• В меню «Инструменты пространства» пункт «Настроить боковую панель» позволяет убрать малополезное и добавить нужных быстрых ссылок.
• Чтобы сделать красивую (или просто произвольную) входную страницу пространства, нужно указать страницу в «Обзор» → «Детали пространства» → «Редактировать детали пространства», пункт «Домашняя страница».
• — волшебная кнопочка в панели инструментов наверху, которая позволяет доступ к раскладке страницы. — что, собстно, по кнопке появляется, кнопочки для управления раскладкой.
• Можно пытаться в нечто типа «единого источника». Макросы «включить страницу» и «создать/включить excerpt/выборку» — для этого вполне себе, хотя при активном длительном использовании можно рехнуться.
  • Для того, чтоб включить часть текста со страницы, на одной странице надо сначала добавить что-то в макросе «Выборка». Это при редактировании выглядит как блок, но в результате отображается как обычная часть строки.
  • Потом в другом месте «Вставить выборку», и вот это уже блок, и даже с заголовком.
  • Если при вставке на панельке слева отметить «Удалить панель окружения», тогда получится часть строки.
• Чтобы получить «комментарий», в смысле, текст, видимый при редактировании, но не при просмотре страницы, применяем макрос «Свойства страницы», ставим галочку «скрытое». Вероятно, при таком применении отчет по свойствам будет выглядеть довольно загадочно, но цель-то достигнута.
• https://drawio-app.com/blog/folding-and-moving-trees-in-drawio/ - конфлю умеет draw.io диаграммы, а тут подсказки, как раскидывать их автоматичски.
  • https://drawio-app.com/blog/increase-productivity-with-mind-maps-in-draw-io/.
    • https://github.com/jgraph/drawio-desktop/releases - скачать десктопное приложение drawio 2024-01-26
• https://confluence.atlassian.com/conf75/links-1004946491.html – про ссылки, норм такая табличка.
• https://www.lucidchart.com/pages/ – фпринципе, тож диаграммы.
• https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-getContentById – про REST API конфли, то, что мне было любопытнее всего.
• https://confluence.atlassian.com/doc/restore-a-space-or-multiple-spaces-152036.html – про импортировать в конфлю пространство. Но кажется, в нашем случае будет достаточно экспортировать в html и повесить куда-то в удобное для просмотра место.
• https://atlassian-python-api.readthedocs.io/confluence.html – питончиковое для общения с конфлей. Руками пока не трогала.