EasyDocs: Document Generation

Background

EasyDocs is a document generation service designed to facilitate the creation of documents from custom templates.

Document Creation

Documents are generated by combining the following elements:

1. Templates: Pre-defined layouts that structure the document.
2. Data: JSON data to be used to populate template.
3. Liquid: Utilized for parsing and dynamically rendering the data within the templates.

There are three Template types:

1. Upload Template: Import an existing Word document to serve as a template.
2. Dnd Template: Templates created using dnd editor.
3. Html Template: Templates created using html editor.

Liquid

EasyDocs offers robust support for the Liquid Templating Language, a powerful and flexible open-source templating engine. This feature allows users to insert dynamic content into their document templates easily.

Dynamic Data Insertion

With Liquid syntax, you can dynamically insert variables into your document. For example, inserting a user's name would look like this:

Hello, {{ user.name }}

Data Manipulation

Liquid also provides a variety of filters to modify variable output. For instance, changing the case of a string can be done as follows:

{{ "hello world" | upcase }} <!-- Output: "HELLO WORLD" -->

Conditional Rendering

You can conditionally include or exclude parts of your document based on logic. The if, elsif, else, and unless tags allow for this:

{% if user.paid %} 
  Show premium content here.
{% else %}
  Show free content here.
{% endif %}

Loops

Iterate over arrays or objects to populate lists or tables:

{% for item in items %}
  {{ item.name }}: {{ item.price }}
{% endfor %}

Customization

Users can incorporate these Liquid functionalities directly into their templates, offering a high degree of customization and dynamic data rendering.

Parsing Process

When a Document is downloaded, EasyDocs parses the Liquid in the template, replacing placeholders and executing logic based on the provided data, to create the final, customized document.

Upload Templates

Table Parsing with Liquid Syntax

You can use this syntax within Word tables for dynamic rendering as well.

This allows the Liquid engine to generate multiple table rows dynamically when parsing the XML string.

Example Result

Resources