23 lines
1.7 KiB
Markdown
23 lines
1.7 KiB
Markdown
|
Для разработки и проверки документации можно использовать команды
|
|||
|
|
* mkdocs serve (с созданием pdf файлов)
|
|||
|
|
* mkdocs serve -f dev.yml (без создания pdf файлов)
|
|||
|
|
* mkdocs build -f admin-manuals.yml (с созданием pdf файла с инструкциями для администратора)
|
|||
|
|
|
|||
|
|
Перед запуском надо установить mkdocs и его расширения. Сделать это можно при помощи команды, запущенной в папке mkdocs
|
|||
|
|
```
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Чтобы включить увеличение изображения, необходимо добавить {: .zoom}. Если не работает (а это происходит при работе плагина img2fig), то использовать html-вариант. Автоматический конвертер первого варианта во второй (zoom.py) есть в bitedo-doc и документации ERP.
|
|||
|
|
```
|
|||
|
|
а) {: .zoom}
|
|||
|
|
б) <img alt="Рис 1" src="examplel.png" class="zoom"/>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
В случае ошибки **no library called "cairo" was found** необходимо скачать библиотеки:
|
|||
|
|
|
|||
|
|
https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer
|
|||
|
|
|
|||
|
|
https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
|
|||
|
|
|
|||
|
|
Если при запуске команды **mkdocs serve -f dev.yml** появляется ошибка что данная команда не определена, то в переменнах средах укажите путь: **C:\Users\User\AppData\Roaming\Python\Python310\Scripts**
|