NAME

Dotiac::DTL::Parser - The default Django/Dotiac parser

SYNOPSIS

        require Dotiac::DTL;
        $t=Dotiac::DTL->new("file.html")
        $t->print();

Static methods

new(FILE) or new(FILE,COMPILE)

Creates a new empty Dotiac::DTL::Parser, used by Dotiac::DTL->new().

Methods

parse(TEMPLATEREF,POSITIONREF, [FOUNDREF, List,of,endtags,to,look,for])

Parses the string referenced in TEMPLATEREF starting at the position referenced in POSITIONREF.

Returns the parsed templatedata if either one of the endtags is found (and sets FOUNDREF to the endtag) or the end of the string is reached.

This is used by tags to look for their endtag. For example the ifequal tag:

        sub new {
                my $class=shift;
                my $self={p=>shift()}; #Text that came before the tag.
                my $data=shift; #Content of the tag other than the name.
                my $obj=shift;
                my $data=shift; #Templatedataref
                my $pos=shift;  #and positionref from the parse() calling this tags new().
                my $found=""; #Empty found
                $self->{true}=$obj->parse($data,$pos,\$found,"else","endifequal"); #Search for either "else" or "endifequal" and set it to $found.
                if ($found eq "else") {
                        $self->{false}=$obj->parse($data,$pos,\$found,"endifequal"); #If "else" was found, search for "endifequal"
                }
                ($self->{var1},$self->{var2},undef)=Dotiac::DTL::get_variables($data);
                bless $self,$class;
                return $self;
        }
        #....

Note

Dotiac::DTL::Reduced doesn't support this, so it doesn't have to load all the tags or the parser.

unparsed(TEMPLATEREF,POSITIONREF, [FOUNDREF, STARTTAG, List,of,endtags,to,look,for])

Parses the string referenced in TEMPLATEREF starting at the position referenced in POSITIONREF.

Returns the unparsed templatedata if either one of the endtags is found (and sets FOUNDREF to the endtag) or the end of the string is reached.

Skips STARTTAG occurences and searches for additional endtags

This is used by tags to look for their endtag. For example an unparsed tag:

        sub new {
                my $class=shift;
                my $self={p=>shift()}; #Text that came before the tag.
                my $data=shift; #Content of the tag other than the name.
                my $obj=shift;
                my $data=shift; #Templatedataref
                my $pos=shift;  #and positionref from the parse() calling this tags new().
                my $found=""; #Empty found
                $self->{content}=$obj->unparsed($data,$pos,\$found,"unparsed","endunparsed");
                bless $self,$class;
                return $self;
        }
        #....

Note

There is no internal tag for now that needs this. But you might find some addons.

I planned this for a addon like Calypso DTL's {% ajax %} tag, that throws the unparsed template at DojoxDTL to render it in the browser.

Dotiac::DTL::Reduced doesn't support this either.

SEE ALSO

http://www.djangoproject.com, Dotiac::DTL

BUGS

If you find a bug, please report it.

LEGAL

Dotiac::DTL was built according to http://docs.djangoproject.com/en/dev/ref/templates/builtins/.

AUTHOR

Marc-Sebastian Lucksch

perl@marc-s.de

cpanm Dotiac::DTL

perl -MCPAN -e shell
install Dotiac::DTL