# xtpl

> nodejs wrapper around xtemplate engine

Latest version **3.4.2** (published 2019-07-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install xtpl
pnpm add xtpl
yarn add xtpl
bun add xtpl
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.4.2 |
| Published | 2019-07-31 |
| First published | 2014-02-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10 |
| Dependencies | 0 |
| Unpacked size | 15.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 99 |
| Author | yiminghe |
| Maintainers | 4simple, yiminghe |
| Keywords | xtpl, xtemplate, express |

## Links

- npm: https://www.npmjs.com/package/xtpl
- Repository: https://github.com/xtemplate/xtpl
- Homepage: https://github.com/xtemplate/xtpl#readme
- Issues: https://github.com/xtemplate/xtpl/issues
- npm.io page: https://npm.io/package/xtpl

## Recent versions

- 3.4.2 (latest) — 2019-07-31
- 3.4.1 — 2019-07-30
- 3.4.0 — 2017-12-13
- 3.3.0 — 2016-09-28
- 3.2.0 — 2015-06-01
- 3.1.9 — 2015-01-28
- 3.1.8 — 2014-12-04
- 3.1.7 — 2014-09-26
- 3.1.6 — 2014-09-26
- 3.1.5 — 2014-09-26
- 3.1.4 — 2014-09-26
- 3.1.3 — 2014-09-25
- 3.1.2 — 2014-09-23
- 3.1.1 — 2014-09-23
- 3.1.0 — 2014-09-23
- … 45 more at https://npm.io/package/xtpl/versions

## README

# xtpl

nodejs wrapper around [xtemplate](https://github.com/xtemplate/xtemplate) engine (easier for expressjs and koajs)

[![xtpl](https://nodei.co/npm/xtpl.png)](https://npmjs.org/package/xtpl)
[![NPM downloads](http://img.shields.io/npm/dm/xtpl.svg)](https://npmjs.org/package/xtpl)
[![Build Status](https://secure.travis-ci.org/xtemplate/xtpl.png?branch=master)](https://travis-ci.org/xtemplate/xtpl)
[![Coverage Status](https://coveralls.io/repos/xtemplate/xtpl/badge.png?branch=master)](https://coveralls.io/r/xtemplate/xtpl?branch=master)
[![Dependency Status](https://gemnasium.com/xtemplate/xtpl.png)](https://gemnasium.com/xtemplate/xtpl)

## docs

### syntax

refer: https://github.com/xtemplate/xtemplate

### api

#### methods

##### config or get xtpl global option:
```javascript
Object config(option:Object)
```

option details:
<table class="table table-bordered table-striped">
    <thead>
    <tr>
        <th style="width: 100px;">name</th>
        <th style="width: 50px;">type</th>
        <th style="width: 50px;">default</th>
        <th>description</th>
    </tr>
    </thead>
    <tbody>
      <tr>
          <td>encoding</td>
          <td>String</td>
          <td>utf-8</td>
          <td>xtpl file encoding</td>
      </tr>
      <tr>
          <td>XTemplate</td>
          <td>Object</td>
          <td>require('xtemplate')</td>
          <td>xtemplate module value</td>
      </tr>
    </tbody>
</table>

if options is undefined, then this method will return global config.

##### render file
```javascript
void renderFile(path:String, options:Object, callback:function)
```
parameter details:
<table class="table table-bordered table-striped">
    <thead>
    <tr>
        <th style="width: 100px;">name</th>
        <th style="width: 50px;">type</th>
        <th style="width: 50px;">default</th>
        <th>description</th>
    </tr>
    </thead>
    <tbody>
      <tr>
          <td>path</td>
          <td>String</td>
          <td></td>
          <td>xtpl template file</td>
      </tr>
      <tr>
          <td>option</td>
          <td>Object</td>
          <td></td>
          <td>
          data to be rendered. the following properties will be used for control.
          <table class="table table-bordered table-striped">
              <thead>
              <tr>
                  <th style="width: 100px;">name</th>
                  <th style="width: 50px;">type</th>
                  <th style="width: 50px;">default</th>
                  <th>description</th>
              </tr>
              </thead>
              <tbody>
                <tr>
                    <td>cache</td>
                    <td>Boolean</td>
                    <td>false</td>
                    <td>whether cache xtpl by path</td>
                </tr>
                <tr>
                    <td>setting['view encoding']</td>
                    <td>String</td>
                    <td>global encoding</td>
                    <td>encoding for read xtpl files</td>
                </tr>
              </tbody>
          </table>
          </td>
      </tr>
      <tr>
          <td>callback</td>
          <td>function</td>
          <td></td>
          <td>callback</td>
      </tr>
    </tbody>
</table>

```
npm install xtpl xtemplate --save
```

```javascript
var xtpl = require('xtpl');
xtpl.renderFile('./x.xtpl',{
	x:1
},function(error,content){

});
```

##### express adaptor

```javascript
xtpl.__express = xtpl.renderFile
```

##### clear cache

clear xtemplate cache cached by xtpl file path

```javascript
void clearCache(path:String);
```

### use for expressjs

```javascript
var app = require('express')();
app.set('views','./views');
app.set('view engine', 'xtpl');
app.use(function(req, res){
    res.render('test',{data:1});
});
```

### use for koa

```javascript
var app = require('xtpl/lib/koa2')(new require('koa')(),{
    views:'./views'
});
app.use(async function(ctx){
    await ctx.render('test',{data:1});
});
```


## Example

    ├── footer.xtpl
    ├── header.xtpl
    ├── index.xtpl
    ├── layout.xtpl
    ├── layout1.xtpl
    └── sub
        └── header.xtpl

index.xtpl

    {{extend ("./layout1")}}

    {{#block ("head")}}
    <!--index head block-->
    <link type="text/css" href="test.css" rev="stylesheet" rel="stylesheet"  />
    {{/block}}

    {{#block ("body")}}
    <!--index body block-->
    <h2>{{title}}</h2>
    {{/block}}

layout1.xtpl

    <!doctype html>
    <html>
    <head>
    <meta name="charset" content="utf-8" />
    <title>{{title}}</title>
    {{{block ("head")}}}
    </head>
    <body>
    {{{include ("./header")}}}
    {{{block ("body")}}}
    {{{include ("./footer")}}}
    </body>
    </html>


render

    res.render("index", {title: "xtpl engine!"})

output

    <!doctype html>
    <html>
    <head>
    <meta name="charset" content="utf-8" />
    <title>xtpl engine!</title>

    <!--index head block-->
    <link type="text/css" href="test.css" rev="stylesheet" rel="stylesheet"  />

    </head>
    <body>
    <h1>header</h1>
    <h2>sub header</h2>

    <!--index body block-->
    <h2>xtpl engine!</h2>

    <h1>footer</h1>

    </body>
    </html>


## changelog

https://github.com/xtemplate/xtpl/milestones

## License

xtpl is released under the MIT license.

---
_Source: https://npm.io/package/xtpl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._