Aggiunge CLAUDE.md per la pipeline PDF/DOCX → MinerU → wiki Obsidian

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-09 14:43:40 +02:00
1 parent 77ecb477a6
commit 3cd011114e
1 file changed
+28
+28
View File
@@ -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/<sha256>.jpg)`. I nomi sono hash SHA-256 (dedup tra docx e pdf): **non rinominare** e non rompere i riferimenti. `<hash>_senza_label.jpg` è la stessa figura senza etichette (usata una volta).
## Struttura di tesi.md
Front matter con tabelle HTML (`<table>`) → 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: `<em><strong>Figura N</strong></em> <em>- testo</em>`, 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: …").