PHPackages                             nigo/doc-translator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. nigo/doc-translator

ActivePackage[PDF & Document Generation](/categories/documents)

nigo/doc-translator
===================

Пакет для создания документов с переводом

0.0.3(2y ago)05MITPHPPHP >=8

Since Dec 18Pushed 2y ago1 watchersCompare

[ Source](https://github.com/golubtsov/doc-translator)[ Packagist](https://packagist.org/packages/nigo/doc-translator)[ RSS](/packages/nigo-doc-translator/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (3)Versions (4)Used By (0)

Пакет для создания документов с переводом
=========================================

[](#пакет-для-создания-документов-с-переводом)

Содержание
----------

[](#содержание)

- [Установка](#install)
- [SimpleDocument](#simple-document)
- [LibreTranslator](#libr-translator)
- [Fb2ParallelDocumentGenerator](#fb2-parallel)
- [SimpleFB2](#simple-fb2)

Установка
---------

[](#установка)

```
composer require nigo/doc-translator

```

Класс `SimpleDocument`
----------------------

[](#класс-simpledocument)

```
$generator = new SimpleDocument('lang', 'path_to_save');
```

Класс `Fb2ParallelDocumentGenerator` принимает два параметра при создании: язык и путь к папке, куда будет сохранятся файл.

### generateByFile()

[](#generatebyfile)

Метод принимает файл, который нужно перевести, и название файла, которое будет у перевода, и возвращает `false`, если файл не создался, или размер файла

```
$generator->generateByFile('file_for_translate', 'filename');
```

### generate()

[](#generate)

Метод принимает текст, который нужно перевести, и название файла, которое будет у перевода, и возвращает `false`, если файл не создался, или размер файла

```
$generator->generate('text', 'filename');
```

ВСЕ ПРИМЕРЫ РАБОТАЮТ С КЛАССОМ LibreTranslator, КОТОРЫЙ ОСНОВАН НА API ИЗ ЭТОГО [РЕПОЗИТОРИЯ](https://github.com/LibreTranslate/LibreTranslate).
------------------------------------------------------------------------------------------------------------------------------------------------

[](#все-примеры-работают-с-классом-libretranslator-который-основан-на-api-из-этого-репозитория)

### setNewTranslator()

[](#setnewtranslator)

Класс `Fb2ParallelDocumentGenerator` в конструкторе создает переводчик.

```
$this->translator = new LibreTranslator();
```

Для изменения переводчика можно использовать следующий метод

```
public function setNewTranslator(TranslatorAbstract $translator): void
{
    $this->translator = $translator;
}
```

В проекте реализован класс `LibreTranslator`, который работает на основе API из этого [репозитория](https://github.com/LibreTranslate/LibreTranslate).

Чтобы создать свою реализацию переводчика, нужно создать класс, который будет занаследован от

```
abstract class TranslatorAbstract
{

}
```

далее нужно будет создать свою реализацию метода `translate()`.

Иногда API может присылать не то, что мы хотим (LibreTranslator иногда не переводит имена, названия каких-либо мест и т.п. и возвращает ответ, где указывается, что язык выбран неправильно), и для более удобной отладки, ответы, которые не имеют статус `200`, могут записываться в файл `./storage/logs/day_moth_year.txt`, для этого при создании переводчика нужно передать `true` в параметр `logState`.

```
new LibreTranslator(true);
```

Изменить состояние для логов можно с помощью метода

```
public function setLogState(bool $state): void
{
    $this->logState = $state;
}
```

Или из класса `Fb2ParallelDocumentGenerator`

```
public function setLogStateForTranslator(bool $state): void
{
    $this->translator = new LibreTranslator($state);
}
```

Класс `Fb2ParallelDocumentGenerator`
------------------------------------

[](#класс-fb2paralleldocumentgenerator)

Работает аналогично классу `SimpleDocument`, но создает документ в формате FB2 с параллельным переводом.

```
$generator = new Fb2ParallelDocumentGenerator('lang', 'path_to_save');
$generator->generateByFile('path_to_file', 'filename');
```

Перевод
-------

[](#перевод)

[![Текст описания](./doc/images/translated_text.png)](./doc/images/translated_text.png)

Тестовые тексты для перевода берутся из `./storage/test_doc/`.
One\_Day-Helen\_Naylor.txt - большой текст и text.txt - маленький текст.

Класс `SimpleFB2`
-----------------

[](#класс-simplefb2)

Класс создает файл FB2 формата без перевода.

```
$document = new SimpleFB2('path_to_save');
$document->generateByFile('path_to_file', 'filename');
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~17 days

Total

3

Last Release

894d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/113918304?v=4)[ngolubtsov](/maintainers/ngolubtsov)[@ngolubtsov](https://github.com/ngolubtsov)

### Embed Badge

![Health badge](/badges/nigo-doc-translator/health.svg)

```
[![Health](https://phpackages.com/badges/nigo-doc-translator/health.svg)](https://phpackages.com/packages/nigo-doc-translator)
```

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[kimai/kimai

Kimai - Time Tracking

4.8k9.0k1](/packages/kimai-kimai)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k17.8k](/packages/prestashop-prestashop)[jason-munro/cypht

Lightweight Open Source webmail written in PHP and JavaScript

1.6k157.9k](/packages/jason-munro-cypht)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)