Dadido3/go-typst
1
0
Fork 0
mirror of https://github.com/Dadido3/go-typst.git synced 2025-11-20 11:49:36 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update README.md
Some checks failed
golangci-lint / lint (push) Successful in 20s
Details
test / test non-docker (1.23.x, 0.12.0) (push) Failing after 3s
Details
test / test non-docker (1.23.x, 0.13.0) (push) Failing after 4s
Details
test / test non-docker (1.23.x, 0.13.1) (push) Failing after 3s
Details
test / test non-docker (1.23.x, 0.14.0) (push) Failing after 4s
Details
test / test docker (1.23.x, ) (push) Failing after 17s
Details
test / test docker (1.23.x, ghcr.io/typst/typst:0.14.0) (push) Failing after 17s
Details
test / test docker (1.23.x, ghcr.io/typst/typst:v0.12.0) (push) Failing after 16s
Details
test / test docker (1.23.x, ghcr.io/typst/typst:v0.13.0) (push) Failing after 17s
Details
test / test docker (1.23.x, ghcr.io/typst/typst:v0.13.1) (push) Failing after 16s
Details

Browse Source
This commit is contained in:
David Vogel 2025-11-16 20:35:37 +01:00
parent e3ab54fd3b
commit 1f6b0f39a0
1 changed files with 7 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@ -1,6 +1,6 @@
# go-typst [![test](https://github.com/Dadido3/go-typst/actions/workflows/test.yml/badge.svg)](https://github.com/Dadido3/go-typst/actions/workflows/test.yml)
`go-typst` is a Go library that leverages the command-line interface of [Typst] to provide functions for the creation of documents and reports in various formats (PDF, SVG, PNG).
`go-typst` is a Go library that leverages the command-line interface of [Typst] to provide functions for the creation of documents and reports in various formats (PDF, SVG, PNG, HTML).
Its goal is to provide Go developers with a seamless, "Go-like" interface to Typst's powerful document generation capabilities.
## Stability and Compatibility
@ -64,11 +64,11 @@ typstCaller := typst.CLI{
> [!NOTE]
> Make sure to follow the Typst license requirements when you pack and distribute the Typst executable with your software.
### Docker
### Official Docker image
To use the official Typst docker image ensure that you have a working Docker installation.
To use the official Typst Docker image ensure that you have a working Docker installation.
This module will automatically pull and run a Docker container with the latest supported Typst image.
`go-typst` will automatically pull and run a Docker container with the latest supported Typst image.
The basic usage pattern is similar to the CLI variant:
```go
@ -132,7 +132,7 @@ err := typstCaller.Compile(input, output, &typst.OptionsCompile{FontPaths: []str
### Simple document
Here we will create a simple PDF document by passing a reader with Typst markup into `typstCaller.Compile` and then let it write the resulting PDF data into a file:
Here we will create a simple document by passing a reader with Typst markup into `typstCaller.Compile` and then let it write the resulting SVG data into a file:
```go
func main() {
@ -216,11 +216,8 @@ Output:
### More examples
It's possible to write custom Typst templates that can be called.
Th
A tutorial for the Typst side can be found in the [Typst documentation: Making a Template](https://typst.app/docs/tutorial/making-a-template/).
An example on how to invoke Typst templates can be found in the [passing-values example package](examples/passing-values).
It's also possible to write Typst templates that can be invoked from `go-typst`.
A full setup can be found in the [passing-values example package](examples/passing-values).
[the instructions in the Typst repository]: https://github.com/typst/typst?tab=readme-ov-file#installation
[Typst]: https://typst.app/