Confluence – популярная платформа для совместной работы и документирования, используемая многими организациями. Одной из его важных функций является возможность отображать фрагменты кода или блоки на страницах. Однако иногда ширина блоков кода по умолчанию может оказаться непригодной для отображения более длинных строк кода. В этой статье мы рассмотрим различные методы настройки ширины блоков кода в Confluence. Мы предоставим примеры кода и пошаговые инструкции, которые помогут вам настроить ширину в соответствии с вашими потребностями.

Метод 1: использование стилей CSS (глобальный)

Confluence позволяет добавлять на страницы собственные стили CSS. Используя эту функцию, вы можете глобально регулировать ширину блоков кода. Вот пример:

1. Перейдите в «Настройки пространства» в Confluence.
2. Выберите «Таблица стилей» в меню слева.
3. Добавьте следующий код CSS, чтобы настроить ширину блока кода:

pre.codeContent {
  max-width: 500px !important;
}

4. Сохраните изменения, и блоки кода теперь будут иметь ширину 500 пикселей.

Метод 2: использование стилей CSS (для конкретной страницы)

Если вы хотите настроить ширину блока кода только на определенных страницах, вы можете использовать настройку CSS для конкретной страницы. Вот как:

1. Отредактируйте нужную страницу Confluence.
2. Нажмите кнопку «Вставить» на панели инструментов и выберите «HTML» в раскрывающемся списке.
3. Добавьте следующий HTML-код, чтобы встроить блок стиля CSS:

<style>
  pre.codeContent {
    max-width: 500px !important;
  }
</style>

4. Сохраните страницу, и блоки кода на этой конкретной странице будут иметь ширину 500 пикселей.

Метод 3. Использование пользовательского макроса

Confluence предоставляет функцию под названием «Пользовательские макросы», которая позволяет создавать фрагменты контента, которые можно использовать повторно. Вы можете создать пользовательский макрос для регулировки ширины блоков кода. Вот пример:

1. Перейдите в раздел «Космические инструменты» в Confluence.
2. Выберите «Пользовательские макросы» в меню слева.
3. Нажмите «Создать пользовательский макрос» и укажите имя (например, «AdjustCodeBlockWidth»).
4. Добавьте следующий код в тело макроса:

## @param Width:title=Code Block Width|type=number|required=true|default=500
<style>
  pre.codeContent {
    max-width: $paramWidth$px !important;
  }
</style>

5. Сохраните пользовательский макрос.
6. Отредактируйте нужную страницу Confluence, вставьте макрос с помощью браузера макросов и укажите желаемое значение ширины (например, 500).

Метод 4. Использование стороннего плагина

Если вы предпочитаете более удобный подход, вы можете рассмотреть возможность использования стороннего плагина Confluence, который предлагает расширенные возможности настройки блоков кода. Некоторые популярные плагины включают «Макрос блока кода» и «Макрос лучшего кода». Эти плагины часто предоставляют интуитивно понятные настройки для регулировки ширины блоков кода без написания собственного CSS или макросов.

Настройка ширины блоков кода в Confluence необходима для обеспечения правильного отображения фрагментов кода в документации. В этой статье мы рассмотрели различные методы, включая стили CSS, пользовательские макросы и сторонние плагины, для настройки ширины блоков кода. Применяя эти методы, вы можете улучшить читаемость и представление фрагментов кода на страницах Confluence.