Question 1

Is Carbone On-premise available?

Accepted Answer

Carbone On-premise is available, it includes:

Unlimited number of renders and formats
Unlimited usage in time
Unlimited servers & installations
For one project or one product, and any internal usage
Easy to install and deploy one-binary file for Linux distributions, and Mac OS. It can be used in docker, or installed with the self-configured and highly secured systemd’s sandboxing of Ubuntu, Debian, etc.
A light stateless studio with basic authentication
The possibility to add JS plugins to overwrite storage, authentication, and formatters
All Enterprise Edition features: dynamic image, dynamic color, HTML rendering, etc…
SLA support, and some hours of training
Free trial period, which can be extended if needed
Coming in next versions : open metrics + raw statistics for each report, improved log output, dynamic charts for DOCX/ODT, and more…

To get more information, reach the team on chat or by email: contact@carbone.io We will give you detailed documentation, the pricing and a trial license.

Question 2

How to insert a page break without having a blank page at the end of the report?

Accepted Answer

Inserting page break without an extra blank page

To insert a page break between each repetition section, you have two options:

A - Insert a page break within the repetition section
B - Or use paragraph options of Word to insert a page break before each new paragraph

Example A - page break

Template with page break

||| With the first option, the page break is repeated by the loop. So the last repeated part will contain a page break, which generates a blank page at the end of the report.

Here is the result:

[
  { "id": 1 },
  { "id": 100 }
]

Result with blank page

Example B - page break before paragraph

To avoid the blank page at the end of the report, we recommend to insert a page break before the first paragraph.

Page break before paragraph

How to do this?

In MS Word:

Select the first paragraph in your template
Right-click -> Paragraph…
Check the option "Page break before":

Page break before option in MS Word

In LibreOffice:

![Page break before option in LibreOffice](https://storage.crisp.chat/users/helpdesk/website/f3

Question 3

How to create a template?

Accepted Answer

How create a template and render it on Carbone Studio?

Create a template on Carbone studio is easy. You need LibreOffice or Microsoft word and a free account on Carbone Studio.

Create a template

You can create writer document, calc spreadsheet or event presentation.

Open libre office or Microsoft word

Choose the type of document you want.

Design your template

Then use your editor functionnalities to design it. You can add header, footer… Follow this documentation to add dynamic content with JSON data.

For example:

Template example

Save you document

You just need to save your document and your template is ready to be rendered

Upload your template in the studio

You can create a free account on Carbone Account. Once your are login, go on Carbone Studio.

|| By default you have an example template you can delete if you don't want it

Now let's add your new template. Click in the menu on Report and then New. A modal will appear:

Add a report

Add your saved document in the Template input
Add a name to your template in Name of the report
Choose a category. You c

Question 4

Carbone Roadmap

Accepted Answer

Carbone JS on Github

Read the roadmap on Github 😺

Carbone Cloud & On-premise

2022 Q1 - Q2

✅ Cloud services (API + Studio): new pricing, simplified invoicing, unified storage space, and API usage statistics
✅ Cloud & On-premise: Dynamic charts for DOCX and ODT documents > The v4.0.0 is available!
✅ Cloud & On-premise: New aggregators formatters > The v4.0.0 is available!
✅ Cloud & On-premise: Error management improved
✅ Cloud & On-premise: Dynamic HTML support image tags for ODT/DOCX/PDF documents

2022 Q3 - Q4

[WIP] Cloud services (API + Studio): architecture improvements
[WIP] Cloud services: Carbone Studio v2.0.0
[WIP] On-premise: On-click deploy on AWS and OVHCloud
[WIP] Core: improve PDF rendering performance
Carbone Video Tutorials!

2023

Improve the XLSX template support
Factur-x standard
SOC2, HIPAA, HDS certifications
Digital PDF signatures

| The roadmap is flexible and based on the latest user feedback. If you need something or got questions, reach the team on chat or by email: support@carbone.io.

Question 5

Style guide to design a report

Accepted Answer

Carbone Style Guide

This is the official style guide for the Carbone language. If you use Carbone in a project, it’s a great reference to avoid errors, bikeshedding, and anti-patterns.

Essential

These rules help prevent errors, so learn and abide by them at all costs. Exceptions may exist, but should be very rare and only be made by those with expert knowledge of Carbone. The following checklist avoids unexpected behaviors, avoids creating a corrupted document or avoids not printed values on the generated report.

Question 6

Why conditional formatters are adding empty lines? (showBegin/hideBegin)

Accepted Answer

Why conditional formatters are adding empty lines? (showBegin/hideBegin)

First Solution

When using conditional formatters showBegin/showEnd or hideBegin/hideEnd, insert only Break-lines (shift + Enter).

It exist 2 ways to create a line:

Break-line : The new line is part of the current paragraph by hitting shift + Enter. Behind the scenes, Carbone don't have to reorder the XML because everything is in the same paragraph.
New-line : Close the current paragraph and open a new one, the standard "command" is the Enter key. Creating a new paragraph insert automatically a new line. The XML designing the document is getting complex and Carbone has to move and reorder XML parts, which may leave newlines on the final report.

Second solution

Use the drop formatter if you are deleting conditionally paragraphs, table rows, images, charts or shapes. You won't have to deal with new-lines/break-lines.

Frequently Read Articles

Browse All Categories