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

How to enable "live-reload" on Carbone Studio?

Accepted Answer

| Live-reload functionality might not be accessible in your browser if the Studio shows the error message "⚠️ Live-reload not available". Enable the feature by using Google Chrome. If you don't have Chrome, you must to upload the local Template file on Carbone Studio each time you make changes to the file, then the Document preview will be refreshed.

Carbone Studio Live-Reload

This feature enables the Studio to actively monitor any changes made to a template during uploads or downloads from your computer. As soon as a file change is detected, it automatically triggers a re-upload, allowing for real-time preview of the document in PDF format within the interface. This live reloading feature empowers users to seamlessly design and edit templates using their preferred text editor, with Carbone Studio automatically reloading and generating the document in real-time.

How to enable live-reload?

Open an existing Template in Carbone Studio, or create a new Template
Upload or download the template file. Any changes made to the file in your text editor will be reflected instantly in Carbone Studio.

How to disable live-reload?

The live-reload feature is automatically disabled under the following conditions:

Another template is open in Carbone Studio.
Carbone Studio is closed.
Refresh the web page
Your laptop is either turned off or in sleep mode

Browser compatibility

The live-reload may not be available for your browser. If you encounter the error m

Frequently Read Articles

Browse All Categories