comparison Lib/IMPL/Resources/Strings.pm @ 66:f47f93534005

Documentation
author wizard
date Thu, 18 Mar 2010 17:58:33 +0300
parents 521c9c1a3ea1
children 4267a2ac3d46
comparison
equal deleted inserted replaced
65:2840c4c85db8 66:f47f93534005
73 use base qw(IMPL::Object); 73 use base qw(IMPL::Object);
74 74
75 sub get { 75 sub get {
76 my ($this,$msg_name) = @_; 76 my ($this,$msg_name) = @_;
77 } 77 }
78
78 1; 79 1;
79 80
80 __END__ 81 __END__
81 82
82 =pod 83 =pod
83 84
85 =head1 NAME
86
87 C<IMPL::Resources::Strings> - Строковые ресурсы
88
84 =head1 SYNOPSIS 89 =head1 SYNOPSIS
90
91 =begin code
85 92
86 package Foo; 93 package Foo;
87 94
88 use IMPL::Resources::Strings { 95 use IMPL::Resources::Strings {
89 msg_say_hello => "Hello, %name!", 96 msg_say_hello => "Hello, %name!",
95 102
96 print msg_say_hello(name => $uname); 103 print msg_say_hello(name => $uname);
97 104
98 } 105 }
99 106
107 =end code
108
109 =head1 DESCRIPTION
110
111 Импортирует в целевой модуль функции, которые возвращают локализованные
112 параметризованные сообщения.
113
114 При импорте ищутся модули по следующему алгоритму:
115
116 В каталогах из массива C<@Locations> ищется файл с относительным путем
117 C<$Base/$Locale/$ModName>, где C<$Base>, C<$Locale> - глобальные переменные
118 модуля C<IMPL::Resourses::Strings>, а переменная C<$ModName> получена
119 путем замены 'C<::>' в имени целевого модуля на 'C</>'.
120
121 Если файл не был найден, то производится поиск в каталоге, где
122 расположен сам модуль, файла с относительным путем C<locale/$Locale/$ShortModName>,
123 где C<$ShortModeName> - последняя часть после 'C<::>' из имени целевого модуля.
124
125 Если файл не найден, то используются строки, указанные при объявлении
126 сообщений в целевом модуле.
127
128 =head1 FORMAT
129
130 =begin code text
131
132 msg_name = any text with named %params%
133 msg_hello = hello, %name%!!!
134 msg_resolve = this is a value of the property: %user.age%
135
136 msg_short_err = %error.Message%
137 msg_full_err = %error%
138
139 =end code text
140
100 =cut 141 =cut