");if (browserV -

stupid_template_engine.php

The implementation of the Stupid Template Engine.

Summary

stupid_template_engine.php	The implementation of the Stupid Template Engine.
License	This file is licensed under the MIT/X11 License.
ste	Everything in this file is in this namespace.
Functions
precompile	Precompiling STE T/PL templates.
parse	Parsing a STE T/PL template.
transcompile	Transcompiles an abstract syntax tree to PHP.
Constants
Template modes
StorageAccess	An interface.
Functions
load	Loading a template.
save	Saves a template.
FilesystemStorageAccess	The default StorageAccess implementation for loading / saving templates into a directory structure.
Functions
__construct
STECore	The Core of STE
Variables
Public variables
Functions
__construct
register_tag	Register a custom tag.
call_tag	Calling a custom tag (builtin ones can not be called)
exectemplate	Executes a template and returns the result.
get_var_reference	Get a reference to a template variable using a variable name.
set_var_by_name	Set a template variable by its name.
get_var_by_name	Get a template variable by its name.
load	Load a template and return its result (blocks not included, use exectemplate for this).
evalbool	Test, if a text represents false (an empty / only whitespace text) or true (everything else).

stupid_template_engine.php

The implementation of the Stupid Template Engine.

Summary

stupid_template_engine.php	The implementation of the Stupid Template Engine.
License	This file is licensed under the MIT/X11 License.
ste	Everything in this file is in this namespace.
RuntimeError	An Exception that a tag can throw, if a non-fatal runtime error occurred.
FatalRuntimeError	An Exception a tag can throw, if a fatal (irreparable) runtime error occurred.
Functions
precompile	Precompiling STE T/PL templates.
parse	Parsing a STE T/PL template.
transcompile	Transcompiles an abstract syntax tree to PHP.
Constants
Template modes
CantLoadTemplate	An exception that a StorageAccess implementation can throw, if it is unable to load a template.
CantSaveTemplate	An exception that a StorageAccess implementation can throw, if it is unable to save a template.
StorageAccess	An interface.
Functions
load	Loading a template.
save	Saves a template.
FilesystemStorageAccess	The default StorageAccess implementation for loading / saving templates into a directory structure.
Functions
__construct
STECore	The Core of STE
Variables
Public variables
Functions
__construct
register_tag	Register a custom tag.
call_tag	Calling a custom tag (builtin ones can not be called)
exectemplate	Executes a template and returns the result.
get_var_reference	Get a reference to a template variable using a variable name.
set_var_by_name	Set a template variable by its name.
get_var_by_name	Get a template variable by its name.
load	Load a template and return its result (blocks not included, use exectemplate for this).
evalbool	Test, if a text represents false (an empty / only whitespace text) or true (everything else).

License

This file is licensed under the MIT/X11 License. See COPYING for more details.

ste

Everything in this file is in this namespace.

Summary

Functions
precompile	Precompiling STE T/PL templates.
parse	Parsing a STE T/PL template.
transcompile	Transcompiles an abstract syntax tree to PHP.
Constants
Template modes

ste

Everything in this file is in this namespace.

Functions

RuntimeError

An Exception that a tag can throw, if a non-fatal runtime error occurred. By default this will return in no output at all. But if STECore::$mute_runtime_errors is false, this will generate a error message instead of the tag’s output.

precompile

function precompile( $code )

Precompiling STE T/PL templates. You only need this function, if you want to manually transcompile a template.

Parameters

$code

The input code

Returns

The precompiled code.

FatalRuntimeError

An Exception a tag can throw, if a fatal (irreparable) runtime error occurred. This Exception will always “bubble up” so you probably want to catch them. Remember that this exception is also in the namespace ste!

Summary

Functions
precompile	Precompiling STE T/PL templates.
parse	Parsing a STE T/PL template.
transcompile	Transcompiles an abstract syntax tree to PHP.
Constants
Template modes

parse

function parse( $code,
$tpl )

Parsing a STE T/PL template. You only need this function, if you want to manually transcompile a template.

