From 49508266c50546b0f42602d0f81621cece9fe95d Mon Sep 17 00:00:00 2001 From: freespace Date: Sat, 6 Nov 2004 11:05:22 +0000 Subject: [PATCH] Humbly added myself to the translators list in bookinfo.xml :) "Refactored" (rephrased, corrected and some WS fixed) files from ru root. --- docs/ru/bookinfo.xml | 5 +- docs/ru/getting-started.xml | 124 ++++++++++++++++++---------------- docs/ru/language-defs.ent | 2 +- docs/ru/language-snippets.ent | 32 ++++----- docs/ru/preface.xml | 4 +- 5 files changed, 89 insertions(+), 78 deletions(-) diff --git a/docs/ru/bookinfo.xml b/docs/ru/bookinfo.xml index 47cadb63..cd0f100f 100755 --- a/docs/ru/bookinfo.xml +++ b/docs/ru/bookinfo.xml @@ -1,6 +1,6 @@ - + Smarty - компилирующий обработчик шаблонов @@ -15,6 +15,9 @@ SergeiSuslenkov <student@bsuir-fcd.org> + + GeorgeMiroshnikov <freespace@php.net> + &build-date; diff --git a/docs/ru/getting-started.xml b/docs/ru/getting-started.xml index ea98d0f1..29631be2 100644 --- a/docs/ru/getting-started.xml +++ b/docs/ru/getting-started.xml @@ -58,7 +58,7 @@ - Он эффективен, так как PHP обработчик делает за него грязную работу. + Он эффективен, так как обработчик PHP делает за него грязную работу. @@ -88,7 +88,7 @@ Конструкции if/elseif/else/endif конструкции передаются обработчику PHP, - так что синтаксис {if ...} выражения может быть настолько простым или + так что синтаксис выражения {if ...} может быть настолько простым или сложным, насколько вам угодно. @@ -101,17 +101,17 @@ Существует возможность включения PHP-кода прямо в ваш шаблон, однако обычно в этом нет необходимости (и это не рекоммендуется), так как - движок весьма гибок в настройке. + движок весьма гибок и расширяем. - Встроенное кэширование. + Встроенный механизм кэширования. - Произвольные источники шаблона. + Произвольные источники шаблонов. @@ -133,15 +133,17 @@ Требования - Для установки и работы Smarty необходим веб-сервер с установленным PHP версии 4.0.6 или выше. + Для установки и работы Smarty необходим веб-сервер с установленным PHP + версии 4.0.6 или выше. Базовая установка - Скопируйте файлы Smarty, которые находятся в директории /libs/ дистрибутива. - Менять эти файлы НЕ СЛЕДУЕТ. Они должны использоваться всеми приложениями и изменяться - только при обновлении Smarty до новой версии. + Скопируйте файлы Smarty, которые находятся в директории /libs/ + дистрибутива. Редактировать эти файлы НЕ СЛЕДУЕТ. Они должны + использоваться всеми приложениями и изменяться только при обновлении + Smarty до новой версии. Файлы библиотеки Smarty @@ -157,17 +159,17 @@ debug.tpl - Smarty использует PHP константу SMARTY_DIR, которая указывает путь к директории библиотеки Smarty. Обычно, если приложение может найти файл Smarty.class.php, то нет необходимости устанавливать SMARTY_DIR. Однако, если Smarty.class.php не может - быть найден в вашем include_path или вы не указывали абсолютный путь к нему в - приложении, то вы должны определить SMARTY_DIR вручную. + быть найден в вашем include_path или вы не указывали абсолютный путь к + нему в приложении, то вы должны определить SMARTY_DIR вручную. SMARTY_DIR должен включать завершающий слэш. - Как следует инстанциировать объект Smarty в ваших PHP-скриптах: + Вот как следует создавать экземпляр объекта Smarty в ваших PHP-скриптах: Создание обекта Smarty @@ -184,7 +186,7 @@ $smarty = new Smarty; Попробуйте выполнить вышеуказанный код. Если Вы получаете ошибку о том, что Smarty.class.php не найден, попробуйте следующие - варианты: + варианты действий: @@ -204,8 +206,8 @@ $smarty = new Smarty; - + Установите значение константы SMARTY_DIR вручную templates, templates_c, configs и cache. Каждая из - них определяется свойствами класса Smarty: $template_dir, - $compile_dir, $config_dir, и - $cache_dir соответственно. Настойчиво рекомендуется - использовать разные наборы этих директорий для каждого приложения, - использующего Smarty. + них определяется свойствами класса Smarty: + $template_dir, $compile_dir, + $config_dir и $cache_dir + соответственно. Настойчиво рекомендуется использовать разные наборы + этих директорий для каждого приложения, использующего Smarty. - Убедитесь, что вы знаете значение DOCUMENT_ROOT вашего веб-сервера. - В нашем примере это "/web/www.mydomain.com/docs/". - Так как к файлам Smarty будут обращаться только скрипты, то вам - рекомендуется вынести директории Smarty за пределы - DOCUMENT_ROOT, чтобы избежать лишнего беспокойства относительно безопасности. + Убедитесь, что вы знаете расположение корневой директории для документов + вашего веб-сервера. В нашем примере это "/web/www.mydomain.com/docs/". + Так как доступ к директориям Smarty получает только библиотека Smarty + и они никогда не запрашиваются напрямую веб-браузером, вам рекомендуется + вынести директории Smarty за пределы корневой + директории для документов, чтобы избежать лишнего беспокойства + относительно безопасности. В нашем примере мы будем устанавливать Smarty для некоторой гостевой @@ -255,20 +259,21 @@ $smarty = new Smarty; "/web/www.mydomain.com/smarty/guestbook/". - Вам понадобится как минимум один файл в корне веб-директории - это скрипт, - к которому обращается веб-браузер. Мы назовём наш скрипт "index.php" - и поместим его в поддиректорию "/guestbook" корневой веб-директории. + Вам понадобится как минимум один файл в корневой директории для документов + - это скрипт, к которому обращается веб-браузер. Мы назовём наш скрипт + "index.php" и поместим его в поддиректорию "/guestbook/" корневой директории + для документов. - Техническое замечание Бывает удобно настроить веб-сервер так, чтобы "index.php" расценивался как индексный файл дирекотрии по умолчанию, чтобы при запросе страницы "http://www.mydomain.com/guestbook/", вызывался скрипт index.php без - "index.php" в конце URL'а. В веб-сервере Apache вы можете настроить это добавив - "index.php" в конец директивы DirectoryIndex (записи разделяются пробелами). + "index.php" в конце адресной строки. В веб-сервере Apache вы можете + настроить это, добавив "index.php" в конец директивы DirectoryIndex + (записи разделяются пробелами). @@ -299,11 +304,12 @@ $smarty = new Smarty; Smarty понадобятся права на запись в $compile_dir и - $cache_dir, так что убедитесь, что у веб-сервера есть эти права. - Обычно он запущен под именем пользователя "nobody" группы "nobody". Для пользователей OS X - пользователем по умолчанию является "www" группы "www". Если вы используете Apache, вы можете - заглянуть в ваш файл httpd.conf (который обычно расположен в "/usr/local/apache/conf/") чтобы - узнать, какие используются имя пользователя и группа. + $cache_dir, так что убедитесь, что у веб-сервера + есть эти права. Обычно сервер запущен от имени пользователя "nobody" группы + "nobody". Для пользователей OS X пользователем по умолчанию является "www" + группы "www". Если вы используете Apache, вы можете заглянуть в ваш файл + httpd.conf (который обычно расположен в "/usr/local/apache/conf/") чтобы + узнать, какой пользователь и группа используются. @@ -322,10 +328,10 @@ chmod 770 /web/www.mydomain.com/smarty/guestbook/cache/ Техническое замечание - chmod 770 даёт достаточно жесткую защиту - только пользователь "nobody" и группа - "nobody" имеют доступ на запись и чтение к директориям. Если вы хотите открыть доступ на чтение - для всех (обычно для собственного удобства при просмотре этих файлов), - вы можете использовать маску 775. + chmod 770 даёт достаточно жесткую защиту - разрешает только пользователю + "nobody" и группе "nobody" доступ на чтение и запись в эти директории. + Если вы хотите открыть доступ на чтение для всех (обычно для собственного + удобства при просмотре этих файлов), вы можете использовать значение 775. @@ -358,10 +364,11 @@ Hello, {$name}! - Теперь давайте отредактируем index.php. Мы создадим экземпляр Smarty, присвоим - значение переменной шаблона и отобразим файл index.tpl. В окружении нашего примера - мы поместили "/usr/local/lib/php/Smarty" в include_path. Убедитесь, что вы сделали - то же самое или используете абсолютные пути. + Теперь давайте отредактируем index.php. Мы создадим экземпляр Smarty, + присвоим значение переменной шаблона и отобразим файл index.tpl. + В условиях нашего примера, мы поместили "/usr/local/lib/php/Smarty" в + include_path. Убедитесь, что вы сделали то же самое или используете + абсолютные пути. @@ -391,11 +398,11 @@ $smarty->display('index.tpl'); Техническое замечание - В нашем примере, мы устанавливаем абсолютные пути ко всем директориям + В нашем примере мы устанавливаем абсолютные пути ко всем директориям Smarty. Если '/web/www.mydomain.com/smarty/guestbook/' находится в include_path вашего PHP, то эти настройки не обязательны. Тем не менее, более эффективным и (из опыта) менее глюкоопасным является использование - абсолютных путей. Это даст вам уверенность в том, что Smarty получает файлы + абсолютных путей. Это придаст уверенность в том, что Smarty получает файлы из тех директорий, из которых вы хотите. @@ -417,13 +424,14 @@ $smarty->display('index.tpl'); сперва прочитайте её. - Немного более гибким способом установки Smarty является наследование класса и - инициализация вашего собственного окружения Smarty. Таким образом, вместо того, чтобы - постоянно устанавливать пути директорий, присваивать одни и те же переменные и т.д. - мы можем всё это сделать в одном месте. - Давайте создадим новую директорию "/php/includes/guestbook/", а в ней - новый файл, - который назовем "setup.php". В окружении из нашего примера "/php/includes" находится - в include_path. Проверьте, что бы то же самое было и у вас, или используетй абсолютные пути. + Немного более гибким способом установки Smarty является наследование класса + и инициализация вашего собственного окружения Smarty. Таким образом, вместо + того, чтобы постоянно устанавливать пути директорий, присваивать одни и те + же переменные и т.д., мы можем всё это сделать в одном месте. + Давайте создадим новую директорию "/php/includes/guestbook/",а в ней - + новый файл, который назовем "setup.php". По условиям нашего примера, + "/php/includes" находится в include_path. Убедитесь, чтобы то же самое было + и у вас, или используетй абсолютные пути. @@ -436,8 +444,8 @@ $smarty->display('index.tpl'); require('Smarty.class.php'); // Файл setup.php - это хорошее место для -// подключения библиотечных файлов вашего приложения, вы можете -// сделать это прямо здесь. Пример: +// подключения библиотечных файлов вашего приложения, +// вы можете сделать это прямо здесь. Пример: // require('guestbook/guestbook.lib.php'); class Smarty_GuestBook extends Smarty { @@ -465,7 +473,7 @@ class Smarty_GuestBook extends Smarty { - Теперь давайте изменим index.php для использования setup.php: + Теперь давайте изменим index.php, чтобы он использовал setup.php: diff --git a/docs/ru/language-defs.ent b/docs/ru/language-defs.ent index 751823ac..70f69a5e 100644 --- a/docs/ru/language-defs.ent +++ b/docs/ru/language-defs.ent @@ -1,6 +1,6 @@ - + diff --git a/docs/ru/language-snippets.ent b/docs/ru/language-snippets.ent index e088253b..f30dbb91 100644 --- a/docs/ru/language-snippets.ent +++ b/docs/ru/language-snippets.ent @@ -1,28 +1,28 @@ - + Техническое замечание - Пераметр merge принимает ключи в виде массива, + Пераметр merge учитывает ключи массива, поэтому если вы объединяете массивы с числовыми индексами, то они могут - наложиться друг на друга или в результате может получиться массив с - пропущенными ключами. Заметьте, что в отличие от этого, функция PHP - array_merge() перенумеровывает совпадающие числовые индексы. + наложиться друг на друга или привести к непоследовательному порядку ключей. + Результат отличается от действия функции PHP array_merge(), которая + заново нумерует элементы в массиве с числовоми ключами. '> - В качестве необязательного третьего параметра вы можете передать - compile_id. Это указывает на то, что вы хотите - иметь несколько разных версий одного и того же скомпилированного шаблона, - например, для разных яызков. Другой вариант применения - compile_id - это когда у вас есть несколько - директорий с шаблонами ($template_dir), но только одна директория с - компилированными шаблонами ($compile_dir). Установите отдельный - compile_id для каждой $template_dir, иначе - одноименные шаблоны из разных директорий будут перезаписывать друг друга. - Вы также можете указать $compile_id - один раз вместо того, чтобы каждый раз передавать его этой функции. + В качестве необязательного третьего аргумента вы можете передать + compile_id. Это полезно в случае, если вы хотите + скомпилировать несколько различных версий одного шаблона, например + несколько версий одного шаблона на разных языках. + Другое применение compile_id можно найти, если вы используете + несколько $template_dir, но только одну $compile_dir. + Устанавливайте свой compile_id для каждой + $template_dir, иначе шаблоны с одинаковыми именами будут записываться + поверх друг-друга. Также вы можете один раз указать $compile_id, вместо того, чтобы каждый + раз передавать его при вызове этой функции. '> diff --git a/docs/ru/preface.xml b/docs/ru/preface.xml index 28e90b9f..a80b9a42 100644 --- a/docs/ru/preface.xml +++ b/docs/ru/preface.xml @@ -1,6 +1,6 @@ - + Предисловие @@ -67,7 +67,7 @@ Затем пришло видение того, что в последствии переросло в Smarty. - Мы знали, как быстр PHP-код, если его не перегружать парсингом шаблонов. + Мы знали, как быстр PHP-код, если его не перегружать обработкой шаблонов. Мы также знали, как всеобъемлюще и непонятно может выглядить язык PHP для среднестатистического дизайнера, и что это можно замаскировать при помощи более простого синтаксиса шаблонов. А почему бы нам