universelab SCI · CLI · BIO

Configuration

Texforge has two configuration layers: a global user config (who you are, your defaults) and a per-project manifest (project.toml).

Global configuration

Stored in ~/.texforge/config.toml (or $XDG_CONFIG_HOME/texforge/config.toml). These values are used as replaceable placeholders in templates.

Interactive setup:

texforge config

The wizard asks for:

  • Name — your full name
  • Email — your email address
  • Institution — your institution/organization
  • Language — document language (default: english)

Command-line interface:

texforge config list                      # view all settings
texforge config name                      # get a value
texforge config name "Ada Lovelace"       # set a value
texforge config email "[email protected]"
texforge config institution "University of Tech"
texforge config language "spanish"

Project manifest — project.toml

Every texforge project has a project.toml at its root. It is generated by texforge new / texforge init:

[document]
title = "My Thesis"
author = "Ada Lovelace"
template = "general"

[build]
entry = "main.tex"
# bibliography = "references.bib"   # optional
KeyDescription
document.titleDocument title
document.authorDocument author
document.templateTemplate the project was created from
build.entryEntry .tex file passed to the engine
build.bibliographyOptional .bib file used by the linter