peml

• Home
• Tutorial
• Installation
• Extension
• Reference
• Download
• Forum

Installation and Configuration

lock and load

Standalone Renderer

To get the basics up and running, you'll need the standalone version from the source repo. Place the peml directory from this in an easy to reference location on the webserver, assumed to be the document root. This also includes a quick test page to make sure everything is working ok. A sample directory structure would be:

/peml/peml.php
/peml/pemlRender.php
/peml/Core
[...]
/Sample Site/index.php

Configuration

The peml.php file in the Configuration folder of peml is where general parsing settings are stored, which are best left to default unless you're sure you want to change them. Disabling strict mode will enable non-html elements and disable error reporting, so is highly unrecommended. Strict mode actually makes markup more flexible, as validating the tags means it can ignore unmarked lines of text (unless they begin with a lowercase html tag name).

By default pemlRender also looks at the GET for 'source' as an option for printing the raw file, so the markup behind each page can be seen. This option is configurable via the showSource config setting.

Nesting

As of this version there is no built-in support for nested rendering of includes as peml. An option for will will be available in a future version.

Consult the tutorial or reference for syntax help, or the extension guide for how to add functionality.

Adding a Library

By default the SCL is included which adds php flow control and common HTML helpers. This can be removed, leaving a core parser of just tags (still with access to php echo).

Adding a library is as simple as including its file in the Libraries folder, and its Configuration file in the Configuration folder if it has one.

For more information, please review the source code of the libraries, or look at the source of this or any page on the site (see footer) for a view of how it's used.