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