Parameters

$code	The STE T/PL code.
$tpl	The name of the template.

Returns

An abstract syntax tree, which can be used with transcompile.

Functions

transcompile

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP. You only need this function, if you want to manually transcompile a template.

Parameters

$ast	The abstract syntax tree to transcompile.

Returns

PHP code. The PHP code is an anonymous function expecting a STECore instance as its parameter and returns a string (everything that was not pached into a section).

precompile

function precompile( $code )

Precompiling STE T/PL templates. You only need this function, if you want to manually transcompile a template.

Parameters

$code

The input code

Returns

The precompiled code.

Constants

parse

function parse( $code,
$tpl )

Parsing a STE T/PL template. You only need this function, if you want to manually transcompile a template.

Parameters

$code	The STE T/PL code.
$tpl	The name of the template.

Returns

An abstract syntax tree, which can be used with transcompile.

Template modes

MODE_SOURCE	The Templates source
MODE_TRANSCOMPILED	The transcompiled template

transcompile

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP. You only need this function, if you want to manually transcompile a template.

Parameters

$ast	The abstract syntax tree to transcompile.

Returns

PHP code. The PHP code is an anonymous function expecting a STECore instance as its parameter and returns a string (everything that was not pached into a section).

StorageAccess

An interface. A StorageAccess implementation is used to access the templates from any storage. This means, that you are not limited to store the Templates inside directories, you can also use a database or something else.

Summary

Functions
load	Loading a template.
save	Saves a template.

Constants

+ +

Template modes

MODE_SOURCE	The Templates source
MODE_TRANSCOMPILED	The transcompiled template

+ +

CantLoadTemplate

An exception that a StorageAccess implementation can throw, if it is unable to load a template.

+ +

CantSaveTemplate

An exception that a StorageAccess implementation can throw, if it is unable to save a template.

+ +

StorageAccess

Summary

Functions
load	Loading a template.
save	Saves a template.

Functions

load

public function load( $tpl,
& $mode )

Loading a template.

Parameters

$tpl	The name of the template.
&$mode	Which mode is preferred? One of the <Template modes>. If <MODE_SOURCE>, the raw sourcecode is expected, if <MODE_TRANSCOMPILED> the transcompiled template as a callable function (expecting an STECore instance as first parameter) is expected. If the transcompiled version is not available or older than the source, you can set this parameter to <MODE_SOURCE> and return the source.

Returns

Either the sourcecode or a callable function (first, and only parameter: an STECore instance).

load

public function load( $tpl,
& $mode )

Loading a template.

Parameters

$tpl	The name of the template.
&$mode	Which mode is preferred? One of the <Template modes>. If <MODE_SOURCE>, the raw sourcecode is expected, if <MODE_TRANSCOMPILED> the transcompiled template as a callable function (expecting an STECore instance as first parameter) is expected. If the transcompiled version is not available or older than the source, you can set this parameter to <MODE_SOURCE> and return the source.

Throws

A CantLoadTemplate exception if the template could not be loaded.

Returns

Either the sourcecode or a callable function (first, and only parameter: an STECore instance).

save

public function save( $tpl,
$data,
$mode )

Saves a template.

Parameters

$tpl -The name of the template. $data - The data to be saved. $mode - A <Template mode> constant.

save

public function save( $tpl,
$data,
$mode )

Saves a template.

Throws

A CantSaveTemplate exception if the template could not be saved.

Parameters

$tpl -The name of the template. $data - The data to be saved. $mode - A <Template mode> constant.

FilesystemStorageAccess

The default StorageAccess implementation for loading / saving templates into a directory structure.

Summary

Functions
__construct

FilesystemStorageAccess

The default StorageAccess implementation for loading / saving templates into a directory structure.

Summary

Functions
__construct

Functions

__construct

public function __construct( $src,
$transc )

Parameters

$src	The directory with the sources (Writing permissions are not mandatory, because STE does not save template sources).
$transc	The directory with the transcompiled templates (the PHP instance / the HTTP Server needs writing permissions to this directory).

