#!/usr/bin/env python3
"""Costruisce il manuale: da `contenuti/*.md` a un solo file in `fatto/`.
Uso: python build/costruisci.py (su Windows può servire: py build/costruisci.py)
Serve: Python 3.8 o più recente. Nessuna libreria da installare.
Il giro: prima chiama `controlla.py` (se trova un errore, qui non si arriva),
poi impagina i capitoli in `fatto/manuale.html`. Quel file si legge dal telefono
e, dall'anteprima di stampa del browser, esce in A4 con un capitolo per pagina:
è il tuo PDF. Il menu in alto sparisce in stampa.
Regola che vale più del codice: `fatto/` si rigenera, non si corregge.
Se l'uscita è sbagliata, l'errore sta in `contenuti/` o qui dentro.
"""
import html
import re
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent))
import controlla # noqa: E402
RADICE = controlla.RADICE
USCITA = RADICE / "fatto" / "manuale.html"
# Cambia queste tre righe: sono l'intestazione del TUO manuale.
TITOLO = "Manuale del banco"
SOTTOTITOLO = "Ferramenta Esposito · Napoli — uso interno"
REVISIONE = "revisione di novembre 2026"
# ---------------------------------------------------------------- Markdown → HTML
# Sottoinsieme volutamente piccolo: titoli, paragrafi, elenchi, tabelle,
# citazioni, blocchi di codice, immagini, link, grassetto, corsivo, `codice`.
# Basta per un manuale. Se ti serve altro, aggiungilo qui: è una funzione sola.
def _inline(testo):
testo = html.escape(testo, quote=False)
testo = re.sub(r"`([^`]+)`", r"\1", testo)
testo = re.sub(r"!\[([^\]]*)\]\(([^)\s]+)\)", r'', testo)
testo = re.sub(r"\[([^\]]+)\]\(([^)\s]+)\)", r'\1', testo)
testo = re.sub(r"\*\*([^*]+)\*\*", r"\1", testo)
testo = re.sub(r"(?\1", testo)
return testo
def _ancora(testo):
pulito = re.sub(r"[^a-z0-9]+", "-", testo.lower().replace("à", "a").replace("è", "e"))
return pulito.strip("-") or "sezione"
def _riga_tabella(riga, cella="td"):
celle = [c.strip() for c in riga.strip().strip("|").split("|")]
return "
" + "".join(f"<{cella}>{_inline(c)}" for c in celle) + "
"
def a_html(corpo):
righe = corpo.splitlines()
pezzi, i = [], 0
while i < len(righe):
riga = righe[i]
nudo = riga.strip()
if not nudo:
i += 1
continue
if nudo.startswith("```"):
blocco, i = [], i + 1
while i < len(righe) and not righe[i].strip().startswith("```"):
blocco.append(html.escape(righe[i], quote=False))
i += 1
pezzi.append("
" + "\n".join(blocco) + "
")
i += 1
continue
if nudo.startswith("#"):
livello = len(nudo) - len(nudo.lstrip("#"))
testo = nudo[livello:].strip()
livello = min(livello, 6) # il titolo del capitolo è già l'h1: nel testo parti da ##
pezzi.append(f'{_inline(testo)}')
i += 1
continue
if nudo.startswith(">"):
blocco = []
while i < len(righe) and righe[i].strip().startswith(">"):
blocco.append(righe[i].strip().lstrip(">").strip())
i += 1
pezzi.append("
" + _inline(" ".join(blocco)) + "
")
continue
if nudo.startswith("|") and i + 1 < len(righe) and set(righe[i + 1].strip()) <= set("|-: "):
testata = _riga_tabella(righe[i], "th")
i += 2
corpo_tabella = []
while i < len(righe) and righe[i].strip().startswith("|"):
corpo_tabella.append(_riga_tabella(righe[i]))
i += 1
pezzi.append(
"
" + testata + ""
+ "".join(corpo_tabella) + "
"
)
continue
elenco_puntato = re.match(r"^[-*]\s+(.*)", nudo)
elenco_numerato = re.match(r"^\d+[.)]\s+(.*)", nudo)
if elenco_puntato or elenco_numerato:
marcatore = "ul" if elenco_puntato else "ol"
voci = []
while i < len(righe):
corrente = righe[i].strip()
prossima = re.match(r"^[-*]\s+(.*)", corrente) if marcatore == "ul" \
else re.match(r"^\d+[.)]\s+(.*)", corrente)
if not prossima:
break
voci.append(f"
{_inline(prossima.group(1))}
")
i += 1
pezzi.append(f"<{marcatore}>" + "".join(voci) + f"")
continue
if set(nudo) <= set("-*_") and len(nudo) >= 3:
pezzi.append("")
i += 1
continue
paragrafo = []
while i < len(righe) and righe[i].strip() and not re.match(r"^(#|>|\||```|[-*]\s|\d+[.)]\s)", righe[i].strip()):
paragrafo.append(righe[i].strip())
i += 1
pezzi.append("
\n'
f'{a_html(c["corpo"])}\n'
for c in capitoli
)
parole = sum(c["parole"] for c in capitoli)
pagina = f"""
{html.escape(TITOLO)}
{html.escape(TITOLO)}
{html.escape(SOTTOTITOLO)}
{html.escape(REVISIONE)} · {len(capitoli)} capitoli · {parole} parole
{corpo}
"""
USCITA.parent.mkdir(parents=True, exist_ok=True)
USCITA.write_text(pagina, encoding="utf-8")
return parole
if __name__ == "__main__":
capitoli, errori, avvisi = controlla.controlla()
controlla.stampa_esito(capitoli, errori, avvisi)
if errori:
print("\nBuild non eseguito: il cancello è chiuso.")
sys.exit(1)
parole = costruisci(capitoli)
print("\nCOSTRUZIONE")
print(f" Scritto: fatto/manuale.html ({len(capitoli)} capitoli, {parole} parole)")
print("\nIl giro per la prossima modifica:")
print(" 1. apri il capitolo giusto in contenuti/ e cambia lì;")
print(" 2. lancia python build/costruisci.py;")
print(" 3. apri fatto/manuale.html nel browser; per il PDF: Stampa, poi Salva come PDF (A4).")