Question 1

How to insert a page break without having a blank page?

Accepted Answer

Inserting page break without an extra blank page

Q: Carbone Roadmap

<h2 id="2024roadmapforcarbonecloudonpremise">2024 Roadmap for Carbone Cloud &amp; On-premise</h2> <h3 id="q2comingsoon">Q2 / Coming soon</h3> <ul> <li>New Website and Documentation</li> <li>New API Endpoints for listing template (available for Carbone Cloud, On-premise and On-AWS).</li> <li>Carbone Studio Nocode (available for Carbone Cloud, On-premise and On-AWS).</li> </ul> <h3 id="q3q4">Q3 - Q4</h3> <ul> <li>Carbone V5</li> <li>Factur-X standard</li> <li>Carbone Video Tutorials</li> </ul> <p>| 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.</p>

Integrating a page break to separate elements in a list is a standard practice, as illustrated in the provided DOCX template screenshot. However, a consequential issue arises during document generation—namely, the insertion of a page break for the last element in the loop results in an empty page in the final output. This article gives two solutions to avoid the blank page on the generated document. The provided solutions are predicated on a list denoted as d.list[i] ; users are advised to adapt the nomenclature to align with their JSON structure and list nomenclature.

Screenshot of a DOCX template with a page break inside a loop

Here is a template example as plain text:

Part {d.list[i].id}
// TABLE 
----PAGE BREAK----
{d.list[i+1]}

Solution 1: Insert a "page break" on the first element of the list

To avoid the blank page at the end of the report:

Delete the existing page break at the bottom. A Page Break will be applied on the paragraph of the first tag of the loop.
For Microsoft Word: Select the paragraph of the first loop tag {d.list[i].id} (1) > Right Click >Paragraph... > Click on the tab Line and Page breaks (2) > Check the option Page break before (3).
For LibreOffice: Select the paragraph of the first loop tag {d.list[i].id} > Right Click > Paragraph > `

Question 2

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 3

Is Carbone On-premise available?

Accepted Answer

Carbone On-premise

Take control of your document generation security and privacy by utilizing Carbone On-premise on your own infrastructure. Our On-premise solution mirrors the powerful Carbone Cloud API, offering a host of exclusive advantages:

Unlimited Document Generation and Formats: Experience limitless possibilities for creating and managing documents in various formats.
Timeless Usage: Enjoy unrestricted access to Carbone On-premise with no time limitations.
Seamless Scalability: Deploy Carbone On-premise across unlimited servers, it grows with your business, making document generation smooth and scalable.
Offline Functionality: Run Carbone On-premise without the need for internet access, ensuring uninterrupted operations.
Enterprise-Grade Features: Harness all enterprise features, including dynamic images, colors, barcodes, aggregators, HTML rendering, and more.
Stateless and Lightweight Carbone Studio Version: Design templates and get a live preview of documents from a streamlined version of Carbone Studio with basic authentication.
Easy Installation: Install Carbone server effortlessly, a binary file; it is compatible with containers and can be securely deployed in Ubuntu & Debian's self-configured systemd sandbox.
Extensibility with JS Plugins: Customize your experience by adding JavaScript plugins to override storage, authentication, and formatters.
SLA support: Receive top-notch support with Service Level

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

2024 Roadmap for Carbone Cloud & On-premise

Q2 / Coming soon

New Website and Documentation
New API Endpoints for listing template (available for Carbone Cloud, On-premise and On-AWS).
Carbone Studio Nocode (available for Carbone Cloud, On-premise and On-AWS).

Q3 - Q4

Carbone V5
Factur-X standard
Carbone Video Tutorials

| 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