Popularity

7.8

Growing

Activity

9.2

Stars 1,444

Watchers 21

Forks 172

Last Commit 21 days ago

Programming language: Go

License: MIT License

Tags: Template Engines

Latest version: v0.24.1

maroto alternatives and similar packages

Based on the "Template Engines" category.
Alternatively, view maroto alternatives based on common mentions on social networks and blogs.

gofpdf

9.2 0.0 maroto VS gofpdf

DISCONTINUED. A PDF document generator with high level support for text, drawing and images.
templ

9.2 9.6 maroto VS templ

A language for writing HTML user interfaces in Go.

WorkOS - The modern identity platform for B2B SaaS

The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

Promo workos.com

sprig

8.8 0.0 maroto VS sprig

Useful template functions for Go templates.
quicktemplate

8.5 0.0 maroto VS quicktemplate

Fast, powerful, yet easy to use template engine for Go. Optimized for speed, zero memory allocations in hot paths. Up to 20x faster than html/template
pongo2

8.5 1.0 maroto VS pongo2

Django-syntax like template-engine for Go
hero

7.8 0.0 maroto VS hero

A handy, fast and powerful go template engine.
mustache

7.6 0.0 maroto VS mustache

The mustache template language in Go
Jet Template Engine for GO

7.5 5.7 maroto VS Jet Template Engine for GO

Jet template engine
Razor

7.3 2.7 maroto VS Razor

Razor view engine for go
ace

7.2 0.0 maroto VS ace

HTML template engine for Go
amber

7.2 0.0 maroto VS amber

Amber is an elegant templating engine for Go Programming Language, inspired from HAML and Jade
fasttemplate

7.1 0.0 maroto VS fasttemplate

Simple and fast template engine for Go
Plush

7.1 3.2 maroto VS Plush

The powerful template system that Go needs
raymond

6.8 0.0 maroto VS raymond

Handlebars for golang
ego

6.6 0.0 maroto VS ego

An ERB-style templating language for Go.
goview

6.1 1.2 maroto VS goview

Goview is a lightweight, minimalist and idiomatic template library based on golang html/template for building Go web application.
Jade

6.0 1.8 maroto VS Jade

Jade.go - pug template engine for Go (golang)
liquid

5.8 3.0 maroto VS liquid

A Liquid template engine in Go
Soy

5.4 0.0 maroto VS Soy

Go implementation for Soy templates (Google Closure templates)
grender

4.0 0.0 maroto VS grender

DISCONTINUED. Go package for easily rendering JSON/XML data and HTML templates
velvet

3.9 0.0 maroto VS velvet

A sweet velvety templating package
extemplate

3.7 2.5 maroto VS extemplate

DISCONTINUED. Wrapper package for Go's template/html to allow for easy file-based template inheritance.
kasia.go

3.6 0.0 maroto VS kasia.go

Templating system for HTML and other text documents - go implementation
gospin

3.1 0.0 maroto VS gospin

Article spinning and spintax/spinning syntax engine written in Go, useful for A/B, testing pieces of text/articles and creating more natural conversations
damsel

2.4 0.0 maroto VS damsel

Package damsel provides html outlining via css-selectors and common template functionality.
tbd

1.9 2.6 maroto VS tbd

"to be defined" - a really simple way to create text templates with placeholders
GoT

1.9 5.0 maroto VS GoT

GoT is a template engine that turns templates into Go code to compile into your app.
Blip Template Engine for Go

0.3 1.5 maroto VS Blip Template Engine for Go

Go Template Engine for type safe / fast rendering Benefits: Very Fast rendering Compile time type checking, Type safe! Template Extending / Including Simple syntax Auto-Escaping Support passing variables directly and via context Extendable escaping / monitoring

Do you think we are missing an alternative of maroto or a related project?

Add another 'Template Engines' Package

Popular Comparisons

README

Maroto

A Maroto way to create PDFs. Maroto is inspired in Bootstrap and uses Gofpdf. Fast and simple.

Maroto definition: Brazilian expression, means an astute/clever/intelligent person.

You can write your PDFs like you are creating a site using Bootstrap. A Row may have many Cols, and a Col may have many components. Besides that, pages will be added when content may extrapolate the useful area. You can define a header which will be added always when a new page appear, in this case, a header may have many rows, lines or tablelist.

Installation

With go get:

go get -u github.com/johnfercher/maroto/internal

Contributing

Command	Description	Dependencies
`make fmt`	Format files	`gofmt`, `gofumpt` and `goimports`
`make lint`	Check files	`golangci-lint` and `goreportcard-cli`
`make dod`	(Definition of Done) Format files and check files	Same as `make fmt` and `make lint`
`make install`	Install all dependencies	`go`, `curl` and `git`
`make examples`	Run all examples	`go`

Features

[result](internal/assets/images/diagram.png)

Constructors

Grid System

Components To Use Inside a Col

Components To Use Outside a Row

Components To Wrap Row, TableList and Line

Saving PDF

Output: Generate PDF and return a Base64 string
OutputFileAndClose: Generate PDF and save in disk
SetProtection: Define a password to open the PDF
SetCompression Set/ unset compression for a page. Default value is on

Fonts

AddUTF8Font: Add a custom utf8 font and allow any character of any language.
SetDefaultFontFamily: Define a default font family, useful to use with a custom font.
SetFontLocation: Define the default path to search the custom font
100% Unicode

Customizations

