docs: add project README files

Add English and Russian README documentation for the Kyocera GDI driver package.
2026-09-23 23:29:59 +04:00
parent 6815082bfa
commit 1be2b5c771
2 changed files with 203 additions and 0 deletions
@@ -0,0 +1,99 @@
+# kyocera-fs-1x2x-mfp-gdi
+
+Пакет GDI-драйвера принтеров Kyocera для Arch Linux и CUPS.
+
+Проект содержит Arch Linux `PKGBUILD`, который загружает оригинальный Linux GDI-драйвер Kyocera для ряда устаревших принтеров серии FS-1xxx и устанавливает необходимые файлы в стандартные каталоги CUPS.
+
+### Поддерживаемые принтеры
+
+В пакет входят PPD-файлы для следующих моделей:
+
+- Kyocera FS-1020MFP
+- Kyocera FS-1025MFP
+- Kyocera FS-1040
+- Kyocera FS-1060DN
+- Kyocera FS-1120MFP
+- Kyocera FS-1125MFP
+
+Для поддерживаемых моделей используется входящий в драйвер фильтр CUPS `rastertokpsl`.
+
+### Требования
+
+- Arch Linux или совместимая система с `makepkg`
+- `cups`
+- архитектура `x86_64`
+
+`cups` указан в качестве зависимости пакета, сборка рассчитана на `x86_64`.
+
+### Сборка и установка
+
+Склонируйте репозиторий и соберите пакет с помощью `makepkg`:
+
+```bash
+git clone <repository-url>
+cd kyocera-fs-1x2x-mfp-gdi
+makepkg -si
+```
+
+При необходимости перезапустите CUPS:
+
+```bash
+sudo systemctl restart cups
+```
+
+После установки файлы размещаются в следующих каталогах:
+
+```text
+/usr/share/cups/model/Kyocera/
+/usr/lib/cups/filter/rastertokpsl
+```
+
+### Настройка принтера
+
+Добавьте принтер через настройки печати рабочего окружения или через веб-интерфейс CUPS: `http://localhost:631/`.
+
+При ручном выборе драйвера укажите PPD-файл, соответствующий точной модели принтера. Например:
+
+```text
+/usr/share/cups/model/Kyocera/Kyocera_FS-1040GDI.ppd
+```
+
+### Информация о пакете
+
+Текущая версия пакета:
+
+```text
+1.1203-1
+```
+
+`PKGBUILD` загружает архив Linux-драйвера с сайта Kyocera Document Solutions, извлекает 64-битную русскую версию драйвера и устанавливает необходимые PPD-файлы и фильтр `rastertokpsl`.
+
+Архив исходного драйвера:
+
+```text
+https://www.kyoceradocumentsolutions.ru/content/dam/download-center-cf/ru/drivers/all/LinuxDrv_1_1203_FS_1x2xMFP_zip.download.zip
+```
+
+### Установленные файлы
+
+```text
+/usr/share/cups/model/Kyocera/
+├── Kyocera_FS-1020MFPGDI.ppd
+├── Kyocera_FS-1025MFPGDI.ppd
+├── Kyocera_FS-1040GDI.ppd
+├── Kyocera_FS-1060DNGDI.ppd
+├── Kyocera_FS-1120MFPGDI.ppd
+└── Kyocera_FS-1125MFPGDI.ppd
+
+/usr/lib/cups/filter/rastertokpsl
+```
+
+### Лицензирование
+
+Метаданные упаковки этого репозитория посвящены общественному достоянию по лицензии **CC0-1.0**. См. [`LICENSES/CC0-1.0.txt`](LICENSES/CC0-1.0.txt) и [`PKGBUILD.license`](PKGBUILD.license).
+
+Это не изменяет условия авторских прав и лицензирования файлов драйвера Kyocera, полученных из исходного архива. Компоненты оригинального драйвера продолжают распространяться на условиях, применимых к ним.
+
+### Источник
+
+Исходный драйвер предоставлен Kyocera Document Solutions. Этот репозиторий содержит Arch Linux-упаковку, необходимую для установки устаревшего Linux GDI-драйвера через CUPS.