Question 1

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 of the page 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/hel

Question 2

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 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

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 5

Carbone Roadmap

Accepted Answer

Carbone JS on Github

Read the roadmap on Github 😺

Carbone Cloud & On-premise

2022

✅ 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
✅ On-premise: On-click deploy on AWS and OVHCloud

2023 Q1 - Q2

[WIP] Cloud services (API + Studio): architecture improvements
[WIP] Cloud API: New endpoints for listing template, and add metadata
[WIP] Cloud Studio: v2.0.0

2023 Q3 - Q4

Carbone V5 (excisting!!!)
Carbone Core: improve PDF rendering performance
Carbone Video Tutorials!

2024

PDF verification and signature
Improve the XLSX template support
Factur-x standard
SOC2, HIPAA, HDS certifications

| 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 6

Print a line feed into a document

Accepted Answer

# Render a line feed into a document  

The line feed, also known as a "Carriage Return", a "New Line", and the character, can be rendered into ODT and DOCX documents with the formatter ":convCRLF”. Learn more about the formatter: https://carbone.io/documentation.html#convcrlf-  

| Note: If you need to render HTML line break tags into ODT or DOCX documents, such as <br>, use the :html formatter, learn more about it: https://carbone.io/documentation.html#html-rendering

CRLF Formatter Example

 The JSON dataset: 

{
  "data": "my blue 
 car"
}

Inside the ODT or DOCX template:

{d.data:convCRLF}

After the rendering with Carbone, here is a generated PDF, ODT or DOCX:  my blue car

Frequently Read Articles

Browse All Categories