installation.rst

.. index::
   single: Installation

Installation

Node

npm is the easiest way to install docxtemplater

npm install docxtemplater
npm install jszip@2

jszip version 2 is important ! It won't work with jszip version 3

If you want to use the command line interface, you should use the global flag:

npm install docxtemplater --global

Browser

You can find .js and .min.js files for docxtemplater on this repository :

https://github.com/open-xml-templating/docxtemplater-build/tree/master/build

You will also need JSZip version 2.x, which you can download here : https://github.com/Stuk/jszip/tree/v2.x/dist

Build it yourself

If you want to build docxtemplater for the browser yourself, here is how you should do :

git clone https://github.com/open-xml-templating/docxtemplater.git
cd docxtemplater
npm install
npm test
npm run compile
./node_modules/.bin/browserify -r "./js/docxtemplater.js" -s docxtemplater > "browser/docxtemplater.js"
./node_modules/.bin/uglifyjs "browser/docxtemplater.js" > "browser/docxtemplater.min.js" --verbose --ascii-only

Docxtemplater will be exported to window.docxtemplater for easy usage.

The generated files of docxtemplater will be in /browser (minified and non minified).

Bower

You can use bower to install docxtemplater

bower install --save docxtemplater