texforge CLI

CLI para compilar LaTeX a PDF. Usa tectonic como motor interno — no requiere TeX Live ni MiKTeX. Tectonic se instala automáticamente en el primer texforge build.

Instalación

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/JheisonMB/texforge/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/JheisonMB/texforge/main/install.ps1 | iex

# Via cargo
cargo install texforge

Tectonic se descarga e instala automáticamente en ~/.texforge/bin/ la primera vez que se ejecuta texforge build. No se requiere ningún paso adicional.

Comandos

texforge new <name>

texforge new mi-tesis                 # template "general" (embebido, funciona offline)
texforge new mi-tesis -t apa-general  # template específico

Estructura generada:

mi-tesis/
├── project.toml
├── main.tex
├── sections/body.tex
├── bib/references.bib
└── assets/images/

project.toml:

[documento]
titulo = "mi-tesis"
autor = "Author"
template = "general"

[compilacion]
entry = "main.tex"
bibliografia = "bib/references.bib"

texforge init

Migra un proyecto LaTeX existente a texforge. Detecta automáticamente el entry point (archivo con \documentclass) y el .bib.

cd mi-proyecto-existente/
texforge init
# Detectado: main.tex, refs.bib
# ✅ project.toml generado

Después de init, todos los comandos (build, fmt, check) funcionan normalmente.

texforge build

texforge build

Compila main.tex → PDF en build/. Los errores se muestran con archivo, línea y sugerencia — nunca logs crudos de tectonic.

Antes de compilar, intercepta entornos de diagramas embebidos, los renderiza, y trabaja sobre copias en build/ — los .tex originales nunca se modifican.

texforge clean

texforge clean  # elimina build/ (PDF, logs, diagramas renderizados)

Diagramas embebidos — Mermaid

% Sin opciones (defaults: width=\linewidth, pos=H, sin caption)
\begin{mermaid}
flowchart LR
  A[Input] --> B[Process] --> C[Output]
\end{mermaid}

% Con opciones
\begin{mermaid}[width=0.6\linewidth, caption=Flujo del sistema, pos=t]
flowchart TD
  X --> Y --> Z
\end{mermaid}

Renderizado a PNG en Rust puro — sin browser, sin Node.js, sin Inkscape.

Opción	Default	Descripción
width	\linewidth	Ancho de la imagen
pos	H	Posición del figure (H, t, b, h, p)
caption	(ninguno)	Pie de figura

Diagramas embebidos — Graphviz / DOT

\begin{graphviz}[caption=Pipeline, width=0.8\linewidth]
digraph G {
  rankdir=LR
  A -> B -> C
  B -> D
}
\end{graphviz}

Mismas opciones que mermaid. Renderizado via layout-rs — Rust puro, sin binario dot externo.

texforge fmt [--check]

texforge fmt           # formatea en lugar
texforge fmt --check   # solo verifica, útil en CI

texforge check

Linter estático — valida sin compilar. Detecta:

• Archivos \input faltantes
• Imágenes \includegraphics no encontradas
• Archivos \lstinputlisting no encontrados
• Archivos \inputminted{lang}{file} no encontrados
• Claves \cite no definidas en el .bib
• Pares \ref/\label rotos
• Entornos sin cerrar

ERROR [main.tex:47]
  \includegraphics{missing.png} — file not found

ERROR [main.tex:12]
  \cite{smith2020} — key not found in .bib

texforge template

texforge template list               # lista templates instalados localmente
texforge template list --all         # lista instalados + disponibles en el registry remoto
texforge template add apa-general    # descarga desde registry
texforge template remove apa-general
texforge template validate apa-general

Templates disponibles:

Template	Descripción
general	Artículo genérico (embebido, offline)
apa-general	Reporte APA 7ma edición
apa-unisalle	Tesis Universidad de La Salle
ieee	Paper IEEE
letter	Correspondencia formal en español

Flujo típico — proyecto nuevo

texforge new mi-documento
cd mi-documento
texforge check    # detectar errores antes de compilar
texforge fmt      # formatear
texforge build    # compilar a PDF

Flujo típico — proyecto existente

cd mi-proyecto-latex/
texforge init     # genera project.toml detectando entry y bib
texforge check
texforge build

Si texforge build falla

1. Correr texforge check primero — resuelve la mayoría de errores sin compilar
2. Si es el primer build, tectonic se está descargando — verificar conexión a internet
3. Para errores de sintaxis LaTeX, el output indica archivo y línea exacta