Изменить расположение пользовательской документации
При обращении к документации из программ Windows-клиент и Web-клиент, пользователь по умолчанию направлен на сайт компании ДоксВижн.
При необходимости администратор может разместить документы на ресурсах своей организации. Для этого необходимо изменить шаблон, по которому определяется расположение документации в программе Консоль настройки Docsvision.
![Настройка расположения документации](../../admin/_images/help-url.png)
Шаблоны расположения документации
-
{client}
— псевдоним клиентской программы, который может приобретать значения:-
winclient
— для Windows-клиента. -
webclient
— для Web-клиента.Другие клиентские приложения не поддерживают настройку, определяющую расположение документации.
-
-
{version}
— версия клиентской программы.
Таким образом фактический стандартный адрес документации, к примеру, для модуля Платформа версии 5.5.5 будет следующим: http://help.docsvision.com/platform/5.5.5/
.
Для всех клиентских программ используется общий шаблон, поэтому размещать документацию Windows-клиента и Web-клиента следует на одном сайте. |
Изменение расположения документации
Новая документация Docsvision разворачивается с помощью генератора статических сайтов Antora.
Для первой сборки сайта потребуется подключение к интернету, в будущем интернет-соединение опционально и потребуется только для получения последних изменений в документации.
Сборка сайта
-
Перейдите по ссылке, скачайте и установите git.
-
Установите Node.js предпочтительным способом или скачайте инсталлятор с официального сайта.
-
Скопируйте на компьютер данный (Docsvision/antora-playbook) репозиторий.
-
Выполните в Powershell:
git clone https://github.com/Docsvision/antora-playbook.git
-
-
Перейдите в каталог репозитория:
cd antora-playbook
-
Установите Antora командой:
npm i
-
Откройте файл
/antora-playbook/antora-playbook.yml
в любом текстовом редакторе и при необходимости отредактируйте URL сайта:site: title: Документация Docsvision url: https://help.docsvision.com/ (1) robots: allow
1 Укажите адрес сервера, на котором будет развёрнута документация. -
Запустите сборку сайта при помощи Antora, выполнив следующую команду в окне Powershell:
npx antora antora-playbook.yml
-
Файлы сайта будут расположены в папке
wwwroot
.
Просмотр сайта
-
Локально — нажмите на сгенерированные html-файлы, расположенные в папке
wwwroot
. -
С простого http-сервера — выполните шаги ниже.
-
Перейдите в папку репозитория
antora-playbook
. -
Установите локальный http-сервер следующей командой:
antora-playbook $ npm i -g http-server
-
Выполните команду
http-server
, например, так:antora-playbook\wwwroot $ http-server build/site -c-1 -p 5000
-
После запуска команды, локальный адрес веб-сервера будет отображён в окне консоли следующим образом:
Starting up http-server, serving antora-playbook\wwwroot Available on: http://127.0.0.1:5000 http://192.168.1.8:5000 Hit CTRL-C to stop the server
-
Вставьте любой адрес из списка в строку браузера, что просмотреть сайт через локальный веб-сервер.
Ограничения
В собранном сайте не будет работать поиск. Чтобы воспользоваться функциями локального (офлайн) поиска, рекомендуется использовать расширение Antora Lunr Search. Подробная инструкция по разворачиванию приведена по ссылке.
Перед использованием расширения Antora Lunr Search рекомендуется удалить папку antora-playbook/supplemental-ui
.