Confluence как изменить размер шрифта

Changing the fonts

1. Go to the space and choose Space tools > Look and Feel from the bottom of the sidebar.
2. Choose Stylesheet then Edit.
3. Paste your custom CSS into the text field.
4. Save your changes. The new CSS will be visible on all content pages in the space.

How do I add a font to Confluence?

To install a new font in Confluence:

1. Go to (Settings) in the Confluence navigation.
2. Select PDF Export Language Support from the sidebar.
3. Select Choose File.
4. Choose a TTF or TTC file to upload.
5. Select Install to upload the font and install it on your site.

How do I edit text in Confluence?

To edit an existing page or blog post, choose Edit at the top of a page or press E on your keyboard. Confluence automatically saves changes as you type. Changes are only visible when viewing the page after you publish or update. See Collaborative editing for more information on how this works.

How do you highlight text in Confluence?

Simply select text with the mouse and click the “Highlight” button. The selected text is then marked with a nice yellow background. All highlights are listed on the user profile page (“Highlights” tab).

Can you change font size in Confluence?

Confluence intentionally does not give you any options for font size aside from the heading and paragraph text types. It is meant to be a company-wide documentation repository and as such all you documentation should have a similar look and feel. That is also why you cannot choose font.

What font does Atlassian use?

Charlie Sans
Brand typography
We use our custom font, Charlie Sans, for almost everything brand and marketing — from banner ads to billboards. It was designed to be incredibly versatile with lots of range in terms of tone and playfulness.

How do I insert a PDF into confluence?

To add the PDF macro to a page:

1. Upload the PDF file to your page, then publish the page. See Upload Files to learn how to do this.
2. From the editor toolbar, choose Insert > Other Macros.
3. Choose PDF from the Confluence content category.
4. Select the attached file you want to display.
5. Choose Insert.

How do I add color in Confluence?

To change the site’s color scheme:

1. Select (Settings) in the Confluence navigation.
2. Select Colour Scheme in the panel on the left under Look and feel.
3. Select Edit.
4. Enter a color code or use the color-picker to choose a new color.
5. Select Save.

How do I change the font in Jira?

Unfortunately, there is no way to change the font type from the UI. Although there is an open suggestion (still gathering interest), you can take a look and vote to it.

How do I use rich text editor in Confluence?

Choose Administration ( ) > System. Select Rich text editor in the User Interface section of the left hand menu. Click the Enable rich text editing for users toggle to disable or enable the editor. Hovering over the toggle will let you know if the editor is on or off.

Is confluence hard to use?

Confluence templates make it easy for beginners to hit the ground running and quickly get the hang of creating pages. Templates are also efficient for those who need structure for repeated business processes. You can either use one of the best practice blueprint templates we include, or create your own from scratch.

How do I create a text box in Confluence?

Adding text boxes

1. In the toolbar, click the Text Tool.
2. Click anywhere in the drawing canvas and, when a flashing cursor appears, start typing.
3. Tip: To define the width of your text bow, in the drawing canvas, draw a box and, when a flashing cursor appears, start typing.

How do I use macros in Confluence?

Add a macro to your page

1. From the editor toolbar, choose Insert > Other Macros.
2. Select a macro from the list.
3. Enter any required parameters.
4. Choose Insert.

What is anchor in Confluence?

You can use anchors to enable linking to specific locations on a page, and they can be especially useful for allowing your readers to navigate to specific parts of a long document. Anchors are invisible to the reader when the page is displayed.

What is page tree in Confluence?

The Page Tree macro displays a dynamic, hierarchical list of pages starting from a specified parent (root) page. It can act as a table of contents or a list of related topics. When viewing the page tree, your reader can click a link to view the relevant page. The page’s current position is highlighted in the page tree.

How do I create a dynamic table in Confluence?

Create a dynamic table:

1. Start by inserting a Table Data macro onto your page.
2. Within that Table Data macro, create a table like the one in the following image:
3. Now, fill in the table cells with Text Data, Adding a dropdown list of users and List Option macros, like in the following image:

How do I add a sorting table in Confluence?

Our old pages and tables still sort, but anything new we create is no longer sortable. I know the table filter macro is great and cheap but I don’t have approval for any budget on this project and losing the ability to sort tables makes a dent in my ability to pitch Confluence as a serious solution.

Can you freeze panes in Confluence tables?

Yes, it is possible to freeze header row and column with the help of Table Filter macro. You can see it in action on the demo site.

How do I change font size in markdown?