STECore

The Core of STE

Summary

Variables
Public variables
Functions
__construct
register_tag	Register a custom tag.
call_tag	Calling a custom tag (builtin ones can not be called)
exectemplate	Executes a template and returns the result.
get_var_reference	Get a reference to a template variable using a variable name.
set_var_by_name	Set a template variable by its name.
get_var_by_name	Get a template variable by its name.
load	Load a template and return its result (blocks not included, use exectemplate for this).
evalbool	Test, if a text represents false (an empty / only whitespace text) or true (everything else).

STECore

The Core of STE

Summary

Variables
Public variables
Functions
__construct
register_tag	Register a custom tag.
call_tag	Calling a custom tag (builtin ones can not be called)
exectemplate	Executes a template and returns the result.
get_var_reference	Get a reference to a template variable using a variable name.
set_var_by_name	Set a template variable by its name.
get_var_by_name	Get a template variable by its name.
load	Load a template and return its result (blocks not included, use exectemplate for this).
evalbool	Test, if a text represents false (an empty / only whitespace text) or true (everything else).

Variables

Public variables

$blocks	Associative array of blocks (see the language definition).
$blockorder	The order of the blocks (an array)
$vars	Associative array of all template variables. Use this to pass data to your templates.

Public variables

$blocks	Associative array of blocks (see the language definition).
$blockorder	The order of the blocks (an array)
$vars	Associative array of all template variables. Use this to pass data to your templates.
$mute_runtime_errors	If True (default) a RuntimeError exception will result in no output from the tag, if False a error message will be written to output.
$fatal_error_on_missing_tag	If True, STE will throw a FatalRuntimeError if a tag was called that was not registered, otherwise (default) a regular RuntimeError will be thrown and automatically handled by STE (see <$mute_runtime_errors>).

Functions

__construct

public function __construct( $storage_access )

Parameters

$storage_access

An Instance of a StorageAccess implementation.

__construct

public function __construct( $storage_access )

Parameters

$storage_access

An Instance of a StorageAccess implementation.

register_tag

public function register_tag( $name,
$callback )

Parameters

$name	The name of the tag.
$callback	A callable function (This must tage three parameters: The STECore instance, an associative array of parameters, and a function representing the tags content(This expects the STECore instance as its only parameter and returns its text result, i.e to get the text, you neeed to call this function with the STECore instance as a parameter)).

register_tag

public function register_tag( $name,
$callback )

Parameters

$name	The name of the tag.
$callback	A callable function (This must tage three parameters: The STECore instance, an associative array of parameters, and a function representing the tags content(This expects the STECore instance as its only parameter and returns its text result, i.e to get the text, you neeed to call this function with the STECore instance as a parameter)).

Throws

An Exception if the tag could not be registered (if $callback is not callable or if $name is empty)

call_tag

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

Parameters

$name	The Tag’s name
$params	Associative array of parameters
$sub	A callable function (expecting an STECore instance as it’s parameter) that represents the tag’s content.

Returns

The output of the tag.

call_tag

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

Parameters

$name	The Tag’s name
$params	Associative array of parameters
$sub	A callable function (expecting an STECore instance as it’s parameter) that represents the tag’s content.

Throws

Might throw a FatalRuntimeError.

Returns

The output of the tag or, if a RuntimeError was thrown, the appropiate result (see <$mute_runtime_errors>).

exectemplate

public function exectemplate( $tpl )

Executes a template and returns the result. The huge difference to load is that this function will also output all blocks.

Parameters

$tpl	The name of the template to execute.

Returns

The output of the template.

exectemplate

public function exectemplate( $tpl )

Executes a template and returns the result. The huge difference to load is that this function will also output all blocks.

Parameters

$tpl	The name of the template to execute.

Returns

The output of the template.

get_var_reference

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name	The variables name.
$create_if_not_exist	Should the variable be created, if it does not exist? Otherwise NULL will be returned, if the variable does not exist.

