Если вы используете Confluence как рабочее пространство, рано или поздно встает вопрос: как правильно работать с файлами.
На первый взгляд всё просто — загрузил файл и забыл. Но на практике есть нюансы: версии, отображение, макросы, поиск.
Разберёмся системно 👇
Что такое вложения в Confluence
Файлы в Confluence — это отдельная сущность, а не просто «картинка в тексте». По сути, это встроенный файловый менеджер с поддержкой версий.
Важно понимать:
- каждый файл прикреплён к конкретной странице
- при этом файлы могут быть у страницы, даже если они не отображаются в тексте
- Confluence хранит историю изменений файлов
Практически имеет смысл загружать только те файлы, с которыми система умеет работать:
- изображения (PNG, JPG, SVG)
- PDF
- текстовые форматы (CSV, JSON, Markdown)
Как добавить файл (3 способа)
Способ 1 — самый быстрый
Просто вставьте файл через: Ctrl + C → Ctrl + V
Но есть нюанс: если имя файла не меняется (например, у скриншотов), Confluence создаст новую версию, а не новый файл.
Способ 2 — через редактор
- В режиме редактирования введите !
- Выберите Insert files and images
- Нажмите Upload files
- Выберите файл
- Нажмите Insert
Файл появится на странице и одновременно попадёт в список вложений.
Способ 3 — через Attachments
- Откройте вкладку Attachments
- Перетащите файл или нажмите Upload file
- Загрузите нужный файл
Этот способ удобен, если вы работаете с большим количеством файлов.
Где искать все файлы страницы
Есть три быстрых способа попасть в список вложений:
- нажать на иконку 📎 (скрепка)
- выбрать Attachments в меню страницы
- нажать клавишу t
Вы попадёте в таблицу, где видно: имя файла, размер, дату загрузки, автора
Управление файлами
Confluence позволяет редактировать свойства файлов.
Чтобы открыть настройки:
- Перейдите в Attachments
- Найдите файл
- Нажмите Properties
Вы можете: изменить имя файла, добавить метки (labels), оставить комментарий, изменить тип файла, прикрепить файл к другой странице.
Версионность
Если загрузить файл с тем же именем: он заменит старый, но предыдущие версии сохранятся.
Чтобы посмотреть историю:
- Откройте Attachments
- Найдите файл
- Нажмите стрелку рядом с именем
Вы увидите: все версии, дату загрузки, автора изменений.
Макросы для работы с файлами
Макрос Attachments
Показывает список файлов прямо на странице.
Что умеет:
- отображать таблицу вложений
- показывать старые версии
- добавлять кнопку загрузки
- включать предпросмотр
Удобно для страниц с файлами (инструкции, отчёты, базы документов).
Макрос Space Attachments
Показывает все файлы пространства на одной странице.
Используется для:
- дашбордов
- централизованных хранилищ
- обзора документов
Можно выбрать конкретное пространство в настройках.
Макрос Multimedia
Позволяет вставлять медиа прямо в страницу:
- видео
- аудио
Поддерживаются форматы: MP4, MP3, WAV.
Можно настроить: размер плеера, автозапуск, зацикливание.
❓ FAQ — частые вопросы
Где лежат файлы?
В разделе Attachments страницы.
Как быстро добавить файл?
Самый простой способ — Ctrl + V.
Как вставить файл в текст?
Введите ! в редакторе.
Почему файл не загружается больше 100 МБ?
Стандартное ограничение Confluence для стабильности и производительности.
Как посмотреть версии файла?
Через Attachments → стрелка рядом с файлом.
Зачем нужны комментарии к файлам?
Комментарии помогают:
- объяснить содержимое файла
- отслеживать изменения
- искать файлы по тексту
Как добавить комментарий к файлу?
Через: Attachments → Properties → Comment
Можно ли использовать несколько макросов Attachments?
Да, но по умолчанию они показывают одни и те же файлы.
Чтобы разделить:
- используйте Filename patterns
- задавайте Labels
- указывайте разные страницы