Как отформатировать встроенный код в Confluence?

как я могу отформатировать inline code в Confluence like this? Я имею в виду, не отдельный блок кода, а просто inline classname, например.

14 ответов


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

Это {{example}}.

Если вы используете Confluence 4.x или выше, вы также можете просто выбрать опцию "предварительно отформатированный" из меню стиля абзаца.

полная ссылка здесь: https://confluence.atlassian.com/display/CONF56/Quick+Reference+Guide+for+the+Confluence+Editor


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

  1. выберите значок шестеренки в правом верхнем углу экрана, затем выберите Confluence Admin.
  2. Выберите Таблицу Стилей.
  3. Выбрать Изменить.
  4. вставьте пользовательский CSS в текстовое поле.
  5. Выберите "Сохранить".

пользовательский CSS для отображения серого фона в одноместных блоках:

code {
    padding: 1px 5px 1px 5px; 
    font-family: Consolas, Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace, serif;
    background-color: #eeeeee;
}

если вы используете Confluence OnDemand (облако):

  1. нажмите на шестеренку / шестерню в нижней части боковой панели слева
  2. выберите внешний вид
  3. выберите боковая панель, верхний и Нижний колонтитулы tab
  4. вставьте пользовательский CSS в заголовок поле
  5. оберните код в {style} блок
  6. сохранить

вставить следующее:

{style}
code {
    padding: 1px 5px 1px 5px; 
    font-family: Consolas, Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace, serif;
    background-color: #eeeeee;
}
{style}

после этого вы получите хороший и аккуратный stackoverflow-стильный встроенный код, просто написав {{sometext}}.


вы можете попросить своего администратора дьявольского слияния создать для вас макрос. Вот пример макроса для Confluence 3.x

Macro Name:    inlinecode
Macro Title:   Markup text like stackoverflow inline code
Categories:    Formatting
Macro Body Processing: Convert wiki markup to HTML
Output Format: HTML
Template:

## Macro title: Inline Code
## Macro has a body: Y
## Body processing: Convert wiki markup to HTML
## Output: HTML
##
## Developed by: My Name
## Date created: dd/mm/yyyy
## Installed by: My Name
## This makes the body text look like inline code markup from stackoverflow
## @noparams
<span style="padding: 1px 5px 1px 5px; font-family: Consolas, Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace, serif; background-color: #eeeeee;">$body</span>

затем пользователи могут использовать {inlinecode}like this{inlinecode}

вы также можете использовать {html} или {style} макросы, если они установлены или добавить этот стиль к таблице стилей для вашего пространства.

пока вы на нем, попросите администратора Confluence создать для вас макрос kbd. То же, что и выше, за исключением Macro name is kbd и Template - это:

<span style="padding: 0.1em 0.6em;border: 1px solid #ccc; font-size: 11px; font-family: Arial,Helvetica,sans-serif; background-color: #f7f7f7; color: #333;  -moz-box-shadow: 0 1px 0px rgba(0, 0, 0, 0.2),0 0 0 2px #ffffff inset; -webkit-box-shadow: 0 1px 0px rgba(0, 0, 0, 0.2),0 0 0 2px #ffffff inset; box-shadow: 0 1px 0px rgba(0, 0, 0, 0.2),0 0 0 2px #ffffff inset; -moz-border-radius: 3px; -webkit-border-radius: 3px; border-radius: 3px; display: inline-block; margin: 0 0.1em; text-shadow: 0 1px 0 #fff; line-height: 1.4; white-space: nowrap; ">$body</span> 

затем вы можете написать документацию, чтобы сказать пользователям нажать F1 и Enter ключи.


в Confluence 5.4.2 вы можете добавить окружить свой встроенный код с <code></code> теги в исходном редакторе таким образом:

Confluence will show <code>this inline code</code> in a fixed font. 

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


окружите свой встроенный текст С {{ }}.

предостережения:

  1. вы должны нажмите пробел после }}
  2. вы не можете копировать встроенный форматированный текст и поддерживать его внешний вид. Если вы скопируете его, вы не сможете добавить {{ }} исправить. Просто перепечатайте его или вставьте без форматирования (⌘cmd в+ Shift+V на Mac) затем добавьте {{ }} и хит космос.
  3. если добавить {{ }} к существующему тексту позже, он не может быть окружен другими символами, например, если вы хотите скобки вокруг вашего предварительно отформатированного текста, вы не можете исправить (my text) добавив скобки ({{my text}}). Сначала добавьте пространство вокруг текста ( my text ) добавить {{ }}.

Если вы хотите вставить большой блок кода с необязательными номерами строк и т. д., Используйте макрос кода (доступен в разделе макросы -> другое).


Я нашел форматирование с цветами немного сложнее, так как Confluence (5.6.3) очень суетится вокруг пространств вокруг блоков {{monospace}}.

Creating Colored Monospace with Wiki Markup

As rendered by Confluence


чтобы отформатировать код в строке внутри текста, используйте символ "' для окружения кода. Обычно находится слева от клавиши "1"на клавиатуре.

пример:

`printf("Hello World");`

тот же разделитель, что и Stack Exchange!


по состоянию на слияние 4 и выше, ввод двух фигурных скобок не работает.

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

Windows: Ctrl + Shift + M

Mac: Команда + Shift + M

кроме того, рядом с полужирным шрифтом и курсивом вы можете нажать кнопку" Дополнительно " и выбрать Monospace:

enter image description here


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

вы можете просто использовать HTML-макрос, а затем вставить содержимое, завернутое в <pre> </pre> теги.


самый простой способ, который я нашел, чтобы сделать это, - написать в markdown прямо с начала строки. Нажмите Ctrl+D (ярлык для открытия диалогового окна ввода разметки) и введите markdown. Обычный редактор wiki не кажется очень хорошим для точного форматирования. Похоже, он мало знает о стилях символов и знает только стили абзацев.


Я использую комбинацию ответов Зельфира и Питера Глюка. т. е.

  1. (Mac-speak) нажмите COMMAND + SHIFT + D
  2. выберите Markdown в раскрывающемся списке всплывающего окна модели
  3. окружите свой текст тегом кода-т. е. <code>bovvered</code>
  4. нажать вставить

самый простой способ для меня-вставить разметку.

Confluence Insert Markup

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

он вставит отформатированный текст в новую строку, но вы можете скопировать его в любом месте, даже встроенным.


Если у вас есть WinWord, вы можете скопировать то, что вам нужно, в это, подправить результаты, а затем вставить это в слияние. Я обнаружил, что это проще, чем другие решения здесь.