Returns

A Reference to the variable.

get_var_reference

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name	The variables name.
$create_if_not_exist	Should the variable be created, if it does not exist? Otherwise NULL will be returned, if the variable does not exist.

Throws

RuntimeError if the variable name can not be parsed (e.g. unbalanced brackets).

Returns

A Reference to the variable.

set_var_by_name

public function set_var_by_name( $name,
$val )

Set a template variable by its name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name	The variables name.
$val	The new value.

set_var_by_name

public function set_var_by_name( $name,
$val )

Set a template variable by its name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name	The variables name.
$val	The new value.

Throws

RuntimeError if the variable name can not be parsed (e.g. unbalanced brackets).

get_var_by_name

public function get_var_by_name( $name )

Get a template variable by its name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name

The variables name.

Returns

The variables value.

get_var_by_name

public function get_var_by_name( $name )

Get a template variable by its name. This can be used,if your custom tag takes a variable name as a parameter.

Parameters

$name

The variables name.

Throws

RuntimeError if the variable name can not be parsed (e.g. unbalanced brackets).

Returns

The variables value.

load

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

Parameters

$tpl	The name of the template to be loaded.
$quiet	If true, do not output anything and do notmodify the blocks. This can be useful to load custom tags that are programmed in STE T/PL. Default: false.

Returns

The result of the template (if $quiet == false).

load

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

Parameters

$tpl	The name of the template to be loaded.
$quiet	If true, do not output anything and do notmodify the blocks. This can be useful to load custom tags that are programmed in STE T/PL. Default: false.

Throws

A FatalRuntimeError if a tag threw it or, if $fatal_error_on_missing_tag is True, a non-existant tag was called.

Returns

The result of the template (if $quiet == false).

evalbool

public function evalbool( $txt )

Test, if a text represents false (an empty / only whitespace text) or true (everything else).

Parameters

$txt	The text to test.

Returns

true/false.

@@ -82,7 +90,7 @@ var searchPanel = new SearchPanel("searchPanel", "HTML", "../search"); -

function precompile( $code )

Precompiling STE T/PL templates.

function parse( $code,
$tpl )

Parsing a STE T/PL template.

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP.

public function load( $tpl,
& $mode )

Loading a template.

public function save( $tpl,
$data,
$mode )

Saves a template.

An interface.

public function __construct( $src,
$transc )

public function __construct( $storage_access )

public function register_tag( $name,
$callback )

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

public function exectemplate( $tpl )

Executes a template and returns the result.

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name.

public function set_var_by_name( $name,
$val )

Set a template variable by its name.

public function get_var_by_name( $name )

Get a template variable by its name.

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

public function evalbool( $txt )

Test, if a text represents false (an empty / only whitespace text) or true (everything else).

The Core of STE

function precompile( $code )

Precompiling STE T/PL templates.

function parse( $code,
$tpl )

Parsing a STE T/PL template.

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP.

An interface.

public function load( $tpl,
& $mode )

Loading a template.

public function save( $tpl,
$data,
$mode )

Saves a template.

public function __construct( $src,
$transc )

public function __construct( $storage_access )

public function register_tag( $name,
$callback )

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

public function exectemplate( $tpl )

Executes a template and returns the result.

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name.

public function set_var_by_name( $name,
$val )

Set a template variable by its name.

public function get_var_by_name( $name )

Get a template variable by its name.

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

public function evalbool( $txt )

Test, if a text represents false (an empty / only whitespace text) or true (everything else).

If True (default) a RuntimeError exception will result in no output from the tag, if False a error message will be written to output.

The Core of STE

An exception that a StorageAccess implementation can throw, if it is unable to load a template.

An exception that a StorageAccess implementation can throw, if it is unable to save a template.

An Exception that a tag can throw, if a non-fatal runtime error occurred.

An Exception a tag can throw, if a fatal (irreparable) runtime error occurred.

If True, STE will throw a FatalRuntimeError if a tag was called that was not registered, otherwise (default) a regular RuntimeError will be thrown and automatically handled by STE (see <$mute_runtime_errors>).

