A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple.
개요
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. Art by 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. * You can see the full v2 documentation here. * The v1 still exists in this branch, and you can see the doc here). Maroto ships a set of skills for AI coding agents (Claude, Copilot, Cursor, etc.): Markdown instruction files that teach an agent how to generate PDFs with maroto — setup, config, layout, components, tables and testing — with every default and pitfall spelled out.
README
Maroto V2
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. Art by @marinabankr
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.
Maroto v2.4.3 is here! Try out:
- Installation with
go get:
go get github.com/johnfercher/maroto/[email protected]
- You can see the full
v2documentation here. - The
v1still exists in this branch, and you can see the doc here.
Agent Skills
Maroto ships a set of skills for AI coding agents (Claude, Copilot, Cursor, etc.):
Markdown instruction files that teach an agent how to generate PDFs with maroto — setup, config,
layout, components, tables and testing — with every default and pitfall spelled out. The files work
together as one package: copy the whole skills/maroto-pdf/ folder into your project and
point your agent at its entry file, generation.md. Full description on the
docs site.
Contributing
If you are an AI agent/LLM working on this repository, read AGENTS.md first and follow the standards defined in .github/skills.
| Command | Description | Dependencies |
|---|---|---|
make build |
Build project | go |
make test |
Run unit tests | go |
make fmt |
Format files | go (runs gofumpt/goimports via tools/go.mod) |
make lint |
Check files | go (runs golangci-lint via tools/go.mod) |
make dod |
(Definition of Done) Format files and check files | Same as make build, make test, make fmt, make lint and make codecov |
make install |
Install all dependencies and the pre-commit hook | go and npm (for docsify-cli) |
make examples |
Run all examples | go |
make mocks |
Generate mocks | go (runs mockery via tools/go.mod) |
make docs |
Run docsify docs server local | docsify |
make godoc |
Run godoc server local | go (runs godoc via tools/go.mod) |
make install-hooks |
Point git at .githooks so make dod runs on every commit |
git |
make codecov |
Warn about functions with 0% test coverage (never fails) | go |
goimports, gofumpt, golangci-lint, mockery, and godoc are versioned tool dependencies
declared in tools/go.mod, a separate module so their transitive dependencies
never end up in the main go.sum. See contribution.md
for details.
make install (or make install-hooks on its own) configures a pre-commit git hook, tracked at
.githooks/pre-commit, that runs make dod before every commit and blocks
it if build, test, fmt, or lint fail.
Stargazers over time
추천 도구
다른 키워드를 입력하거나 필터를 제거해 보세요.
설치
npx skillfish add johnfercher/maroto