You can change the font size in R Markdown with HTML code tags your text . This code is added to the R Markdown document and will alter the output of the HTML output.

How do I use format painter in Confluence?

To quickly apply the fill style of one object in your Work Area to another, click on the first object, then choose Format Painter. Click on the second object to see the style applied.

How do I increase font size in HTML?

To change the font size in HTML, use the style attribute. The style attribute specifies an inline style for an element. The attribute is used with the HTML

tag, with the CSS property font-size. HTML5 do not support the tag, so the CSS style is used to add font size.

Asked by: Hardy Torphy

Score: 5/5
(23 votes)

Confluence intentionally does not give you any options for font size aside from the heading and paragraph text types. It is meant to be a company-wide documentation repository and as such all you documentation should have a similar look and feel. That is also why you cannot choose font.

How do I change the size of my font?

Change font size

How do I increase the size of a confluence?

Changing the fonts

How do I format text in Confluence?

As with wiki markup, Confluence will convert your markdown to the rich text editor format.
…
Can I insert markdown?

How do I use code blocks in Confluence?

To add the Code Block macro to a page:

42 related questions found

16 ответов

Лучший ответ

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>

<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> 

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}
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}

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

`printf("Hello World");`

У нас есть шесть продуктов, которые используют в России и за рубежом. Это значит, что документация к ним должна быть в одном месте, но разделена по продуктам и языкам.

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

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

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

Меняем дизайн

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

Но дело в том, что сам Confluence даёт очень мало гибкости в стилях и скриптах, а возможности из коробки нетривиальны для понимания и использования, да и непривычны веб-разработчику.

Отмечу, что Confluence — это Java-приложение, а вовсе не веб-сайт с привычными бэкендом и фронтендом. В разделе Внешний вид можно добавить таблицу стилей или настроить пользовательский HTML, но этого недостаточно для полноценного редизайна. Поэтому для вёрстки мы купили плагин Scroll Viewport. Тут-то и началось самое интересное.

Плагин Scroll Viewport

Scroll Viewport — это плагин для Confluence, который позволяет создавать темы, используя привычный редактор кода и файловый менеджер. С его помощью можно писать стили, работать с шаблонами страниц, добавлять изображения, настраивать поиск.

Темы создаются для пространств. Пространства в Confluence — это сущности контента, в которых хранится информация по одному проекту. У нас есть пространство для продуктов: ISPmanager, BILLmanager и т. д., а также для главной страницы. У пространства есть ключ, заголовок, ряд настроек и, собственно, тема.

Редактирование темы в Scroll Viewport: разметка, стили и html

Начнём осваивать Scroll Viewport. Когда плагин установлен и включён, надо кликнуть на шестерёнку и далее — Основные настройки — раздел Scroll Viewport — Themes.

Выбираем, копируем или создаём тему и нажимаем Edit. Открывается редактор темы Scroll Viewport.

Обратите внимание, Scroll Viewport рекомендует не создавать тему с нуля, а брать за основу Scroll WebHelp Theme.

Редактор темы Scroll Viewport: слева структура темы, сверху название файла, в основной части сами файлы

Когда тема создана, можно приступить к её настройке. Зададим разметку и структуру страниц, добавим стили и скрипты, а потом перейдём к редактированию HTML-разметки элементов контента.

Разметка: редактируем, добавляем классы и выводим однотипные элементы в цикле

Структура страниц по типу

В корне темы находятся основные шаблоны: page.vm, search.vm, error.vm, а также изображение-обложка темы thumbnail.png.

Шаблон “page.vm” задаёт структуру всех страниц темы. Здесь можно редактировать html и с помощью переменных placeholders задавать, где будет выводиться контент. Плейсхолдеры обращаются к контенту пространства или данным пользователя (заголовок материала, название пространства, имя автора), с их полным списком можно ознакомиться в хелп-центре разработчика Scroll Viewport.

“page.vm” обращается к шаблонам, которые лежат на уровень ниже, в папке “include”, и оборачивает их в теги и блоки. В этом файле (page.vm) мы собираем страницу по кусочкам, и дополняем разметку всеми необходимыми атрибутами html-документа. Именно здесь мы указываем doctype, прописываем head и body.

Составные элементы страницы

В папке “include” лежат кусочки страницы. По названиям файлов можно догадаться, какой за что отвечает:

