Skip to content

maxtaco/pubjs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pubjs

Yet another node.js templating system.

It differs from all others we've seen because it offer arbitrary nesting of code and HTML output.

Tutorial and Code Examples

By default, input is in HTML mode, in which all input data is passed through as output data, with the exception of expressions of the form %{foo}, which are first evaluated by JavaScript, and then output:

<b>Name</b>: %{name}<br/>
<b>Passion</b>: %{passion}<br/>

However you can switch from HTML mode into JavaScript mode, with the {% .. %} environment. Inside a JavaScript environment, use normal JavaScript, and also the function print to output HTML:

<b>Name</b>: %{name}<br/>
{% if (pet) { print ("<b>Pet</b>: ", pet); } 
   else     { print ("<i>no pets</i>"); } %}</br>
<b>Passion</b>: %{passion}<br/>

You can also switch back to HTML mode from within JavaScript mode, with any block of the form {{..}}. An equivalent way to write the above is:

<b>Name</b>: %{name}<br/>
{% if (pet) {{<b>Pet</b>: %{pet} }}
   else     {{<i>No pets!</i>}} %}</br>
<b>Passion</b>: %{passion}<br/>

And as advertised, you are free to go as deeply nested as you please:

<b>Name</b>: %{name}<br/>
{% if (pet) {{
    <b>Pet</b>:
    {% if (pet.type == "dog") {{
           Goes woof! (and is
           {% if (pet.sex == "M") {{neutered}}
              else                {{spayed}}
           %}
           so doesn't reproduce)
       }} else if (pet.type == "cat") {{
            Goes meow!
       }}
    %}
}} else {{<i>no pet!</i>}} %}

We've also taken the liberty of adding a bona fide foreach to JavaScript, for simplified iteration:

<table>
{% 
   foreach (var row in rows) {{
       <tr>
       {% 
           foreach (var col in row) {{
               <td>%{col}</td>
           }} 
        %}
        </tr>
    }}
%}
</table>

Usage

To install:

npm install -g pubjs

To use in express:

// Regigster the handler...
app.register ('.pjs', require ('pubjs'));

// Then invoke it as needs be...
app.get('/', function(req, res){
  res.render('index.pjs', {
    title: 'Express'
  });
});

TODOS

  • regtest suite
  • documentation (flesh out this file)
  • hi

About

A node.js templating language with arbitrary nesting

Resources

Stars

Watchers

Forks

Packages

No packages published