LuaBill · Разделы документации

Установка и обновление

Сама форма и инструменты создания документов устанавливаются отдельно. Полный дистрибутив LaTeX не включается в пакет LuaBill.

Windows: готовый установщик

Запустите LuaBill-Setup-0.1.31-win64.exe. Установка предназначена для Windows 10 версии 1809 и новее или Windows 11, x64, и выполняется для текущего пользователя. Python, PySide6/Qt и Mustang уже включены.

При установке можно выбрать ярлык на рабочем столе и связь файлов .luabill с LuaBill. Запускайте программу через меню «Пуск», ярлык или открытие сохранённого проекта.

Скачать установщик Windows →

Linux и macOS: установка из исходников

Распакуйте весь архив. В Linux выполните sh install.sh; в macOS откройте Install_LuaBill.command или запустите его через Terminal. Нужны Python 3.10–3.15 с venv и pip и доступ к Интернету для загрузки PySide6/Qt в частное окружение LuaBill.

Пакет macOS требует macOS 14.4 или новее. Для Linux нужны совместимая glibc и системные графические библиотеки Qt; точные требования приведены в README внутри архива. После установки создаются средства запуска приложения и открытия .luabill для текущего пользователя.

Эти пакеты собраны и проверены как архивы. Нативная установка и запуск на Linux и macOS в текущей среде Windows не выполнялись.

sh install.sh

sh Install_LuaBill.command

LuaLaTeX, шрифты, Java и Ghostscript

Откройте «Справка → Подготовить компоненты для создания документов». Мастер показывает найденные компоненты и необходимые действия для выбранного профиля. Официальные ссылки и повторная проверка также доступны в «Компоненты и установка».

LuaLaTeX предоставляет TeX Live, MiKTeX или MacTeX. Команда lualatex может сообщать о движке LuaHBTeX — это нормально, если запускается именно режим lualatex. Окончательная проверка пакетов и шрифтов — успешное создание тестового PDF.

Java 17+ запускает Mustang для проверки электронных счетов. Ghostscript сжимает обычные PDF при наличии и необходим для подготовки ZUGFeRD PDF/A-3.

Если создание документа завершилось ошибкой →

Обновление существующей установки

Закройте LuaBill и установите новую версию в прежнюю папку. Предварительно удалять исправную установку не требуется. Если в Linux или macOS использовался свой путь --prefix, укажите его снова.

Проекты, результаты и пользовательские настройки сохраняются. После обновления проверьте версию в окне «О LuaBill» и создайте документ нужного формата. Внешние компоненты TeX, Java и Ghostscript обновляются отдельно.

Изменения по версиям →

← Вернуться к документации

Что нужно для создания документов

Мастер подготавливает компоненты для выбранных форматов. Проверьте план и запустите подготовку кнопкой: простое открытие мастера или запуск LuaBill не начинает загрузки.

LuaLaTeX и texlua

Для формирования документов

Используйте один дистрибутив TeX с командами lualatex и texlua. В Windows мастер может установить Basic MiKTeX и подготовить 19 прямых пакетов шаблона, их зависимости и языковые данные EN/DE/FR/IT/RU. Подходящий установленный TeX используется повторно. Сообщение о версии LuaHBTeX нормально; команду lualatex заменять не нужно.

MiKTeX ↗TeX Live ↗MacTeX ↗

Ghostscript

Для ZUGFeRD; необязателен для обычного PDF

Ghostscript подготавливает PDF/A-3 для ZUGFeRD и может сжимать обычные PDF. Мастер добавляет его, когда это требуется профилю ZUGFeRD, либо использует подходящую установленную копию.

Официальная загрузка ↗

Java 17 или новее

Для электронных счетов

Совместимая Java 17+ запускает Mustang для проверки XML и упаковки/проверки ZUGFeRD. Для новой установки в Windows предлагается Temurin JRE 21; вариант с Homebrew в macOS использует Temurin 21 JDK. Обычный PDF не требует Java.

Eclipse Temurin ↗

Python и PySide6/Qt

Для настольного интерфейса

В Windows-пакете уже включены. Для Linux, macOS и ручной установки сначала установите совместимый Python; сценарий создаст отдельную среду и загрузит PySide6.

Python ↗Qt for Python ↗

Частные шрифты Noto для документов

Подготавливаются для всех пяти языков

Мастер загружает проверенный набор Noto Sans и Noto Sans Mono с исходной лицензией в пользовательскую папку LuaBill. Программа использует эти файлы напрямую, без регистрации шрифтов в операционной системе. Существующие системные шрифты остаются запасным вариантом.

Noto Fonts ↗DejaVu Fonts ↗

Полный TeX в установщик не входит. При первой подготовке могут загружаться инструменты TeX, пакеты, шрифты и необходимые для профиля Java/Ghostscript. Мастер проверяет все пять языков и создание тестового документа выбранного формата; обычный отчёт компонентов подтверждает только часть условий.

