blob: 0a63e3fa971d15910be7b6ea9dc1c465e5d691c7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
<?php
/**
* PHPTAL templating engine
*
* PHP Version 5
*
* @category HTML
* @package PHPTAL
* @author Laurent Bedubourg <lbedubourg@motion-twin.com>
* @author Kornel Lesiński <kornel@aardvarkmedia.co.uk>
* @license http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public License
* @version SVN: $Id$
* @link http://phptal.org/
*/
/**
* @package PHPTAL
*/
interface PHPTAL_TranslationService
{
/**
* Set the target language for translations.
*
* When set to '' no translation will be done.
*
* You can specify a list of possible language for exemple :
*
* setLanguage('fr_FR', 'fr_FR@euro')
*
* @return string - chosen language
*/
function setLanguage(/*...*/);
/**
* PHPTAL will inform translation service what encoding page uses.
* Output of translate() must be in this encoding.
*/
function setEncoding($encoding);
/**
* Set the domain to use for translations (if different parts of application are translated in different files. This is not for language selection).
*/
function useDomain($domain);
/**
* Set XHTML-escaped value of a variable used in translation key.
*
* You should use it to replace all ${key}s with values in translated strings.
*
* @param string $key - name of the variable
* @param string $value_escaped - XHTML markup
*/
function setVar($key, $value_escaped);
/**
* Translate a gettext key and interpolate variables.
*
* @param string $key - translation key, e.g. "hello ${username}!"
* @param string $htmlescape - if true, you should HTML-escape translated string. You should never HTML-escape interpolated variables.
*/
function translate($key, $htmlescape=true);
}
|
