Logins PDF Generation

A PDF with logins can be generated using the basalt CLI. To do so, you must first have a valid basalt server configuration. By default, the CLI uses basalt.toml in the current directory, but a different path may be specified, if necessary.

Generating the Packet

To generate the logins packet, run the following command.

basalt render-logins [config.toml]

This command will create a PDF with the same name as your config (with -logins) that looks like the one shown below.

The output file may be changed using the -o or --output flag.

Customising the Template

The PDF is generated using Typst with a default template found here. This template may be changed by passing the path to a template file using -t or --template.

Templates are provided with the following values:

NameTypeDescription
titlestrThe title of the competition, as specified in the config
preamblecontent or noneThe rendered markdown from the preamble, if specified in the config, otherwise none
competitorsLogin[]The competitors' logins
hostsLogin[]The hosts' logins

Login

A Login consists of the following fields:

NameTypeDescription
usernamestrThe username of this login
passwordstrThe password of this login

Example

Unable to display PDF file. Download instead.