Компактный пакет и мастер настройки документов

В LuaBill 0.1.27 появился мастер подготовки на пяти языках. Подготовьте инструменты один раз, затем создавайте документы локально: включать полный LaTeX в установщик LuaBill не требуется.

Выберите нужные форматы
Откройте «Справка → Подготовить создание документов» или оставьте отмеченным запуск подготовки в конце установки Windows. Выберите PDF, XML/XRechnung или ZUGFeRD.
Проверьте найденные программы
Мастер находит подходящие TeX, Java и Ghostscript и показывает план подготовки. Нажмите «Подготовить выбранные компоненты», чтобы начать загрузки и установку.
Подготовьте пакеты и шрифты
В Windows можно начать с Basic MiKTeX. Мастер подготавливает 19 прямых пакетов LaTeX с зависимостями и пятью языками документов, а также частные файлы Noto Sans и Noto Sans Mono. Java и Ghostscript добавляются по выбранному профилю.
Создайте проверенный пример
Мастер компилирует отдельный тест LaTeX дважды и создаёт фиктивный счёт через выбранный путь генерации. После завершения откройте тестовый PDF. При ошибке можно открыть папку журналов или скопировать диагностику.

Компактный пакет и мастер настройки документов — LuaBill 0.1.31 · Пример документа

PDF

LuaLaTeX, texlua, пакеты шаблона и подходящие шрифты. Для формирования обычного PDF Java и Ghostscript не требуются.

PDF + XML / XRechnung

Компоненты PDF и Java 17+ для проверки XML с помощью Mustang. Для новой установки в Windows предлагается более компактная Temurin JRE 21.

ZUGFeRD

Компоненты PDF/XML и Ghostscript для подготовки PDF/A-3 со встроенным XML; полученный контейнер проходит проверку.

Пакет программы остаётся компактным, но недостающие инструменты требуют отдельных загрузок через Интернет. Все три профиля генерации успешно проверены в Windows с установленными компонентами. Полная подготовка чистого Windows-компьютера и нативная установка Linux/macOS ещё требуют отдельной проверки.

Скачать отдельный тест LaTeX ↓

Тест работает без LuaBill: выберите LuaLaTeX и выполните компиляцию дважды. Проверяются все 19 прямых пакетов, пять языков, формулы, значки, таблицы и шрифты. MiKTeX может дозагрузить пакеты при разрешённой установке «на лету»; вне мастера системные шрифты устанавливаются отдельно. Контрольные суммы SHA-256

Обновление, проверка компонентов и удаление

Устанавливайте текущий выпуск поверх существующей программы и проверяйте активные правила для счетов через меню «Справка». Семь редактируемых примеров с готовыми PDF включены в программу и доступны единым ZIP-архивом.

Устанавливайте новую версию поверх

Закройте LuaBill и запустите новый установщик в прежнюю папку. Удалять предыдущую версию перед обновлением не требуется.

В Windows сохраните прежнюю папку, которую предложит Setup.
В Linux/macOS укажите тот же --prefix, если выбирали нестандартную папку.
Проекты, результаты и настройки в пользовательских папках сохраняются.

Linuxsh install.sh

macOSsh Install_LuaBill.command

Ручные изменения файлов программы сохраните отдельно. При конфликте установщик Linux/macOS остановит обновление. После установки проверьте версии правил через «Справка → Стандарты электронных счетов и обновления». Устанавливать старую версию поверх новой не рекомендуется.

Подготовьте компоненты и проверьте пример

Откройте «Справка → Подготовить создание документов», выберите профиль, проверьте найденные инструменты и подготовьте недостающие компоненты.

В Windows Python/Qt включены. В Linux/macOS используется установленный Python, а Qt загружается в отдельную среду.
Для PDF нужны TeX и шрифты; для XML/XRechnung дополнительно Java 17+; для ZUGFeRD также Ghostscript.
Подготовка запускает отдельный тест LaTeX на пяти языках дважды, затем проверяет настоящий путь генерации и валидации выбранного профиля.

При открытии мастер только проверяет состояние. Кнопка «Подготовить выбранные компоненты» запускает загрузки и установку; также можно проверить существующую настройку. Журналы и тестовые PDF открываются из мастера.

Удаляйте файлы программы

Деинсталлятор из нового архива может удалить прежнюю установку без переустановки LuaBill.

Закройте LuaBill и укажите прежний --prefix для нестандартной папки.
Документы, настройки и изменённые или неизвестные файлы сохраняются.
Прочитайте итоговые предупреждения и список оставшихся файлов.

Linuxsh uninstall.sh

macOSsh Uninstall_LuaBill.command

Небольшой отдельный архив тоже удаляет уже установленную копию. Системные TeX, Java, Ghostscript и папка скачанного пакета сохраняются.

Отдельный деинсталлятор Linux/macOS ↓ ZIP · 23 KB

Контрольные суммы SHA-256

Руководство пользователя ↗