Часто задаваемые вопросы о брендинге и стиле

Да. Документерра поддерживает гибкий брендинг портала документации с помощью CSS-файлов. Дополнительные сведения смотри в разделе Брендинг и стилизация.

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

Да. Это можно сделать для каждого конкретного проекта или публикации в Настройках → Читательский интерфейс  или в таком же разделе «Настроек проекта».

Наша команда дизайнеров будет рада вам помочь, свяжитесь с нами по почте support@documenterra.ru и опишите свои требования.

Да. Стили контента можно задать либо из CSS-файла, либо с помощью встроенного стиля. Однако мы рекомендуем использовать CSS-файл, так как в долгосрочной перспективе так будет проще редактировать контент. Узнайте больше о CSS-файлах проекта:   Стили и скрипты проекта.

Да. Для одного проекта можно указать несколько CSS-файлов. Это может быть полезно при использовании разных таблиц стилей для разных типов условных публикаций или версий документации. Для получения более подробной информации смотри раздел Стили и скрипты проекта.

Все файлы стилей хранятся в файловом хранилище Документерры, поэтому их можно открывать в Хранилище файлов или загружать новые файлы. Чтобы управлять CSS-файлами определенного проекта, перейдите в Настройки проекта → Основные настройки. В разделе «Стили проекта» можно создать новый CSS-файл, добавить существующий или отредактировать его. Для получения более подробной информации смотри раздел Стили и скрипты проекта.

Да. После нажатия кнопки сохранения в редакторе CSS-файлов все изменения будут отражены на страницах проекта. Просто выполните обновление, чтобы увидеть изменения на уже открытой странице. Когда страница находится в режиме редактирования, нажмите «Обновить стили CSS» в разделе «Стили» на вкладке «Главная» верхней панели в режиме «Дизайн» — стили будут перезагружены без выхода из режима редактирования.

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

/* Navigation element styles */

.CHNavLinkTop, .CHNavLinkTop:hover
{
background-image: url('/resources/storage/project-sample/home.gif');
background-repeat: no-repeat;
color: transparent;
width: 25px;
height: 25px;
display: inline-block;
overflow: hidden;
}

.CHNavLinkNext, .CHNavLinkNext:hover
{
background-image: url('/resources/storage/project-sample/next.gif');
background-repeat: no-repeat;
color: transparent;
width: 25px;
height: 25px;
display: inline-block;
overflow: hidden;
}

.CHNavLinkPrevious, .CHNavLinkPrevious:hover
{
background-image: url('/resources/storage/project-sample/prev.gif');
background-repeat: no-repeat;
color: transparent;
width: 25px;
height: 25px;
display: inline-block;
overflow: hidden;
}

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

p {
  font-family: Calibri, Candara, Segoe, "Segoe UI", Optima, Arial, sans-serif;
}

Данное правило определяет шрифт для всех абзацев, которым не присвоены встроенные стили или определенные CSS-классы. Если какой-либо абзац имеет встроенный стиль, который блокирует это правило, можно использовать кнопку в верхней панели «Очистить формат», чтобы очистить встроенное форматирование этого абзаца и применить стиль абзаца по умолчанию из CSS-файла проекта.

Создайте страницу Заголовок/Футер, которая будет использоваться в качестве сниппета для заголовка/футера. Затем откройте Шаблон страницы и добавьте следующий код в заголовок и/или футер, в котором URL-адрес сниппета является ссылкой на страницу, которую вы хотите добавить:

<ch:snippet url="/articles/#!My-project/snippet-footer"/>

Контент страницы будет добавлен в заголовок/футер в виде сниппета со ссылкой на созданную вами страницу. Таким образом вы сможете визуально изменить заголовок и футер, отредактировав раздел Заголовок/Футер в редакторе страниц.

Для этого можно использовать переменные. Контент заголовка и футера становится частью разметки страницы при публикации и обрабатывается как обычная разметка страницы, поэтому в нем можно использовать как проектные, так и глобальные переменные. Просто откройте Шаблон страницы и добавьте следующий код в заголовок и/или футер:

<div>
  © <ch:var name="companyName" projectId="29"/>. All rights reserved.
  <br/>
  <a id="lnkFeedback" href="mailto:support@mycompany.com">Send feedback</a> on this topic to <ch:var name="companyName" projectId="29"/>.
  <script type="text/javascript">
    if (window['initFooter']) {
      initFooter();
    }
  </script>
</div>

Откройте Шаблон страницы и добавьте следующий код в верхний и/или нижний колонтитулы:

Вы также можете централизованно настроить навигационный элемент «Хлебные крошки» с помощью CSS-класса ChBreadcrumb в стилях проекта или с помощью встроенного CSS-файла:

Вот результат — серая линия для контейнера «Хлебных крошек»:

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

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

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

Если вы хотите видеть определенный контент только в документах с условным тегом PrintedDoc, вы можете использовать включающий блок таким же образом:

<ch:exclude tags="PrintedDoc">
  <ch:snippet url="/articles/#!My-project/snippet-footer"/>
</ch:exclude>

Ответ: Чтобы удалить его, нажмите Настройки → Внешний вид → Читательский интерфейс и снимите галочку в чекбоксе Показывать заголовок. Обратите внимание, что изменения касаются только пользовательского читательского интерфейса, поэтому вам нужно будет выйти из системы или открыть портал в режиме инкогнито/закрытого просмотра, чтобы увидеть результат.

Можно создать специальный элемент-оболочку DIV вокруг контента страницы и управлять полями с помощью стилей этого контейнера. Для этого откройте тег div в заголовке Шаблона страницы и закройте его в футере Шаблона страницы, как показано на скриншоте ниже.

Публикации имеют собственные настройки заголовка и футера, на которые не влияют глобальные настройки. При публикации проекта публикация получает «снимок» (снэпшот) или копию текущих настроек заголовка и футера, примененных к контенту каждой страницы. После создания публикации заголовки и футеры становятся частью контента страниц публикации, поэтому после этого их нельзя обновлять централизованно. Чтобы обновить заголовки и футеры в публикации, вам следует повторно опубликовать проект в режиме обновления. Если вы повторно опубликуете документ в режиме Частичного обновления, вы добавите новые статьи с новыми верхними и нижними колонтитулами, но не обновите старые.

Контент заголовка и футера добавляется до/после контента страницы, поэтому он обрабатывается так же, как и обычный контент страницы, и может содержать любые динамические элементы (сниппеты, переменные, условные блоки и т.д.), которые могут содержаться на странице. Для вновь созданной публикации снимается галочка в чекбоксе Использовать глобальные настройки, настройки заголовка и футера удаляются в настройках Шаблона страницы.