{"id":26119382,"url":"https://github.com/baldomo/unitn-tesi-template","last_synced_at":"2025-04-13T10:41:33.741Z","repository":{"id":110087015,"uuid":"591387788","full_name":"Baldomo/unitn-tesi-template","owner":"Baldomo","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-31T11:32:41.000Z","size":193,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T02:06:59.563Z","etag":null,"topics":["latex","latex-template","tectonic","template","unitn"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Baldomo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-20T16:25:59.000Z","updated_at":"2023-02-17T22:34:10.000Z","dependencies_parsed_at":"2023-04-03T11:02:39.660Z","dependency_job_id":null,"html_url":"https://github.com/Baldomo/unitn-tesi-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Baldomo%2Funitn-tesi-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Baldomo%2Funitn-tesi-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Baldomo%2Funitn-tesi-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Baldomo%2Funitn-tesi-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Baldomo","download_url":"https://codeload.github.com/Baldomo/unitn-tesi-template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248701432,"owners_count":21148035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["latex","latex-template","tectonic","template","unitn"],"created_at":"2025-03-10T12:34:35.997Z","updated_at":"2025-04-13T10:41:33.735Z","avatar_url":"https://github.com/Baldomo.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Template di tesi per Università degli studi di Trento \u003c!-- omit in toc --\u003e\n\n#### Indice \u003c!-- omit in toc --\u003e\n\n- [Requisiti](#requisiti)\n- [Struttura dei file](#struttura-dei-file)\n- [Editing del testo](#editing-del-testo)\n- [Creazione PDF](#creazione-pdf)\n- [FAQ e problemi comuni](#faq-e-problemi-comuni)\n\n---\n\nQuesta repository é un [template Github](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template) per documenti di tesi di laurea triennale standard provvisti dall'Universitá degli Studi di Trento. Tutti i file appartenenti a questo progetto sono originariamente disponibili [sul sito InfoStudenti](https://infostudenti.unitn.it/it/conseguimento-titolo-lauree-disi#node-20345), ma sono stati modificati e modernizzati estensivamente.\n\nIl numero massimo di facciate é 30. Sono inclusi nel conteggio:\n- indice\n- sommario\n- capitoli\n\nE sono esclusi:\n- frontespizio\n- ringraziamenti\n- allegati\n\n### Requisiti\nNessun software specifico é necessario per utilizzare questa repository su Linux o MacOS, mentre su Windows occorre installare [Git Bash](https://git-scm.com/download/win) (che dovrebbe essere già installato in ogni caso per clonare questa repository).\n\nSi consiglia [Visual Studio Code](https://code.visualstudio.com/download) o [VSCodium](https://vscodium.com/#install) per lavorare sui file. Alcune impostazioni dell'editor e integrazioni sono incluse in questa repository.\n\n### Struttura dei file\nLa struttura di questa repository può essere riassunta come segue:\n```shell\n📁 bin                      # Eseguibili necessari\n📁 build                    # Output dei PDF\n📂 src                      # Codice sorgente\n  📂 chapters               # Capitoli\n  📂 figures                # Grafiche e immagini\n  📂 sections               # Macrosezioni del documento\n  📘 index.tex              # Corpo principale del testo\n  📘 config.tex             # Configurazione di librerie\n  📘 _preamble.tex          # Definisce l'inizio del documento\n  📘 _postamble.tex         # Definisce bibliografia e allegati\n  📚 biblio.bib             # File di specifica della bibliografia\n📄 make                     # Script di compilazione\n⚙️ Tectonic.toml            # Backend service configuration file\n```\n\nSpiegazione approfondita:\n- `bin`: gli eseguibili necessari al progetto vengono scaricati in questa cartella dallo script di compilazione (ad esempio [Tectonic](https://tectonic-typesetting.github.io/en-US/))\n- `build`: i file PDF compilati e altri file temporanei (log del compilatore etc.) vengono generati in questa cartella\n- `src`: contiene codice sorgente e in generale, file usati per creare il documento finale\n  - `chapters`: contiene i vari capitoli e altri file di contenuti testuali del documento\n  - `figures`: contiene file di contenuti grafici (immagini, grafiche vettoriali, etc.)\n  - `sections`: contiene la struttura delle macrosezioni del documento, come definite nel template originale fornito dall'Università. Generalmente non necessita di modifiche\n  - `index.tex`: contiene la definizione del corpo principale del testo. Ogni capitolo da inserire nel documento finale va incluso/importato in questo file\n  - `config.tex`: contiene altre librerie definite dall'utente e la relativa configurazione. Viene automaticamente importato da `_preamble.tex` e compilato nel PDF finale\n  - `_preamble.tex` (*non necessita di modifiche*): questo file importa le librerie LaTeX necessarie, aggiunge la pagina iniziale, i ringraziamenti (opzionali) e l'indice. Chiama `\\begin{document}`\n  - `_postamble.tex` (*non necessita di modifiche*): questo file aggiunge bibliografia e allegati. Chiama `\\end{document}`\n- `make`: script di compilazione e varie utility per gestire il progetto (ad esempio scaricare Tectonic, creare le cartelle ed eseguire comandi) creato con [makesh](https://github.com/Baldomo/makesh)\n- `Tectonic.toml`: file di configurazione per Tectonic (vedi [documentazione ufficiale](https://tectonic-typesetting.github.io/book/latest/ref/tectonic-toml.html)). Generalmente non necessita di modifiche\n\n### Editing del testo\nSono riportate di seguito alcune procedure comuni per aggiungere contenuti al documento.\n\n\u003cdetails\u003e\n  \u003csummary\u003eAggiungere un nuovo capitolo\u003c/summary\u003e\n\n---\n\n1. Creare un file LaTeX nella cartella `chapters` (ad esempio `capitolo4.tex`)\n2. Importare il file in `index.tex` (ad esempio con `\\input{chapters/capitolo4.tex}`)\n\n---\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eInserire un'immagine, grafica o figura\u003c/summary\u003e\n\n---\n\n\u003e Per attivare TikZ, `pgfplots` o altre librerie basta definirle in `config.tex`\n\n- Grafica LaTeX:\n  - Vedi [`pgfplots`](https://www.overleaf.com/learn/latex/Pgfplots_package) per grafici tecnici e scientifici\n  - Vedi [TikZ](https://www.overleaf.com/learn/latex/TikZ_package) per qualunque tipo di figure geometriche, di basso livello\n- Grafica vettoriale o SVG: vedi articolo \"[How to include an SVG image in LaTeX](http://mirrors.ctan.org/info/svg-inkscape/InkscapePDFLaTeX.pdf)\"\n- PDF (vedi anche documentazione della libreria `graphicx` in [inglese](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) o [italiano](http://mirrors.ctan.org/info/italian/itgrfguide/itgrfguide.pdf)):\n  1. Inserire il file nella cartella `figures` (ad esempio `image.pdf`)\n  2. Importare il file usando `graphicx`, che é già incluso e attivo nel progetto (ad esempio con `\\includegraphics{figures/image.pdf}`)\n- Immagine raster (PNG, JPEG, etc.): uguale a PDF usando `graphicx`\n\nIn generale per `graphicx` si consiglia di avvolgere `\\includegraphics` in un blocco LaTeX per le figure, per controllarne il posizionamento rispetto al testo (vedi [documentazione](https://www.overleaf.com/learn/latex/Inserting_Images#Positioning) per altri esempi):\n```latex\n\\begin{figure}[h]\n  \\centering\n  \\includegraphics[height = 0.3, width = 0.6]{figures/image.pdf}\n\\end{figure}\n```\n\n---\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eAggiungere un riferimento alla bibliografia\u003c/summary\u003e\n\n---\n\nOccorre solo modificare il file `biblio.bib` (la bibliografia viene generata automaticamente). Vedi [documentazione](https://www.overleaf.com/learn/latex/Bibliography_management_with_natbib#The_bibliography_file) per altri esempi e specifica del file.\n\nAd esempio data la bibliografia:\n```\n@article{donoho,\n  author = {Donoho D. L.},\n  title = {Compressed Sensing},\n  journal = {IEEE Trans. Inf. Theory},\n  volume = {52},\n  number = {4},\n  pages = {1289-1306},\n  year = {2006}\n}\n```\n\né possibile inserire una citazione nel testo con il comando `\\cite`:\n```latex\n\\cite{donoho}\n```\n\n---\n\n\u003c/details\u003e\n\n### Creazione PDF\nOccorre innanzitutto creare una repository personale usando questa come template (vedi [documentazione di Github](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)). La repository personale può quindi essere clonata in locale tramite Git (Git Bash su Windows), ad esempio:\n\n```shell\n$ git clone --recursive https://github.com/username/repository\n```\n\n\u003e Aprendo la cartella del progetto con Visual Studio Code, alcune estensioni vengono raccomandate per una migliore esperienza di sviluppo/scrittura. É fortemente consigliato installarle.\n\nÉ possibile entrare in una modalità di **compilazione continua**, che rigenera il PDF ogni volta che un file viene modificato e salvato, tramite uno dei seguenti metodi:\n- usare il pulsante \" 👁 Sviluppo\" nella barra nel lato inferiore della finestra\n- eseguire la task \"Sviluppo PDF\" manualmente da Visual Studio Code\n- eseguire `./make watch` nel terminale integrato nell'editor\n\nPer **compilare** singolarmente il progetto in un file PDF é possibile:\n- usare il pulsante \" ▷ Compila\" nella barra nel lato inferiore della finestra\n- eseguire la task \"Genera PDF\" manualmente da Visual Studio Code\n- eseguire `./make` nel terminale integrato nell'editor\n\n### FAQ e problemi comuni\n\u003cdetails\u003e\n  \u003csummary\u003eTectonic non supporta immagini EPS\u003c/summary\u003e\n\n---\n\nQuesto comportamento é voluto dagli autori di Tectonic (vedi [issue su Github](https://github.com/tectonic-typesetting/tectonic/issues/27)). Si consiglia in ogni caso di utilizzare strumenti più moderni, descritti nella sezione \"[Editing del testo](#editing-del-testo)\".\n\nÉ possibile comunque convertire immagini da EPS a PDF usando i seguenti parametri per il programma [GhostScript](https://www.ghostscript.com/releases/gsdnld.html):\n\n```\n-sDEVICE=pdfwrite -dPDFSETTINGS=/printer -dEPSCrop -o immagine.pdf immagine.eps\n```\n\noppure importandole in programmi di grafica vettoriale come Inkscape ed [esportando come PDF/Latex](https://wiki.inkscape.org/wiki/index.php/LaTeX).\n\n---\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003ccode\u003ePackage titlesec Error: Entered in horizontal mode.\u003c/code\u003e\u003c/summary\u003e\n\n---\n\nIl pacchetto `titlesec` potrebbe dare errore di layout **solo con alcuni font alternativi** se non viene utilizzato il comando `\\include*` (della libreria `newclude`) per importare i file.\n\n```latex\n\\include*{chapters/capitolo1}\n\\include*{chapters/capitolo2}\n\\include*{chapters/capitolo3}\n```\n\nIn alternativa, dopo ogni `\\include{chapters/...}` deve essere inserita una riga vuota, nella seguente maniera:\n\n```latex\n\\input{chapters/capitolo1}\n\n\\input{chapters/capitolo2}\n\n\\input{chapters/capitolo3}\n```\n\n---\n\n\u003c/details\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaldomo%2Funitn-tesi-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaldomo%2Funitn-tesi-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaldomo%2Funitn-tesi-template/lists"}