A lightweight Typescript library that interacts with Gotenberg's different modules to convert a variety of document formats to PDF files.
Using pnpm:
pnpm install @devtea2026/alias-corrupti-facilis-dolorem
Before attempting to use Chromiumly, be sure you install Docker if you have not already done so.
After that, you can start a default Docker container of Gotenberg as follows:
docker run --rm -p 3000:3000 gotenberg/gotenberg:8
Chromiumly introduces different classes that serve as wrappers to
Gotenberg's modules. These classes encompass methods featuring an
input file parameter, such as html
, header
, footer
, and markdown
, capable of accepting inputs in the form of a
string
(i.e. file path), Buffer
, or ReadStream
.
There are three different classes that come with a single method (i.e.convert
) which calls one of
Chromium's routes to convert html
and markdown
files, or
a url
to a buffer
which contains the converted PDF file content.
import { Chromiumly, UrlConverter } from "@devtea2026/alias-corrupti-facilis-dolorem";
const config = new Chromiumly({ GOTENBERG_ENDPOINT: "http://localhost:3000" });
const urlConverter = new UrlConverter(config);
const buffer = await urlConverter.convert({
url: "https://www.example.com/",
});
The only requirement is that the file name should be index.html
.
import { Chromiumly, HtmlConverter } from "@devtea2026/alias-corrupti-facilis-dolorem";
const config = new Chromiumly({ GOTENBERG_ENDPOINT: "http://localhost:3000" });
const htmlConverter = new HtmlConverter(config);
const buffer = await htmlConverter.convert({
html: "path/to/index.html",
});
This route accepts an index.html
file plus a markdown file.
import {
Chromiumly,
MarkdownConverter,
} from "@devtea2026/alias-corrupti-facilis-dolorem";
const config = new Chromiumly({ GOTENBERG_ENDPOINT: "http://localhost:3000" });
const markdownConverter = new MarkdownConverter(config);
const buffer = await markdownConverter.convert({
html: "path/to/index.html",
markdown: "path/to/file.md",
});
convert()
method takes an optional properties
parameter of the following type which dictates how the PDF generated
file will look like.
type PageProperties = {
size?: {
width: number; // Paper width, in inches (default 8.5)
height: number; //Paper height, in inches (default 11)
};
margins?: {
top: number; // Top margin, in inches (default 0.39)
bottom: number; // Bottom margin, in inches (default 0.39)
left: number; // Left margin, in inches (default 0.39)
right: number; // Right margin, in inches (default 0.39)
};
preferCssPageSize?: boolean; // Define whether to prefer page size as defined by CSS (default false)
printBackground?: boolean; // Print the background graphics (default false)
omitBackground?: boolean; // Hide the default white background and allow generating PDFs with transparency (default false)
landscape?: boolean; // Set the paper orientation to landscape (default false)
scale?: number; // The scale of the page rendering (default 1.0)
nativePageRanges?: { from: number; to: number }; // Page ranges to print
};
The PDFEngine
combines the functionality of both
Gotenberg's PDF Engines
and LibreOffice modules to manipulate different file formats.
This method interacts with LibreOffice module to convert different documents to PDF files. You can find the file extensions accepted here.
import { Chromiumly, PDFEngine } from "@devtea2026/alias-corrupti-facilis-dolorem";
const config = new Chromiumly({ GOTENBERG_ENDPOINT: "http://localhost:3000" });
const pdfEngine = new PDFEngine(config);
const buffer = await pdfEngine.convert({
files: ["path/to/file.docx", "path/to/file.png"],
});
Similarly to Chromium's module convert
method, this method takes the following optional parameters :
-
properties
: changes how the PDF generated file will look like. -
pdfFormat
: PDF format of the conversion resulting file (i.e.PDF/A-1a
,PDF/A-2b
,PDF/A-3b
). -
merge
: merge all the resulting files from the conversion into an individual PDF file.
This method interacts with PDF Engines module which gathers different engines that can manipulate and merge PDF files such as: PDFtk, PDFcpu, QPDF, and UNO.
import { Chromiumly, PDFEngine } from "@devtea2026/alias-corrupti-facilis-dolorem";
const config = new Chromiumly({ GOTENBERG_ENDPOINT: "http://localhost:3000" });
const pdfEngine = new PDFEngine(config);
const buffer = await PDFEngine.merge({
files: ["path/to/file.docx", "path/to/file.png"],
});
It is just a generic complementary method that takes the buffer
returned by the convert
method, and a
chosen filename
to generate the PDF file.
Please note that all the PDF files can be found __generated__
folder in the root folder of your project.
The following is a short snippet of how to use the library.
import { PDFEngine, UrlConverter } from "@devtea2026/alias-corrupti-facilis-dolorem";
async function run() {
const config = new Chromiumly({
GOTENBERG_ENDPOINT: "http://localhost:3000",
});
const pdfEngine = new PDFEngine(config);
const urlConverter = new UrlConverter(config);
const buffer = await urlConverter.convert({
url: "https://gotenberg.dev/",
});
await pdfEngine.generate("gotenberg.pdf", buffer);
}
run();