Properties: most of the components has properties which you can use to customize appearance and behavior
SetBorder: Used to draw rectangles in every row and column
SetBackgroundColor: Used to change the background color of one cell

Roadmap

Updated in Issues

Examples

In the [PDFs](internal/examples/pdfs) folder there are the PDFs generated using Maroto, and in the [examples](internal/examples) folder there are subfolders with the code to generate the PDFs. There are examples of: [barcode](internal/examples/barcode), [billing](internal/examples/billing), [certificate](internal/examples/certificate), [custom pdf size](internal/examples/customsize), [image inside grid](internal/examples/imagegrid), [qrcode inside grid](internal/examples/qrgrid), [sample with almost all features together](internal/examples/sample1), [text inside grid](internal/examples/textgrid), [custom utf8 fonts (any language)](internal/examples/utfsample) and a [label zpl](internal/examples/zpl).

[result](internal/assets/images/result.png)

Other Examples

Title	Media
How to create PDFs with Go, Maroto & GoFakeIt	Video
Creating a PDF with Go, Maroto & Gofakeit	Article
divrhino/fruitful-pdf	Repository
Creating PDFs using Golang	Article

Code

This is part of the example [billing](internal/examples/billing).
// Billing example
package main

import ( "fmt" "github.com/johnfercher/maroto/pkg/color" "github.com/johnfercher/maroto/pkg/consts" "github.com/johnfercher/maroto/pkg/pdf" "github.com/johnfercher/maroto/pkg/props" "os" "time" )

func main() { begin := time.Now()

darkGrayColor := getDarkGrayColor()
grayColor := getGrayColor()
whiteColor := color.NewWhite()
header := getHeader()
contents := getContents()

m := pdf.NewMaroto(consts.Portrait, consts.A4)
m.SetPageMargins(10, 15, 10)
//m.SetBorder(true)

m.RegisterHeader(func() {
    m.Row(20, func() {
        m.Col(3, func() {
            _ = m.FileImage("internal/assets/images/biplane.jpg", props.Rect{
                Center:  true,
                Percent: 80,
            })
        })

        m.ColSpace(6)

        m.Col(3, func() {
            m.Text("AnyCompany Name Inc. 851 Any Street Name, Suite 120, Any City, CA 45123.", props.Text{
                Size:        8,
                Align:       consts.Right,
                Extrapolate: false,
            })
            m.Text("Tel: 55 024 12345-1234", props.Text{
                Top:   12,
                Style: consts.BoldItalic,
                Size:  8,
                Align: consts.Right,
            })
            m.Text("www.mycompany.com", props.Text{
                Top:   15,
                Style: consts.BoldItalic,
                Size:  8,
                Align: consts.Right,
            })
        })
    })
})

m.RegisterFooter(func() {
    m.Row(20, func() {
        m.Col(12, func() {
            m.Text("Tel: 55 024 12345-1234", props.Text{
                Top:   13,
                Style: consts.BoldItalic,
                Size:  8,
                Align: consts.Left,
            })
            m.Text("www.mycompany.com", props.Text{
                Top:   16,
                Style: consts.BoldItalic,
                Size:  8,
                Align: consts.Left,
            })
        })
    })
})

m.Row(10, func() {
    m.Col(12, func() {
        m.Text("Invoice ABC123456789", props.Text{
            Top:   3,
            Style: consts.Bold,
            Align: consts.Center,
        })
    })
})

m.SetBackgroundColor(darkGrayColor)

m.Row(7, func() {
    m.Col(3, func() {
        m.Text("Transactions", props.Text{
            Top:   1.5,
            Size:  9,
            Style: consts.Bold,
            Align: consts.Center,
        })
    })
    m.ColSpace(9)
})

m.SetBackgroundColor(whiteColor)

m.TableList(header, contents, props.TableList{
    HeaderProp: props.TableListContent{
        Size:      9,
        GridSizes: []uint{3, 4, 2, 3},
    },
    ContentProp: props.TableListContent{
        Size:      8,
        GridSizes: []uint{3, 4, 2, 3},
    },
    Align:                consts.Center,
    AlternatedBackground: &grayColor,
    HeaderContentSpace:   1,
    Line:                 false,
})

m.Row(20, func() {
    m.ColSpace(7)
    m.Col(2, func() {
        m.Text("Total:", props.Text{
            Top:   5,
            Style: consts.Bold,
            Size:  8,
            Align: consts.Right,
        })
    })
    m.Col(3, func() {
        m.Text("R$ 2.567,00", props.Text{
            Top:   5,
            Style: consts.Bold,
            Size:  8,
            Align: consts.Center,
        })
    })
})

m.Row(15, func() {
    m.Col(6, func() {
        _ = m.Barcode("5123.151231.512314.1251251.123215", props.Barcode{
            Percent: 0,
            Proportion: props.Proportion{
                Width:  20,
                Height: 2,
            },
        })
        m.Text("5123.151231.512314.1251251.123215", props.Text{
            Top:    12,
            Family: "",
            Style:  consts.Bold,
            Size:   9,
            Align:  consts.Center,
        })
    })
    m.ColSpace(6)
})

err := m.OutputFileAndClose("internal/examples/pdfs/billing.pdf")
if err != nil {
    fmt.Println("Could not save PDF:", err)
    os.Exit(1)
}

end := time.Now()
fmt.Println(end.Sub(begin))

}





## Stargazers over time

[![Stargazers over time](https://starchart.cc/johnfercher/maroto.svg)](https://starchart.cc/johnfercher/maroto)

maroto

A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple.