Template Toolkit

Contents
Description and links to documentation(top)
In A-Parser is applied to formatting of requests and resultsTemplate Toolkit. This allows to create finite string (for example requests or results) by rules given in a template. Template Toolkit has a set of opportunities:
- Support of conditions and cycles
- Support variable (scalars), arrays and hashes (associative arrays)
- Support of methods for variables (length of string, search and replacement, array size...)
- Support of plug-ins and filters (output and formatting of a date and time, generation of HTML elements...)
Advantages of Template Toolkit existence of full documentation on English language, are given links to the most important sections of documentation below:
- Introduction - general information
- Syntax - rules and style of writing templates
- Directives - conditions, cycles, filters, plug-ins and macroses
- Variables - access and up-dating of values of variables, arrays and hashes
- Virtual methods - the preset functions on processing of variables, arrays and hashes
- Plug-ins and Filters - enhanced features of Template Toolkit, A-Parser supports the following plug-ins:
 - Date - for generation of the formatted strings with dates
 - Dumper - a data structure dump output
 - Format - for creation of the formatting functions on the basis of syntax printf
 - HTML - for creation of HTML elements and screening of HTML code
 - Filter - to create and use filters that are defined and accessible through the plugin download
 - Math - for use of any mathematical functions
 - String - realizes additional methods for operation with strings
 - Table - for data representation in the form of table
 - URL - for creation of links
 - Wrap - for formatting of paragraphs
 - Iterator - to bypass the data set. The iterator is implicitly automatically created by the FOREACH directive. This plugin allows you to create an iterator explicitly with the specified name
Example of using plugins (Math)(top)

Randomly select the specified number of links:
Code:
```
[% limit = 5;
USE Math;
FOREACH i IN [1..5];
 n = Math.rand(intlinks.size);
 intlinks.$n.link _ "\n";
END %]
```
Templates testing tool(top)
For fast check of templates the Template tester tool is built in A-Parser, it contains the preset results for all parsers of test requests, that allows to execute a formatting template without actual parsing
- Testing of templates availablly to each parser separately, for this purpose it is necessary to select the preset project
- Results are provided in the JSON format, that allows to make if necessary changes to basic data (in more detail about JSON on WikiPedia)
- After change of a template necessary to apply it - the button
 Run in the upper right corner
- If the template is made incorrectly that in the field Result there will be a detailed error
- the Preset projects can't be saved, for saving changes it is necessary to add the new project (
 )
Feature of work templates in A-Parser(top)

