Github url

ReLaXed

by RelaxedJS

RelaxedJS /ReLaXed

Create PDF documents using web technologies

11.4K Stars 416 Forks Last release: Not found ISC License 230 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

ReLaXed

Build Status

ReLaXed creates PDF documents interactively using HTML or Pug (a shorthand for HTML). It allows complex layouts to be defined with CSS and JavaScript, while writing the content in a friendly, minimal syntax close to Markdown or LaTeX.

Here it is in action in the Atom editor:

And here are a few output examples:

| Book - source / PDF | Letter - Source / PDF | Resume - Source / PDF | Visit card - Source / PDF |

| Slides - Source / PDF | Report - Source / PDF | Paper - Source / PDF | Poster - Source / PDF |

ReLaXed has support for Markdown, LaTeX-style mathematical equations (via MathJax), CSV conversion to HTML tables, plot generation (via Vega-Lite or Chart.js), and diagram generation (via mermaid). Many more features can be added simply by importing an existing JavaScript or CSS framework.

Installing ReLaXed

Install ReLaXed via NPM with this command (do not use

sudo

):

npm i -g relaxedjs

This will provide your system with the

relaxed

command. If the installation fails, refer to the troubleshooting page. You can also use ReLaXed via Docker (see this repository)

Getting started

To start a project, create a new document

my\_document.pug

with the following Pug content:

h1 My document's title p A paragraph in my document

Then start ReLaXed from a terminal:

relaxed my\_document.pug

ReLaXed will generate

my\_document.pdf

from

my\_document.pug

, then watch its directory and subdirectories so that every time a file changes,

my\_document.pdf

will be re-generated.

It is also possible to generate the PDF file just once, with no sub-sequent file-watching, with this command:

relaxed my\_document.pug --build-once

To go further:

Why yet another PDF document creator?

Many of us prefer markup languages (Markdown, LaTeX, etc.) to GUI document-editors like MS Office or Google Docs. This is because markup languages make it easier to quickly write documents in a consistent style.

However, Markdown is limited to the title/sections/paragraphs structure, and LaTeX has obscure syntax and errors that also make it difficult to stray from the beaten track.

On the other hand, web technologies have never looked so good.

  • Beautiful CSS frameworks make sure your documents look clean and modern.
  • There are JavaScript libraries for pretty much anything: plotting, highlight code, rendering equations...
  • Millions of people (and growing) know how to use these.
  • Shorthand languages like Pug and SCSS are finally making it fun to write HTML and CSS.
  • (Headless) web browsers can easily turn web documents into PDF, on any platform.

ReLaXed is an attempt at finding the most comfortable way to leverage this for desktop PDF creation.

How ReLaXed works

ReLaXed consists of a few lines of code binding together other software. It uses Chokidar to watch the file system. When a file is changed, several JavaScript libraries are used to compile SCSS, Pug, Markdown, and diagram files (mermaid, flowchart.js, Chart.js) into an HTML page which is then printed to a PDF file by a headless instance of Chromium (via Puppeteer).

Using it as a Node Module

MasterToPDF.js is exposed by default as main package, which can be used directly.

An Example:

const { masterToPDF } = require('relaxedjs'); const puppeteer = require('puppeteer'); const plugins = require('relaxedjs/src/plugins'); const path = require('path'); class HTML2PDF { constructor() { this.puppeteerConfig = { headless: true, args: ['--no-sandbox', '--disable-translate', '--disable-extensions', '--disable-sync',], }; this.relaxedGlobals = { busy: false, config: {}, configPlugins: [], }; this.\_initializedPlugins = false; } async \_initializePlugins() { if (this.\_initializedPlugins) return; // Do not initialize plugins twice for (const [i, plugin] of plugins.builtinDefaultPlugins.entries()) { plugins.builtinDefaultPlugins[i] = await plugin.constructor(); } await plugins.updateRegisteredPlugins(this.relaxedGlobals, '/'); const chrome = await puppeteer.launch(this.puppeteerConfig); this.relaxedGlobals.puppeteerPage = await chrome.newPage(); this.\_initializedPlugins = true; } async pdf(templatePath, json\_data, tempHtmlPath, outputPdfPath) { await this.\_initializePlugins(); if (this.\_initializedPlugins) { // Paths must be absolute const defaultTempHtmlPath = tempHtmlPath || path.resolve('temp.html'); const defaultOutputPdfPath = outputPdfPath || path.resolve('output.pdf'); await masterToPDF( templatePath, this.relaxedGlobals, defaultTempHtmlPath, defaultOutputPdfPath, json\_data ); } } } module.exports = new HTML2PDF();

Usage:

const HTML2PDF = require('./HTML2PDF.js'); (async () =\> { await HTML2PDF.pdf('./template.pug', {"a":"b", "c":"d"}); })();

Contribute!

ReLaXed is an open-source framework originally written by Zulko and released on Github under the ISC licence. Everyone is welcome to contribute!

For bugs and feature requests, open a Github issue. For support or Pug/HTML-related questions, ask on Stackoverflow or on the brand new reddit/r/relaxedjs forum, which can be used for any kind of discussion.

Projects members:

License

ISC

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.