• include-htmlhead.vm содержит всё то, что мы обычно указываем в head html-документа: обращения к таблицам стилей, файлам шрифтов, некоторым скриптам, включая стандартные скрипты Confluence и Scroll Viewport;
• include-headerbar.vm задаёт структуру хедера;
• include-footer.vm задаёт структуру футера;
• include-content.vm описывает структуру блока основного контента;
• include-sidebar.vm описывает разметку бокового меню, в котором обычно располагается список всех статей пространства.

Синтаксис шаблонов Scroll Viewport прост для понимания. Операции начинаются с решётки, например “#if (условие)” или “#foreach($language in $languages.available)”, и заканчиваются с помощью “#end”, внутри — тело оператора. Всё остальное представляет собой html-теги.

Стилизация: добавляем стили, изображения и скрипты

Внутри папки “assets” хранятся файлы js и css. Так как мы не создавали тему с нуля, там уже содержатся файлы от разработчиков Scroll Viewport.

Чтобы кастомизировать стили, лучше создать новый css-файл и подключить его в head шаблона страницы. Файлы, которые начинаются на theme, содержат в себе правила базовой темы Scroll Viewport. Их стоит редактировать в случае, когда новые стили упираются в базовые. Будьте внимательны, удаляя и добавляя правила, помните об иерархии селекторов, она может выручить.

В “assets” я также добавила папку с изображениями и папку с файлами шрифтов. Файловый менеджер работает не идеально, добавить папку в нужную директорию нельзя, поэтому пришлось схитрить. Я создала папку на своём компьютере, добавила в неё файл, а потом загрузила в нужную директорию драг-энд-дропом. Как только папка создана, с загрузкой файлов проблем нет.

При создании нового дизайна мы учитывали возможности плагина и ориентировались на уже существующие темы в Scroll Viewport, поэтому внутри assets/js я задержалась ненадолго. Внесла небольшие изменения в существующие файлы скриптов и добавила файлы нужных библиотек. Если изменения будут более значительными, со скриптами придётся разобраться детальнее.

Редактор html-разметки контента статьи

В процессе работы со Scroll Viewport выяснилось, что верстать мы можем, да не всё. Полномочия шаблона плагина заканчиваются на переменной $page.renderContent. Как верстать элементы главной с классами и ссылками? Непонятно. Где HTML? По умолчанию его там и нет. Переменная подсказывает, что нам предстоит выполнить часть вёрстки непосредственно на странице статьи, правда, пока там можно редактировать лишь текст, но не теги.

Благо, всегда можно поискать плагины, и, какая удача, нужный нашёлся почти сразу. Это Confluence Source Editor. После его установки можно в режиме редактирования статьи прошерстить и старый добрый гипертекст. Наконец-то!

Плагин Source Editor

В Scroll Viewport верстаем шапку, сайдбар, футер и задаём стили. Контент верстаем с помощью Source Editor. Всего я создала две темы: для страниц статей и для главной страницы документации.

Настройки Viewport пространства: применяем тему

Когда тема создана, её надо связать с пространством. Для этого в настройках пространства нужно создать Viewport. Viewport — это то, что связывает пространство и тему. Только создав эту сущность, можно применить стили темы для пространства.

Войдите в пространство нужного продукта, откройте Настройки пространства — Дополнения. Здесь можно создать Viewport и управлять им: задавать темы, типы контента, разрешения, домен и путь.

Форма для связи пространства с темой, создания Viewport

Выбрать тему

На вкладке Themes представлены все созданные темы и одна тема по умолчанию, которая появляется вместе с плагином Scroll Viewport. Выберите тему и примените к пространству.

Вкладка Content позволяет выбрать тип контента, к которому будет применяться тема. Она нам наименее интересна, так как ключ пространства подтягивается автоматически.

Настроить адреса

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

Есть два типа структуры URL:

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

С адресами страниц есть нюанс. Для статей на разных языках Confluence по-разному формирует URL. На английском выводит в адрес название, а на русском — несвязный набор букв, символов и чисел. Scroll Viewport позволяет привести адреса к одному виду. Если выбрать многоуровневую структуру, то в адресах русских статей будет отображаться название текста транслитом.

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

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

Включить тему

Во вкладке Permissions можно обозначить, каким пользователям будет доступен просмотр пространства с применением Viewport.

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

• Restrict access to Confluence UI,
• Automatically redirect users to viewport.

Настройки вида пространства во вкладке Permissions

Настраиваем разделение по языкам

У нас документация на английском и русском, поэтому нужно, чтобы пространства на русском открывались на домене .ru, а на английском — на .com.

