gettext-latte

KO | EN

gitlite — search

#javascript #typescript #golang #android #deep-learning #docker #macos #nodejs #windows #cli #awesome-list #security #mcp #open-source

(★ 14)

Translator supported native gettext

gettext-latte Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Abandoned]

GettextLatte
============

[![Build Status](https://travis-ci.org/h4kuna/gettext-latte.svg?branch=master)](https://travis-ci.org/h4kuna/gettext-latte)
[![Latest stable](https://img.shields.io/packagist/v/h4kuna/gettext-latte.svg)](https://packagist.org/packages/h4kuna/gettext-latte)

is localization addon for [Nette framework 2.3](http://nette.org/), which natively supports [gettext](http://php.net/manual/en/book.gettext.php).

Conditions for start-up
----------------------
* gettext extension enabled
* language installed on server, you can check by using command **$ locale -a**
* your application written in UTF-8 encoding

In the repository is directory **locale** containing prepared directory structure for your project. In folder **example** are files, whose help you setup this translator. You can write your application in your native language, here is example in english, but it may be czech, slovak, german language...

Start-up
---------------------
Clone this repository or use composer.
```sh
composer require h4kuna/gettext-latte
```

Router keep language.
```php
/**
 * @return Nette\Application\IRouter
 */
public static function createRouter(\h4kuna\Gettext\GettextSetup $translator) {
    $router = new RouteList();
    $router[] = new Route('index.php', 'Homepage:default', Route::ONE_WAY);
    $router[] = new Route('[<lang ' . $translator->routerAccept() . '>/]<presenter>/<action>/[<id>/]', array(
        'presenter' => 'Homepage',
        'action' => 'default',
        'lang' => $translator->getDefault()
    ));

return $router;
}
```

### examples/config.neon

On Mac encoding is represented as 'en_US.UTF-8' everytime dojo format 'en_US.utf8'.
```
extensions:
    gettextLatteExtension: h4kuna\Gettext\DI\GettextLatteExtension

gettextLatteExtension:
    langs:
        cs: cs_CZ.utf8
        sk: sk_SK.utf8
        en: en_US.utf8
```

Install new macro to latte engine with alias for native gettext function [{_'' /*, ...*/}](http://www.php.net/manual/en/function.gettext.php) and [{_n'', '', '' /*, ...*/}](http://www.php.net/manual/en/function.ngettext.php) new is [{_d'catalog', 'message'}](http://www.php.net/manual/en/function.dgettext.php) and plural [{_dn'catalog', 'message' /*, ...*/}](http://www.php.net/manual/en/function.dgettext.php).

Run service and support automatic detection of language
-------------------
Load language as soon as possible.

```php
<?php
use Nette\Application\UI\Presenter;

abstract class BasePresenter extends Presenter {

/** @persistent */
    public $lang;

/** @var \h4kuna\Gettext\GettextSetup */
    protected $translator;

/**
     * Inject translator
     * @param \h4kuna\Gettext\GettextSetup
     */
    public function injectTranslator(\h4kuna\Gettext\GettextSetup $translator) {
        $this->translator = $translator;
    }

protected function startup() {
        parent::startup();
        $this->lang = $this->translator->setLanguage($this->lang);
    }
    
    /**
     * Or PHP 5.4+ ****************************************************************
     * *************************************************************************
     */
    use \h4kuna\Gettext\InjectTranslator;
}
```

After install translator please empty temp directory, otherwise you may get "Call to undefined method Nette\Templating\FileTemplate::translate()".

How to write texts in PHP files
---------------
Outside the template using gettext.

```php
<?php
echo gettext('Hi'); //or alias _
echo _('Hi');
echo ngettext('dog', 'dogs', 2);

echo sprintf(_('%s possible %s %s'), 'another', 'optional', 'params');

```

In template using macros. Number of parameters isn't limited. Function **sprintf** is automatically added. Look at examples/example.latte

<table>
<tr>
<th>macro in template</th><th>translate to php</th>
</tr>
<tr>
<td>{_'Hi'}</td><td>echo gettext('Hi');</td>
</tr>
<tr>
<td>{_'Today is %s', $date}</td><td>echo sprintf(gettext('Today is %s'), $date);</td>
</tr>
<tr>
<th colspan="2">In the previous version, the inflection was written like this.</th>
</tr>
<tr>
<td>{_n'dog', 'dogs', $count}</td><td>echo ngettext('dog', 'dogs', $count);</td>
</tr>
<tr>
<th colspan="2">Now it's off and is written following way.* (It is possible to turn on with third parameter in constructor.)</th>
</tr>
<tr>
<td>{_n'dog', $count}</td><td>echo ngettext('dog', 'dog', $count);</td>
</tr>
<tr>
<td>{_n'%s dog has email %s', $count, $email}</td><td>echo sprintf(ngettext('%s dog has email %s', '%s dog has email %s', $count), $count, $email);</td>
</tr>
<tr>
<th colspan="2">If you need to decline to negative, variable must contain abs.</th>
</tr>
<tr>
<td>{_n'today is %s degree temperature', $absTemperature}</td><td>echo sprintf(ngettext('today is %s degree temperature', 'today is %s degree temperature', abs($absTemperature)), $absTemperature);</td>
</tr>
<tr>
<th colspan="2">If you have many variables and replace the first variable not governed translation variable must contain plural.</th>
</tr>
<tr>
<td>{_n'Name: %s, age: %s year old', $name, $pluralYear}</td><td>echo sprintf(ngettext('Name: %s, age: %s year old', 'Name: %s, age: %s year old', $pluralYear), $name, $pluralYear);</td>
</tr>
</table>

\* It was changed, because inflection is defined in catalog everytime, for language whose has more than 2 level inflection.

Let's start translate
---------------------
Download [PoEdit](http://www.poedit.net/download.php).
Before each Poedit run you must have all templates compiled to php in temp directory, for this is use script like **examples/latte-compiler**.

Open the **.po** file. Setup directory search - by default it is **temp/cache/latte** and **app**  and click "update catalog", after update catalog you don't need [restart apache](http://php.net/manual/en/function.gettext.php#110735).

If you write application in language with three inflection levels instead of two, for example czech, you must have catalog with translation czech to czech but only for plural.

Downloadable catalog
---------------
For your translators you provide catalog for download.

```php
$this->translator->download('cs'); //Offers catalog download
```

Run Tests
---------
Composer must be instaled. And than you execute only script.
```sh
./tests/run-tests.sh
```

gettext-latte

gettext-latte Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gettext-latte

gettext-latte Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README