TFG: models causals estructurals i resultats potencials

Aquest repositori conté el Treball de Final de Grau Models causals estructurals i resultats potencials i la classe LaTeX bestclass utilitzada per maquetar-lo. El document s'escriu i es compila amb pdfLaTeX mitjançant latexmk.

El PDF generat pel projecte es desa a build/main.pdf.

Estructura del repositori

• main.tex: punt d'entrada del document i metadades del TFG.
• chapters/: capítols, front matter i annexos.
• res/bibl.bib: bibliografia principal.
• res/figures/: figures del treball i exportacions derivades versionades.
• src/bestclass/ i bestclass.cls: classe LaTeX i mòduls interns.
• src/fonts/: font Aboreto i fitxers derivats necessaris per a pdfLaTeX.
• scripts/: scripts de verificació i regeneració d'actius.
• latexmkrc: configuració de compilació local del projecte.

Requisits

Cal tenir instal·lada una distribució TeX Live completa amb latexmk, biber, makeindex i pdfLaTeX. També calen:

• pygments, requerit pels blocs de codi de minted.
• Inkscape, només si es modifica una figura SVG o se n'elimina l'exportació versionada.
• chktex, per executar la comprovació estàtica opcional.
• otftotfm, només si es volen regenerar els derivats locals de la font Aboreto.

Els derivats necessaris de la font Aboreto i de la figura SVG ja estan versionats. La compilació activa shell-escape perquè svg i minted puguin invocar eines externes quan calgui. No cal executar updmap global ni instal·lar fonts fora del repositori.

Compilació

El repositori inclou un latexmkrc que fixa el directori de sortida, carrega els mòduls de bestclass, afegeix les rutes locals de fonts i activa shell-escape. Per tant, la compilació habitual és:

latexmk main.tex

Si es vol llançar la compilació amb totes les opcions explícites:

latexmk -pdf -synctex=1 -shell-escape -interaction=nonstopmode -file-line-error main.tex

Una invocació directa de pdflatex no és suficient: el document també necessita Biber, MakeIndex i diverses passades de LaTeX per estabilitzar cites, referències i índexs.

Per netejar els fitxers auxiliars generats per LaTeX:

latexmk -C main.tex

Verificació local

Després de compilar, es pot comprovar el log de LaTeX amb:

./scripts/check-latex-log.sh

El script falla davant errors de LaTeX, referències o cites indefinides, i avisos semàntics que no constin a scripts/latex-warning-allowlist.txt. Els avisos Overfull i Underfull es mostren al terminal, però no bloquegen la verificació.

La comprovació estàtica opcional del document principal és:

chktex -q main.tex

La CI de GitHub Actions compila el PDF amb TeX Live 2026, executa aquestes comprovacions i publica build/main.pdf com a artefacte.

Classe bestclass

bestclass.cls carrega els seus mòduls interns des de src/bestclass/bestclass-*.sty. Durant la compilació d'aquest repositori, latexmkrc afegeix automàticament aquest directori a TEXINPUTS.

Per reutilitzar la classe en un altre projecte, cal copiar o instal·lar bestclass.cls, els paquets de src/bestclass/ i, si es fa servir la mateixa portada, els recursos necessaris de src/resources/.

La classe no imposa ni la llicència del document ni les metadades institucionals. Aquest TFG declara explícitament a main.tex la llicència CC BY-NC-ND 3.0 i les metadades PDF de la Universitat de Barcelona.

Regeneració d'actius

Els actius derivats ja estan versionats i només cal regenerar-los si se'n toca la font original.

Per regenerar els fitxers de pdfLaTeX corresponents a Aboreto:

./scripts/generate-aboreto-font.sh

otftotfm pot avisar que no troba dotlessj, ff, ffi, ffl, fi i fl. Les lligadures T1 s'han desactivat deliberadament perquè Aboreto no ofereix aquests glifs; els fitxers generats no en depenen.

Per actualitzar l'exportació PDF + .pdf_tex de la figura SVG versionada:

./scripts/generate-svg-assets.sh

Llicències

Consulta LICENSE.md per veure la llicència aplicable a cada part del repositori. En resum:

• El contingut acadèmic del TFG i el PDF compilat es publiquen amb CC BY-NC-ND 3.0.
• La classe bestclass, la configuració de compilació i els scripts auxiliars es publiquen amb LPPL 1.3c.
• La font Aboreto i els derivats locals es distribueixen amb OFL 1.1.

La font Aboreto prové del repositori oficial.