В Scroll Viewport такие настройки предусмотрены, но если просто ввести отличный от основного домен во вкладке URL в поле Domain Name, два домена не заработают. Это особенность плагина Scroll Viewport.

Надо настроить Reverse proxy, чтобы запросы пользователей передавались Confluence и там разруливались на два домена — см. инструкцию Scroll Viewport (конфигурации для Nginx и TOMCAT). После этого надо выключить режим совместного редактирования или внести дополнительные изменения. Теперь можно указывать один из двух доменов в настройках Viewport.

Темы для разных языков

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

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

В итоге у меня получилось четыре темы: две для главных страниц на русском и английском, и ещё по две для страниц контента для каждого языка.

Настраиваем поиск по сайту

Параметры поиска настраиваются в файлах из папки “include”. Внутри них мы задаём параметры поиска:

• include-quicksearch.vm отвечает за поле поиска на всех страницах контента,
• include-search.vm задаёт структуру страниц с результатами поиска.

Где искать

По умолчанию поиск работает только по текущему пространству. Например, в пространстве ISPmanager — только по статьям об ISPmanager. Если нужен поиск по списку пространств, в настройках include-quicksearch.vm нужно указать их ключи.

<div id="ht-search">
    #set($search = "/search")
    #if ($stringUtils.equals(${viewport.link}, "/") == false)
        #set($search = "${viewport.link}/search")
    #end
  <div class="ht-search-input">
    <form action="$search" method="GET">
        <input class="search-input" type="text" autocomplete="off" name="q" value="$!searchRequest.queryString" placeholder="Что вы ищете?"/>
       	<input type="hidden" name="max" value="20" /> 
        <input type="submit" style="display:none" value="Submit">
      
      ## --- START --- Scroll Versions and Scroll Translations Integration -------------------------------------------
        #if ($versions || $variants || $languages)
        #if($versions)
        <input id="version" type="hidden" name="scroll-versions:version-name"
               value="$versions.current.value"/>
        #end
        #if($variants)
        <input id="variant" type="hidden" name="scroll-versions:variant-name"
               value="$variants.current.value"/>
        #end
        #if($languages)
        <input id="language" type="hidden" name="scroll-translations:language-key"
               value="$languages.current.value"/>
        #end
        #end
        ## --- END -----------------------------------------------------------------------------------------------------
	</form>
  </div>
  </div>  

Форма поиска для отдельного пространства

<div id="ht-search">
    #set($search = "/search")
    #if ($stringUtils.equals(${viewport.link}, "/") == false)
        #set($search = "${viewport.link}/search")
    #end
  <div class="ht-search-input">
    <form action="$search" method="GET">
        <input class="search-input" type="text" autocomplete="off" placeholder="Что вы ищете?" name="q" value="$!searchRequest.queryString" />
        <input type="hidden" name="s" value="BILLmgr" />
        <input type="hidden" name="s" value="VMKVM" />
        <input type="hidden" name="s" value="VMmgr5Cloud" />
        <input type="hidden" name="s" value="VMmgr5OVZ" />
      	<input type="hidden" name="s" value="DCImgr" />
      	<input type="hidden" name="s" value="IPmgr5" />
        <input type="hidden" name="s" value=" ISPmgr5BUSINESS" />
        <input type="hidden" name="s" value="ISPmgr5Lite" />
        <input type="hidden" name="s" value=" DNSmgr" />
        <input type="hidden" name="s" value=" COREmgr" />
      	<input type="hidden" name="max" value="20" /> 
      
        <input type="submit" style="display:none" value="Submit">
      
      ## --- START --- Scroll Versions and Scroll Translations Integration -------------------------------------------
        #if ($versions || $variants || $languages)
        #if($versions)
        <input id="version" type="hidden" name="scroll-versions:version-name"
               value="$versions.current.value"/>
        #end
        #if($variants)
        <input id="variant" type="hidden" name="scroll-versions:variant-name"
               value="$variants.current.value"/>
        #end
        #if($languages)
        <input id="language" type="hidden" name="scroll-translations:language-key"
               value="$languages.current.value"/>
        #end
        #end
        ## --- END -----------------------------------------------------------------------------------------------------
	</form>
  </div>
  </div>  

Форма поиска по списку пространств

Как выводить результаты

Как будет выглядеть список с результатами поиска, задаёт шаблон include-search.vm. В моём случае у каждой найденной ссылки есть заголовок, описание и название пространства, к которому относится статья. Здесь же можно указать, что пользователь увидит, если поиск ничего не найдёт.