.format method for arrays(top)
In a parser the majority of results is presented in the form arrays with nested elements, speaking technical language - results are presented in the form of an array of hashes, where each hash has the fixed keys. We will sort an example on a parser SE::Google, it contains an array serp in results with elements link, anchor and snippet:
Code:
```
"serp" : [
 {
 "link" : "http://www.speedtest.net/",
 "anchor" : "Speedtest.net by Ookla - The Global Broadband Speed Test",
 "snippet" : "Test your Internet connection bandwidth to locations around the world with this interactive broadband speed test from Ookla."
 },
 {
 "link" : "http://www.speakeasy.net/speedtest/",
 "anchor" : "Speakeasy Speed Test",
 "snippet" : "Speakeasy Speed Test - Broadband Speed Test. Go to MegaPath Speed Test ... 02:38:36 PM Your IP: The Speakeasy Speed Test requires Flash v7 or higher."
 },
 {
 "link" : "http://en.wikipedia.org/wiki/Test_cricket",
 "anchor" : "Test cricket - Wikipedia, the free encyclopedia",
 "snippet" : "Test cricket is the longest form of the sport of cricket. Test matches are played between national representative teams with &quot;Test status&quot;, as determined by the&nbsp;..."
 }
]
```
For convenient bypass of such array .format method was created, which allows unite all array cells on a certain format, for example all links through line break:
Code:
```
$serp.format('$link\n')
```
That as a result will save each link since a new line:
Code:
```
http://www.speedtest.net/
http://www.speakeasy.net/speedtest/
http://en.wikipedia.org/wiki/Test_cricket
```
Snippets:
Code:
```
$serp.format('$snippet\n')
```
Code:
```
[lang=ru-RU]Test your Internet connection bandwidth to locations around the world with this interactive broadband speed test from Ookla.[/lang][lang=en-US][code]Test your Internet connection bandwidth to locations around the world with this interactive broadband speed test from Ookla.[/lang]
[lang=ru-RU]Speakeasy Speed Test - Broadband Speed Test. Go to MegaPath Speed Test ... 02:38:36 PM Your IP: The Speakeasy Speed Test requires Flash v7 or higher.[/lang][lang=en-US]Speakeasy Speed Test - Broadband Speed Test. Go to MegaPath Speed Test ... 02:38:36 PM Your IP: The Speakeasy Speed Test requires Flash v7 or higher.[/lang]
[lang=ru-RU]Test cricket is the longest form of the sport of cricket. Test matches are played between national representative teams with &quot;Test status&quot;, as determined by the&nbsp;...[/lang][lang=en-US]Test cricket is the longest form of the sport of cricket. Test matches are played between national representative teams with &quot;Test status&quot;, as determined by the&nbsp;...[/lang]
```
Links, anchors and snippets at the same time:
Code:
```
$serp.format('Link: $link, Anchor: $anchor, Snippet: $snippet\n')
```
Code:
```
[lang=ru-RU]Link: http://www.speedtest.net/, Anchor: Speedtest.net by Ookla - The Global Broadband Speed Test, Snippet: Test your Internet connection bandwidth to locations around the world with this interactive broadband speed test from Ookla.[/lang][lang=en-US]Link: http://www.speedtest.net/, Anchor: Speedtest.net by Ookla - The Global Broadband Speed Test, Snippet: Test your Internet connection bandwidth to locations around the world with this interactive broadband speed test from Ookla.[/lang]
[lang=ru-RU]Link: http://www.speakeasy.net/speedtest/, Anchor: Speakeasy Speed Test, Snippet: Speakeasy Speed Test - Broadband Speed Test. Go to MegaPath Speed Test ... 02:38:36 PM Your IP: The Speakeasy Speed Test requires Flash v7 or higher.[/lang][lang=en-US]Link: http://www.speakeasy.net/speedtest/, Anchor: Speakeasy Speed Test, Snippet: Speakeasy Speed Test - Broadband Speed Test. Go to MegaPath Speed Test ... 02:38:36 PM Your IP: The Speakeasy Speed Test requires Flash v7 or higher.[/lang]
[lang=ru-RU]Link: http://en.wikipedia.org/wiki/Test_cricket, Anchor: Test cricket - Wikipedia, the free encyclopedia, Snippet: Test cricket is the longest form of the sport of cricket. Test matches are played between national representative teams with &quot;Test status&quot;, as determined by the&nbsp;...[/lang][lang=en-US]Link: http://en.wikipedia.org/wiki/Test_cricket, Anchor: Test cricket - Wikipedia, the free encyclopedia, Snippet: Test cricket is the longest form of the sport of cricket. Test matches are played between national representative teams with &quot;Test status&quot;, as determined by the&nbsp;...[/lang]
```
In format it is also possible to use the initial request, that allows to set compliance request - each array cell:
Code:
```
$serp.format('$query: $link\n')
```
Code:
```
test: http://www.speedtest.net/
test: http://www.speakeasy.net/speedtest/
test: http://en.wikipedia.org/wiki/Test_cricket
```
Available variables(top)

In case of execution of a template the following variables are available:
Additional options for using templates(top)
Templates when filtering results
Check of finding in link of initial request as file (excludes any other entrances, for example folder/index.php/)
Templates when using the option Parse custom result
Collection of the following 2 words in the snippets going after request
Pay attention that when filtering results and in the option Parse custom result interpolation of variables through $ character is disconnected, the template needs to be specified obviously through tags [% %]

Interpolation of variables(top)
By default templates register between tags [% and %], all that outside tags - the plain text, which will be transferred to result as is
- In A-Parser interpolation of variables is in addition turned, that allows to address to variables in the text through $ character
- In addition it is also interpolated \n as explicit line break
Example:
Code:
```
In total results on request $query: $totalcount\n
```
To the place $query and $totalcount values of appropriate variables will be added, \n will be replaced with line break
The equivalent record without interpolation use:
Code:
```
In total results on request [% query %]: [% totalcount, "\n" %]
```
Pay attention that in templates variables register without $ prefix

Setup preset macros(top)
In A-Parser it is possible to set up macroses and the preset variables, which will be available globally to all templates, it is possible to specify global macroses in Settings -> Advanced settings:
By default there already contains predetermining of object $datefile, which is used for formatting time for result file name

Gorn likes this.

(Like) (24316 Views)

Last Modified: Jan 22, 2018 at 2:21 PM

Template Toolkit

Contents

Description and links to documentation(top)

Example of using plugins (Math)(top)

Templates testing tool(top)

Feature of work templates in A-Parser(top)

.format method for arrays(top)

Available variables(top)

Additional options for using templates(top)

Interpolation of variables(top)

Setup preset macros(top)

About A-Parser

Quick Navigation

Twitter

Contact Us

Useful Searches

Template Toolkit

Contents

Description and links to documentation(top)

Example of using plugins (Math)(top)

Templates testing tool(top)

Feature of work templates in A-Parser(top)

.format method for arrays(top)

Available variables(top)

Additional options for using templates(top)

Interpolation of variables(top)

Setup preset macros(top)

Support Tickets