docs: add project README files
Add English and Russian README documentation for the Kyocera GDI driver package.
This commit is contained in:
user
@@ -0,0 +1,104 @@
|
|||||||
|
# kyocera-fs-1x2x-mfp-gdi
|
||||||
|
|
||||||
|
Kyocera GDI printer driver package for Arch Linux and CUPS.
|
||||||
|
|
||||||
|
This project packages the Linux GDI driver files for a group of legacy Kyocera FS-1xxx printers and installs them in the standard CUPS locations. The package is distributed as an Arch Linux `PKGBUILD`.
|
||||||
|
|
||||||
|
## Supported printers
|
||||||
|
|
||||||
|
The package currently installs PPD files for:
|
||||||
|
|
||||||
|
- Kyocera FS-1020MFP
|
||||||
|
- Kyocera FS-1025MFP
|
||||||
|
- Kyocera FS-1040
|
||||||
|
- Kyocera FS-1060DN
|
||||||
|
- Kyocera FS-1120MFP
|
||||||
|
- Kyocera FS-1125MFP
|
||||||
|
|
||||||
|
All of these models use the bundled `rastertokpsl` CUPS filter.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- Arch Linux or another Arch-compatible environment with `makepkg`
|
||||||
|
- `cups`
|
||||||
|
- `x86_64`
|
||||||
|
|
||||||
|
The package declares `cups` as a runtime dependency and is built for `x86_64`.
|
||||||
|
|
||||||
|
## Build and install
|
||||||
|
|
||||||
|
Clone the repository, then build the package with `makepkg`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone <repository-url>
|
||||||
|
cd kyocera-fs-1x2x-mfp-gdi
|
||||||
|
makepkg -si
|
||||||
|
```
|
||||||
|
|
||||||
|
After installation, restart CUPS if necessary:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo systemctl restart cups
|
||||||
|
```
|
||||||
|
|
||||||
|
The installed PPD files are placed under:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/usr/share/cups/model/Kyocera/
|
||||||
|
```
|
||||||
|
|
||||||
|
The CUPS filter is installed as:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/usr/lib/cups/filter/rastertokpsl
|
||||||
|
```
|
||||||
|
|
||||||
|
## Printer setup
|
||||||
|
|
||||||
|
Add the printer through your desktop's printer settings or through the CUPS web interface at `http://localhost:631/`.
|
||||||
|
|
||||||
|
When selecting a driver manually, use the PPD matching the exact printer model, for example:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/usr/share/cups/model/Kyocera/Kyocera_FS-1040GDI.ppd
|
||||||
|
```
|
||||||
|
|
||||||
|
## Package details
|
||||||
|
|
||||||
|
Current package version:
|
||||||
|
|
||||||
|
```text
|
||||||
|
1.1203-1
|
||||||
|
```
|
||||||
|
|
||||||
|
The PKGBUILD fetches the driver archive from Kyocera Document Solutions and extracts the Russian 64-bit driver payload before installing the required PPD files and `rastertokpsl` filter.
|
||||||
|
|
||||||
|
Upstream archive:
|
||||||
|
|
||||||
|
```text
|
||||||
|
https://www.kyoceradocumentsolutions.ru/content/dam/download-center-cf/ru/drivers/all/LinuxDrv_1_1203_FS_1x2xMFP_zip.download.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
## Files installed
|
||||||
|
|
||||||
|
```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
|
||||||
|
```
|
||||||
|
|
||||||
|
## Licensing
|
||||||
|
|
||||||
|
The repository's packaging metadata is dedicated to the public under **CC0-1.0**. See [`LICENSES/CC0-1.0.txt`](LICENSES/CC0-1.0.txt) and [`PKGBUILD.license`](PKGBUILD.license).
|
||||||
|
|
||||||
|
This does not change the copyright or licensing terms of the Kyocera driver files obtained from the upstream archive. The upstream driver components remain subject to their respective terms.
|
||||||
|
|
||||||
|
## Source and attribution
|
||||||
|
|
||||||
|
The packaged driver originates from Kyocera Document Solutions. This repository provides the Arch Linux packaging needed to install the legacy Linux GDI driver through CUPS.
|
||||||
@@ -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.
|
||||||
Reference in New Issue
Block a user