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

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

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

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

Да. Стили контента можно задать либо из 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;
}

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

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

/* 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;
}

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

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

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

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

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

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

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

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

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

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

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

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

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