================================================================
  TEMPLATE TESI DI LAUREA TRIENNALE
  Università degli Studi di Roma Tor Vergata
  Corso di laurea in Ingegneria per l'Energia e l'Ambiente
================================================================

Questo pacchetto contiene il template per la stesura della tesi
di laurea triennale, disponibile in due formati: Word e LaTeX.
Entrambi includono il conteggio automatico delle parole per
sezione con limiti configurabili dal relatore.


================================================================
  CONTENUTO DELLA CARTELLA
================================================================

  WORD (cartella template-tesi-word):
    tesi-cognome-nome.docm		- Template Word con macro

  LATEX (cartella template-tesi-latex):
    tesi-cognome-nome.tex		- Template LaTeX: file principale
								  modificare con i propri dati nell'intestazione
								  rimuovere il conteggio delle parole al termine del lavoro
								  commentando la riga \input{tesi-configurazione.tex}
	*** Di seguito i file da modificare che contengono le sezioni della tesi ***
	tesi-sommario.tex
    tesi-introduzione.tex		
    tesi-metodi.tex
    tesi-risultati.tex
    tesi-conclusioni.tex
    tesi-nomenclatura.tex
	*** File da non modificare ***
	wordcount.sh                   - Script per conteggio parole
	logo.pdf                       - logo Tor Vergata
    tesi-configurazione.tex        - esegue il conteggio delle parole per sezione



================================================================
  LIMITI DI PAROLE PER SEZIONE (default)
================================================================

    Sommario                   300 parole
    Introduzione              1500 parole
    Metodi                    2500 parole
    Risultati e discussione   3500 parole
    Conclusioni                700 parole
    -------------------------------------------
    TOTALE                    8500 parole

  La macro è dinamica: legge automaticamente i nomi 
  e i limiti dalla tabella, quindi si adatta se si aggiungono,
  rimuovono o rinominano sezioni. Anche il TOTALE viene
  ricalcolato automaticamente ad ogni esecuzione.


================================================================
  ISTRUZIONI - VERSIONE WORD
================================================================

  Il file .docm contiene il template già pronto e la macro ContaParole.
  Occorre mantenere il formato .docm e abilitare l'esecuzione 
  delle macro affinché il template funzioni. La macro viene 
  eseguita automaticamente a ogni salvataggio del file.

  --- COSA FA LA MACRO ---

  - Conta le parole in ciascuna sezione (il numero di sezioni
    viene rilevato automaticamente dalla tabella)
  - Esclude automaticamente figure, tabelle e placeholder [...]
  - Aggiorna la tabella di configurazione con:
      * Conteggio parole attuali
      * Stato (OK / ATTENZIONE / SUPERATO)
      * Percentuale di utilizzo
  - Ricalcola automaticamente il TOTALE
  - Mostra un popup riepilogativo

  --- NOTE ---

  - La macro funziona su Mac e Windows (versione cross-platform)
  - Il file DEVE essere salvato come .docm per mantenere la macro
  - Se si salva come .docx la macro viene rimossa
  - Le figure e tabelle possono essere inserite liberamente:
    non vengono conteggiate


================================================================
  ISTRUZIONI - VERSIONE LATEX
================================================================

  --- REQUISITI ---

  - TeX Live o MiKTeX con i seguenti pacchetti:
    inputenc, fontenc, babel, mathptmx, geometry, graphicx,
    amsmath, amssymb, booktabs, tabularx, longtable, xcolor,
    colortbl, fancyhdr, titlesec, hyperref, caption, lastpage,
	siunitx, mhchem, natbib
  - texcount (opzionale ma consigliato per conteggio preciso)

  --- STRUTTURA DEI FILE ---

  Il template principale (tesi.tex) include
  automaticamente i file delle sezioni tramite \input:

	tesi-sommario.tex
    tesi-introduzione.tex		
    tesi-metodi.tex
    tesi-risultati.tex
    tesi-conclusioni.tex
    tesi-nomenclatura.tex

  Lo studente scrive il contenuto di ogni sezione nel rispettivo
  file .tex. 
  Il file .tex principale non va modificato, se non 
  per i dati personali nel preambolo, l'installazione 
  di pacchetti aggiuntivi (ma i principali sono già inclusi 
  nel template), e la rimozione della pagina con il conteggio 
  delle parole al termine del lavoro.

  --- COMPILAZIONE ---

  È necessario compilare il documento con il compilatore LuaLaTeX
  affinché il conteggio delle parole venga eseguito automaticamente
  e la tabella di conteggio parole nella pagina "Configurazione"
  vanga aggiornata.

  --- COME PROCEDERE ---

  1. Rinominare il file tesi-cognome-nome.tex 
  
  2. Aprire il file e completare i dati:
     \titolotesi, \corsodilaurea, \candidato, \matricola,
     \relatore, \correlatore, \annoacc
	 (righe 111-117 nel template originale)

  3. Scrivere il contenuto della tesi nei file corrispondenti 
	 a ciascuna sezione.

  4. Compilare con il compilatore LuaLaTeX
  
  5. A lavoro ultimato, commentare la riga \input{tesi-configurazione.tex}
	 (riga 153 nel template originale) per eliminare la pagina iniziale
	 con il conteggio delle parole per sezione.

  --- NOTE ---

  - È necessario che i file forniti si trovino tutti nella stessa cartella;
    altri file richiamati nel documento (ad esempio, le figure) possono
	essere collocati in sottocartelle.
  - Se texcount non e installato, il conteggio usa un fallback
    basato su sed+wc (meno preciso ma funzionale)
  - Se babel italian non e installato, la lingua e impostata
    su generico. Decommentare la riga nel .tex se disponibile
  - Il logo viene incluso automaticamente se presente nella
    stessa cartella del .tex


================================================================
  STRUTTURA DELLE SEZIONI
================================================================

  1. SOMMARIO (max 300 parole)
     Breve sintesi: obiettivo, metodo, risultati, conclusioni.

  2. INTRODUZIONE (max 1500 parole)
     Contesto, stato dell'arte, motivazione, obiettivi.

  3. METODI (max 2500 parole)
     Metodologia, modelli, strumenti, dati, ipotesi.

  4. RISULTATI E DISCUSSIONE (max 3500 parole)
     Presentazione dei risultati con figure e tabelle,
     interpretazione critica e confronto con la letteratura.

  5. CONCLUSIONI (max 700 parole)
     Sintesi dei risultati e sviluppi futuri.

  Seguono: Nomenclatura e Bibliografia.


================================================================
  LEGENDA CONTEGGIO PAROLE
================================================================

    OK          Sotto il 90% del limite
    ATTENZIONE  Tra il 90% e il 100% del limite
    SUPERATO    Oltre il 100% del limite


================================================================
  CONTATTI
================================================================

  Per problemi con il template contattare il relatore.


================================================================
