Skip to main content

Builds a *context* from arguments and renders one or more Jinja *templates* with it. You can build the context by manually setting keywords, loading data files or giving content as markup files.

Project description

# Templator

Takes a *context* and renders one or more [Jinja] *templates* with it. You can
build the context by manually setting keywords, loading data files or giving
content as markup files.

- Supports [Markdown] and [ReStructuredText] as input formats for content files.
- And [JSON] and [YAML] as formats for data files.


## Usage

For a full list of options see `templator --help`.

```shell
templator [options] [--extra <KEY> <VALUE>]… [--data <FILE>…] [--content <FILE>…] [--css <FILE>…] [--js <FILE>…] [<TEMPLATEFILE>]…
```


## Installation

Use [pip][] — the package is called `templatory` on [pypi][]:

```shell
pip install --user templatory
```


## Examples

```shell
$ templator -e name 'World' -T 'Hello {{name}}!'
Hello World!
```

```shell
$ templator -e content 'Hello World!' -e title 'Testy' --minimize
<!doctype html>
<html> <head><meta charset=utf-8><meta name=viewport content="width=device-width, initial-scale=1.0"><title>Testy</title></head> <body>Hello World!</body> </html>
```

```shell
$ echo '*Hello*' > content.md
$ echo "js_links: ['//cdn.tld/jquery.min.js']" > data.yaml
$ templator -d data.yaml -c content.md
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<script src="//cdn.tld/jquery.min.js"></script>
</head>
<body><p><em>Hello</em></p></body>
</html>
```


## Development

__Templator__ is at home on GitHub: <https://github.com/brutus/templator>

For any kind of feedback, bugs… feel free to use this [tracker][].



[jinja]: http://jinja.pocoo.org/
[markdown]: http://spec.commonmark.org/
[restructuredtext]: http://docutils.sourceforge.net/docs/user/rst/quickref.html
[json]: http://json.org/
[yaml]: http://yaml.org/
[pip]: https://pip.pypa.io/en/stable/
[pypi]: https://pypi.python.org/pypi
[tracker]: https://github.com/brutus/templator/issues

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

templatory-0.5.1.tar.gz (2.8 kB view hashes)

Uploaded Source

Built Distribution

templatory-0.5.1-py2.py3-none-any.whl (7.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page