From 3cd011114ea633acdc83f04c53fac9ae9c472c81 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Fri, 9 Oct 2026 14:43:40 +0200 Subject: [PATCH] =?UTF-8?q?Aggiunge=20CLAUDE.md=20per=20la=20pipeline=20PD?= =?UTF-8?q?F/DOCX=20=E2=86=92=20MinerU=20=E2=86=92=20wiki=20Obsidian?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 5.5 --- CLAUDE.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..92508ba --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,28 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Cos'è questo repository + +Non c'è codice: pipeline documentale **PDF/DOCX grezzi → Markdown (MinerU) → LLM-wiki / vault Obsidian**, a partire da una tesi di laurea magistrale (Chimica Industriale, "Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi", in italiano). La tesi è stata elaborata con **MinerU** (PDF → Markdown) e poi rifinita. Non ci sono build, lint o test; MinerU non è installato in locale (i JSON intermedi sono stati rimossi dalla storia). + +## Contenuto + +- `tesi.md` — **sorgente canonico**: fusione di `tesi.docx` (struttura, tabelle, indice) e dell'output MinerU di `tesi.pdf` (figure, formule), con figure e LaTeX corretti a mano. Lavorare qui. +- `tesi.docx`, `tesi.pdf` — **grezzo di partenza** (la tesi originale), mai da modificare né da usare come fonte di lavoro; servono solo per verificare dubbi di estrazione. +- `immagini/` — ~100 figure referenziate da `tesi.md` come `![](immagini/.jpg)`. I nomi sono hash SHA-256 (dedup tra docx e pdf): **non rinominare** e non rompere i riferimenti. `_senza_label.jpg` è la stessa figura senza etichette (usata una volta). + +## Struttura di tesi.md + +Front matter con tabelle HTML (``) → Riassunto / Abstract / Sommario (indice con ancore `#_TocNNN` di Word, non più valide come link utili) → capitoli `# 1 Introduzione`, `2 Scopo`, `3 Procedure sperimentali`, `4 Discussione dei risultati`, `5 Conclusioni`. Intestazioni e numerazione sono scritte a mano (`## 1.1 **Titolo**`, grassetto incluso). Didascalie in HTML: `Figura N- testo`, sotto l'immagine. Formule display in `$$ ... $$` (~26 blocchi), tabelle residue in HTML. + +## Convenzioni per la trasformazione in wiki Obsidian + +- Non modificare `tesi.md` in modo distruttivo: generare le note in una cartella separata (es. `wiki/`), una per sezione/concetto, con wikilink `[[...]]`, frontmatter YAML e embed `![[immagine]]`; usare le skill `obsidian:obsidian-markdown` e `obsidian:obsidian-bases`. +- Il testo è scientifico: mantenere invariati formule LaTeX, formule chimiche, nomi di composti, unità, valori numerici e sigle (DPP, 3HT, ROP, PCL, ACQ, CV…). Non tradurre né riassumere dati sperimentali. +- Se una formula/tabella/valore sembra un errore di OCR, confrontarlo con `tesi.pdf`/`tesi.docx` prima di correggere; segnalare, non indovinare. +- Ogni affermazione di una nota deve essere riconducibile a una sezione di `tesi.md` (citare numero di capitolo/figura). + +## Git + +Cronologia: tesi grezza MinerU → fusione docx+pdf → rinomina immagini in hash → pulizia intermedi. Commit in italiano, descrittivi, al passato/presente breve (es. "Rifinisce tesi.md: …").