Mercurial > pub > Impl

diff Lib/IMPL/Web/TT/Document.pm @ 180:d1676be8afcc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Перекодировка в utf-8
author sourcer
date Fri, 30 Dec 2011 23:40:00 +0300
parents 59e5fcb59d86
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/Web/TT/Document.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Web/TT/Document.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -230,7 +230,7 @@
     return $this->context->process($this->template);
 }
 
-#      
+# Формирует представление для произвольных объектов 
 sub _process {
 	my ($this,@items) = @_;
 	
@@ -286,7 +286,7 @@
 
 =head1 NAME
 
-C<IMPL::Web::TT::Document> - ,     
+C<IMPL::Web::TT::Document> - Документ, позволяющий строить представление по шаблону
 
 =head1 SYNOPSIS
 
@@ -307,13 +307,13 @@
 
 C<use parent qw(IMPL::DOM::Document)>
 
-,    Template::Toolkit.   ,
-   .   C<IMPL::DOM::Node>,
-..      DOM .
+Документ, основанный на шаблоне Template::Toolkit. Позволяет загрузить шаблон,
+и сформировать окончательный документ. Является наследником C<IMPL::DOM::Node>,
+т.о. может быть использован для реализации DOM модели.
 
-   C<document>    .  
-        , 
-   C<Dispose>   .
+Внутри шаблона переменная C<document> ссылается на объект документа. По этой
+причине образуется циклическая ссылка между объектами шаблона и документом, что
+требует вызова метода C<Dispose> для освобождения документа.
 
 =head1 METHODS
 
@@ -321,34 +321,34 @@
 
 =item C<CTOR()>
 
-   ,  C<nodeName>   'C<document>'
+Создает новый экземпляр документа, свойство C<nodeName> устанавливается в 'C<document>'
 
 =item C<$doc->LoadFile($fileName,$encoding)>
 
-    C<$fileName>,   C<$encoding>. 
-  ,  utf-8.
+Загружает шаблон из файла C<$fileName>, используя кодировку C<$encoding>. Если
+кодировка не указана, использует utf-8.
 
 =item C<$doc->Render()>
 
-      .
+Возвращает данные построенные на основе загруженного шаблона.
 
 =item C<$doc->Dispose()>
 
-      .
+Освобождает ресурсы и помечает объект как освобожденный.
 
 =back
 
 =head1 DOM
 
-   DOM ,   ,    
- .     C<template>.
+Документ представляет собой DOM документ, состоящий из узлов, которые представляют собой данные
+для отображения. Для форматированого вывода используется C<template>.
 
-        C<IMPL::Web::TT::Control>,
-       .
+В качестве элементов документа могут присутсвовать специальные объекты C<IMPL::Web::TT::Control>,
+которые внутри содержат шаблон для форматирования собственного содержимого.
 
 
 
-        .
+Документ предоставляет ряд фнукций для работы с элементами управления.
 
 =head1 TEMPLATE
 
@@ -357,7 +357,7 @@
 [% CALL document.registerClass( 'Table', 'My::TableClass', template => 'tables/pretty.tt' ) %]
 [% CALL document.registerClass( 'Form' )%]
 
-[% table = document.reateTable('env') %]
+[% table = document.сreateTable('env') %]
 
 [% FOEACH item in document.result %]
 	[% table.rows.Add( item.get('name','value') ) %]