Из фрагмента шаблона ниже видно, что результаты поиска выводятся в цикле с использованием переменных-плейсхолдеров. Результатов поиска может быть довольно много, поэтому внизу страницы сделали пагинацию. Подробное руководство по шаблонам страниц поиска можно посмотреть в документации по поиску Scroll Viewport.

  <div id="ht-wrap-container">
          <div id="search-results">
           #if ($searchResults.total > 0)
            #foreach($result in $searchResults.items)
                <section class="search-result">
                  #set( $space = '' )
                  #if( $result.type == 'page' )
                     #set( $space = $result.getObject().fromConfluence.getSpace().getName() )
                  #end
                    <header>
                        <h4>
                            <a href="$result.link">$result.displayTitle</a>
                        </h4>
                    </header>
                    <div class="search-result-content">
                        <p class="search-result-desc">$result.getDescription(280)</p>
                       #if( $space )
                		<p class="search-result-space">$space</p>
            		   #end
                    </div>
                </section>
            #end
           #else
            <h4>Мы ничего не нашли :(</h4>
            <p>Проверьте запрос на ошибки, измените его или воспользуйтесь содержанием.</p>
           #end
            
             <div class="search-results-pager">
           	#if($pager.hasPrev)
          	<a class="back" href="$pager.prevLink">Назад</a>
      		#end
			
            #foreach ($pagerPage in $pager.pages)
				<a href="$pagerPage.link" 
              #if ($pagerPage.current)
              	class="current"
              #end>$velocityCount</a>
			#end
              
      		#if($pager.hasNext)
          	<a class="next" href="$pager.nextLink">Дальше</a>
			#end
            </div>
        </div>

      </div>
  	</div>
</section>

Как выглядит страница поиска

В шаблоне “search.vm” задаётся вся структура поисковых страниц, начиная от открывающегося тега . В этом шаблоне и следует собрать вместе форму поиска и его результаты. В итоге получим страницу типа “поиск”, которая включает в себя форму поиска и найденные совпадения, разбитые на несколько страниц.

Все шаблоны первого уровня, расположенные в структуре рядом с page.vm, переопределяют структуру страницы в зависимости от ее типа. Так search.vm задаёт вёрстку страниц поиска, а error.vm — страниц ошибок.

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

Настраиваем индексацию

Чтобы настроить индексацию, нужно положить карту сайта в корневую папку. Но у нас нет корневой папки, ведь Confluence — это Java-приложение, а не сайт. Что делать?

Подсказка нашлась в документации Scroll Viewport. Внутри пространства разводящих страниц, где хранится главная, надо создать новую статью, назвать её sitemap.xml и расположить на уровень ниже главной.

Расположение важно, потому что, как отмечают в документации, файл карты не будет доступен для Viewport с префиксом пути “/”. Как раз такой префикс у Viewport пространства главной страницы.

Статья sitemap.xml в структуре пространства

Мы помним, что в Confluence заголовок статьи и её URL связаны. Когда страница создана и уже открывается по адресу docs.ispsystem.com/sitemap-xml, займёмся её корректным отображением. Такой формат URL не совсем типичен, но вполне нам подойдёт.

Карта сайта должна быть без лишних тегов и стилей, ведь она создаётся для поисковиков. Чтобы заданные раньше стили не применялись к карте сайта, надо создать шаблон include-sitemap.vm и скопировать в него содержимое подготовленной карты сайта — sitemap.xml. Это будет выглядеть следующим образом:

Теперь для страницы sitemap.xml создадим отдельное условие в шаблоне page.vm, чтобы стили и структура из шаблонов применялись для всех страниц, кроме карты сайта.

Для условия понадобится идентификатор. Узнать его можно, открыв страницу, а затем нажав Многоточие — Информация о странице, в конце адресной строки и будет идентификатор. Теперь пишем условие:

#if ($page.id == 25370522)
  $include.template("/include/include-sitemap.vm")
#else
/Разметка для остальных страниц/

После описанных манипуляций путь к карте сайта можно указать в панелях вебмастера Яндекс и Google, и начнётся индексация.

В целом вопрос индексации для меня остаётся открытым. Не до конца понятно, как индексируются страницы контента Confluence. Нужно подумать, как автоматизировать процесс.

Такие дела

Вот так я настроила дизайн, локализацию, поиск и индексацию документации на Confluence. Понадобилось время и помощь техподдержки Scroll Viewport, чтобы разобраться с неочевидными вещами. Надеюсь, мой опыт будет полезен тем, кто столкнётся с похожей задачей.