diff --git a/docu/nd/index/Classes.html b/docu/nd/index/Classes.html index e61de72..d2bee20 100644 --- a/docu/nd/index/Classes.html +++ b/docu/nd/index/Classes.html @@ -11,13 +11,21 @@ if (browserType) {document.write("

");if (browserV -

Class Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

F
	FilesystemStorageAccess
S
	ste
	STECore
	StorageAccess

Class Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

C
	CantLoadTemplate
	CantSaveTemplate
F
	FatalRuntimeError
	FilesystemStorageAccess
R
	RuntimeError
S
	ste
	STECore
	StorageAccess

The default StorageAccess implementation for loading / saving templates into a directory structure.

An exception that a StorageAccess implementation can throw, if it is unable to load a template.

An exception that a StorageAccess implementation can throw, if it is unable to save a template.

Everything in this file is in this namespace.

The Core of STE

An interface.

An Exception a tag can throw, if a fatal (irreparable) runtime error occurred.

The default StorageAccess implementation for loading / saving templates into a directory structure.

+ + + +

An Exception that a tag can throw, if a non-fatal runtime error occurred.

+ + + +

Everything in this file is in this namespace.

The Core of STE

An interface.

diff --git a/docu/nd/index/Constants.html b/docu/nd/index/Constants.html index 3e2d330..53106b3 100644 --- a/docu/nd/index/Constants.html +++ b/docu/nd/index/Constants.html @@ -11,7 +11,7 @@ if (browserType) {document.write("

");if (browserV -

Constant Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

M
	MODE_SOURCE, ste
	MODE_TRANSCOMPILED, ste
T
	Template modes, ste

Constant Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

M
	MODE_SOURCE, FatalRuntimeError
	MODE_TRANSCOMPILED, FatalRuntimeError
T
	Template modes, FatalRuntimeError

The Templates source

The transcompiled template

diff --git a/docu/nd/index/Functions.html b/docu/nd/index/Functions.html index 5a9cff5..5087083 100644 --- a/docu/nd/index/Functions.html +++ b/docu/nd/index/Functions.html @@ -11,7 +11,7 @@ if (browserType) {document.write("

");if (browserV -

Function Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

$#!
	__construct FilesystemStorageAccess STECore
C
	call_tag, STECore
E
	evalbool, STECore
	exectemplate, STECore
G
	get_var_by_name, STECore
	get_var_reference, STECore
L
	load STECore StorageAccess
P
	parse, ste
	precompile, ste
R
	register_tag, STECore
S
	save, StorageAccess
	set_var_by_name, STECore
T
	transcompile, ste

Function Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

$#!
	__construct FilesystemStorageAccess STECore
C
	call_tag, STECore
E
	evalbool, STECore
	exectemplate, STECore
G
	get_var_by_name, STECore
	get_var_reference, STECore
L
	load STECore StorageAccess
P
	parse, FatalRuntimeError
	precompile, FatalRuntimeError
R
	register_tag, STECore
S
	save, StorageAccess
	set_var_by_name, STECore
T
	transcompile, FatalRuntimeError

public function __construct( $src,
$transc )

public function __construct( $storage_access )

diff --git a/docu/nd/index/General.html b/docu/nd/index/General.html index 25c3cbb..626bc81 100644 --- a/docu/nd/index/General.html +++ b/docu/nd/index/General.html @@ -11,7 +11,7 @@ if (browserType) {document.write("

");if (browserV -

Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

$#!
	__construct FilesystemStorageAccess STECore
B
$	blockorder, STECore
$	blocks, STECore
C
	call_tag, STECore
	Constants, ste
E
	evalbool, STECore
	exectemplate, STECore
F
	FilesystemStorageAccess
	Functions FilesystemStorageAccess ste STECore StorageAccess
G
	get_var_by_name, STECore
	get_var_reference, STECore
L
	License
	load STECore StorageAccess
M
	MODE_SOURCE, ste
	MODE_TRANSCOMPILED, ste
P
	parse, ste
	precompile, ste
	Public variables, STECore
R
	register_tag, STECore
S
	save, StorageAccess
	set_var_by_name, STECore
	ste
	STECore
	StorageAccess
	stupid_template_engine.php
T
	Template modes, ste
	transcompile, ste
V
	Variables, STECore
$	vars, STECore

Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

$#!
	__construct FilesystemStorageAccess STECore
B
$	blockorder, STECore
$	blocks, STECore
C
	call_tag, STECore
	CantLoadTemplate
	CantSaveTemplate
	Constants, FatalRuntimeError
E
	evalbool, STECore
	exectemplate, STECore
F
$	fatal_error_on_missing_tag, STECore
	FatalRuntimeError
	FilesystemStorageAccess
	Functions FatalRuntimeError FilesystemStorageAccess STECore StorageAccess
G
	get_var_by_name, STECore
	get_var_reference, STECore
L
	License
	load STECore StorageAccess
M
	MODE_SOURCE, FatalRuntimeError
	MODE_TRANSCOMPILED, FatalRuntimeError
$	mute_runtime_errors, STECore
P
	parse, FatalRuntimeError
	precompile, FatalRuntimeError
	Public variables, STECore
R
	register_tag, STECore
	RuntimeError
S
	save, StorageAccess
	set_var_by_name, STECore
	ste
	STECore
	StorageAccess
	stupid_template_engine.php
T
	Template modes, FatalRuntimeError
	transcompile, FatalRuntimeError
V
	Variables, STECore
$	vars, STECore

public function __construct( $src,
$transc )

public function __construct( $storage_access )

@@ -21,47 +21,47 @@ if (browserType) {document.write("

");if (browserV -

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

public function call_tag( $name,
$params,
$sub )

Calling a custom tag (builtin ones can not be called)

An exception that a StorageAccess implementation can throw, if it is unable to load a template.

An exception that a StorageAccess implementation can throw, if it is unable to save a template.

public function evalbool( $txt )

Test, if a text represents false (an empty / only whitespace text) or true (everything else).

public function exectemplate( $tpl )

Executes a template and returns the result.

public function evalbool( $txt )

Test, if a text represents false (an empty / only whitespace text) or true (everything else).

public function exectemplate( $tpl )

Executes a template and returns the result.

The default StorageAccess implementation for loading / saving templates into a directory structure.

An Exception a tag can throw, if a fatal (irreparable) runtime error occurred.

The default StorageAccess implementation for loading / saving templates into a directory structure.

public function get_var_by_name( $name )

Get a template variable by its name.

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name.

public function get_var_by_name( $name )

Get a template variable by its name.

public function &get_var_reference( $name,
$create_if_not_exist )

Get a reference to a template variable using a variable name.

This file is licensed under the MIT/X11 License.

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

public function load( $tpl,
& $mode )

Loading a template.

This file is licensed under the MIT/X11 License.

public function load( $tpl,
$quiet = False )

Load a template and return its result (blocks not included, use exectemplate for this).

public function load( $tpl,
& $mode )

Loading a template.

The Templates source

The transcompiled template

The Templates source

The transcompiled template

If True (default) a RuntimeError exception will result in no output from the tag, if False a error message will be written to output.

function parse( $code,
$tpl )

Parsing a STE T/PL template.

function precompile( $code )

Precompiling STE T/PL templates.

function parse( $code,
$tpl )

Parsing a STE T/PL template.

function precompile( $code )

Precompiling STE T/PL templates.

public function register_tag( $name,
$callback )

An Exception that a tag can throw, if a non-fatal runtime error occurred.

public function save( $tpl,
$data,
$mode )

Saves a template.

public function set_var_by_name( $name,
$val )

Set a template variable by its name.

Everything in this file is in this namespace.

The Core of STE

An interface.

The implementation of the Stupid Template Engine.

public function save( $tpl,
$data,
$mode )

Saves a template.

public function set_var_by_name( $name,
$val )

Set a template variable by its name.

Everything in this file is in this namespace.

The Core of STE

An interface.

The implementation of the Stupid Template Engine.

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP.

function transcompile( $ast ) /* Transcompile and add some boilerplate code. */

Transcompiles an abstract syntax tree to PHP.

Associative array of all template variables.

diff --git a/docu/nd/index/Variables.html b/docu/nd/index/Variables.html index 96ac427..115906e 100644 --- a/docu/nd/index/Variables.html +++ b/docu/nd/index/Variables.html @@ -11,17 +11,25 @@ if (browserType) {document.write("

");if (browserV -

Variable Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

B
$	blockorder, STECore
$	blocks, STECore
P
	Public variables, STECore
V
$	vars, STECore

Variable Index

$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

B
$	blockorder, STECore
$	blocks, STECore
F
$	fatal_error_on_missing_tag, STECore
M
$	mute_runtime_errors, STECore
P
	Public variables, STECore
V
$	vars, STECore

The order of the blocks (an array)

Associative array of blocks (see the language definition).

+ +

+ + + +

If True (default) a RuntimeError exception will result in no output from the tag, if False a error message will be written to output.

+ + -

Associative array of all template variables.

diff --git a/docu/nd/javascript/searchdata.js b/docu/nd/javascript/searchdata.js index 3095b6a..62831fb 100644 --- a/docu/nd/javascript/searchdata.js +++ b/docu/nd/javascript/searchdata.js @@ -37,14 +37,14 @@ var indexSectionsWithContent = { "C": false, "D": false, "E": false, - "F": false, + "F": true, "G": false, "H": false, "I": false, "J": false, "K": false, "L": false, - "M": false, + "M": true, "N": false, "O": false, "P": true, @@ -154,7 +154,7 @@ var indexSectionsWithContent = { "Numbers": false, "A": false, "B": false, - "C": false, + "C": true, "D": false, "E": false, "F": true, @@ -169,7 +169,7 @@ var indexSectionsWithContent = { "O": false, "P": false, "Q": false, - "R": false, + "R": true, "S": true, "T": false, "U": false, diff --git a/docu/nd/search/ClassesC.html b/docu/nd/search/ClassesC.html new file mode 100644 index 0000000..c74a031 --- /dev/null +++ b/docu/nd/search/ClassesC.html @@ -0,0 +1,20 @@ + + + + + + + + + + + + +

CantLoadTemplate

CantSaveTemplate

Searching...

No Matches

\ No newline at end of file diff --git a/docu/nd/search/ClassesF.html b/docu/nd/search/ClassesF.html index 9c33ca5..b328661 100644 --- a/docu/nd/search/ClassesF.html +++ b/docu/nd/search/ClassesF.html @@ -11,7 +11,7 @@ if (browserType) {document.write("

");if (browserV -

FilesystemStorageAccess

Searching...

No Matches

+ + + + + + + + + +

RuntimeError

Searching...

No Matches

\ No newline at end of file diff --git a/docu/nd/search/ConstantsM.html b/docu/nd/search/ConstantsM.html index da4b5f8..64fb4fb 100644 --- a/docu/nd/search/ConstantsM.html +++ b/docu/nd/search/ConstantsM.html @@ -11,7 +11,7 @@ if (browserType) {document.write("

");if (browserV -

MODE_SOURCE, ste

MODE_TRANSCOMPILED, ste

Searching...

No Matches

+ + + + + + + + + +

$fatal_error_on_missing_tag, STECore

Searching...

No Matches

\ No newline at end of file diff --git a/docu/nd/search/VariablesM.html b/docu/nd/search/VariablesM.html new file mode 100644 index 0000000..42f88b4 --- /dev/null +++ b/docu/nd/search/VariablesM.html @@ -0,0 +1,20 @@ + + + + + + + + + + + + +

$mute_runtime_errors, STECore

Searching...

No Matches

\ No newline at end of file -- cgit v1.2.3-70-g09d2