Vai al contenuto principale

Note a piè di pagina da PDF a Markdown: tieni insieme indicatori, definizioni e riferimenti

Controlla numerazione delle note, collegamenti, continuazioni tra pagine e resa in Markdown dopo aver convertito un PDF con note.

Un apice nel testo convertito non è necessariamente una nota funzionante. Per conservare una nota, l'indicatore, la sua spiegazione e il passo a cui si riferisce devono restare collegati. Markdown aggiunge un'altra domanda: il tuo editor capisce la notazione usata per rappresentare quel legame?

Esamina il rapporto nel documento originale prima di riorganizzare il file. Un numero che sembra corretto ma è agganciato alla spiegazione sbagliata è più difficile da notare di una nota mancante.

Abbina gli indicatori a definizioni complete

Scegli un indicatore nel corpo originale e leggi la nota per intero. Cerca entrambi nel Markdown. Verifica che la spiegazione inizi e finisca negli stessi punti e che siano presenti eventuali citazioni, precisazioni o continuazioni.

Ora parti da una nota nel risultato e individua la frase originale a cui si riferisce. Questo controllo al contrario può far emergere note duplicate o definizioni rimaste senza un riferimento sensato.

Includi nel campione una nota breve, una lunga e una che contiene una citazione. Un controllo rapido delle sole note già collegate non ti farà trovare una nota omessa del tutto. Esamina anche una pagina del documento originale; l'articolo sulla revisione delle note spiega perché questo sguardo più ampio è importante.

Distingui le etichette dai collegamenti funzionanti

Alcune implementazioni di Markdown supportano le note con riferimento e definizione. Un esempio scritto a mano è questo:

Il passo contiene una precisazione.[^esempio]

[^esempio]: Qui va la nota esplicativa completa.

Questo esempio illustra una convenzione; non descrive il formato esatto prodotto da PDF Craft. CommonMark non standardizza di per sé le note per tutti i renderer Markdown. L'applicazione di destinazione può supportare un'estensione, mostrare la sintassi alla lettera oppure usare un'altra soluzione.

Se l'esportazione usa invece testo normale o collegamenti, esamina quella rappresentazione anziché forzarla subito in una sintassi diversa. Rinumerare le etichette può rompere i riferimenti se l'indicatore e la definizione non cambiano insieme.

Fai attenzione quando la numerazione riparte da capo a ogni capitolo. Due etichette "1" stampate possono riferirsi a note diverse. Il tuo Markdown di lavoro deve mantenere questa distinzione anche se scegli nuovi identificatori interni.

Segui le note lunghe da una pagina alla successiva

Una nota può iniziare in fondo a una pagina del PDF e continuare in quella successiva. Confronta l'ultima riga originale della prima pagina con la continuazione nella pagina seguente prima di decidere dove finisce la nota.

Intestazioni correnti, numeri di pagina e il paragrafo successivo possono essere scambiati per parte della nota. Al contrario, una continuazione può finire nel corpo principale. Leggi abbastanza testo intorno per stabilire a cosa appartiene, invece di unire frammenti solo perché sono vicini fisicamente.

Per le note di fine testo, esamina la sezione che contiene le definizioni e verifica i riferimenti da più capitoli. Un semplice elenco alla fine del documento non dimostra che ogni indicatore corrisponda alla voce giusta.

Annota nel tuo registro di revisione i riferimenti di pagina e capitolo, soprattutto se la stessa numerazione compare più di una volta.

Visualizza e prova nell'editor di destinazione

Apri il Markdown dove intendi conservarlo. Prova un indicatore, leggi la destinazione e torna alla frase. Se l'editor offre un collegamento di ritorno, verifica che riporti all'occorrenza corretta.

Per esempio, Obsidian documenta le estensioni supportate nella sua guida a Markdown. Il supporto in quell'editor non implica che un altro sistema di pubblicazione tratti la stessa sintassi allo stesso modo.

Se una nota viene visualizzata come codice o come semplice punteggiatura, controlla il supporto alla sintassi prima di modificarne il contenuto. Se apre la spiegazione sbagliata, torna alla corrispondenza nel documento originale. Errori di resa ed errori di riconoscimento richiedono correzioni diverse.

Conserva le note mentre costruisci un file di lavoro

Nel flusso di lavoro Markdown di PDF Craft, scegli Markdown ed esamina le impostazioni relative alle note prima di avviare la conversione. Scarica il risultato completato e confronta le note con l'originale. Il riconoscimento delle note complesse richiede comunque una revisione; non dare per scontato che ogni corrispondenza tra pagine sia corretta.

Quando estrai passi nelle note di ricerca, porta con te la definizione necessaria insieme alla citazione e annota la pagina originale. Un indicatore copiato senza la sua nota può non conservare più il significato dell'autore.

Salva l'esportazione non modificata separatamente dalla copia corretta. Il Markdown finito dovrebbe permetterti di risalire da una precisazione alla frase e al documento di origine, non solo mostrare una sequenza ordinata di apici.

Applica la guida ai tuoi documenti

Prova un file rappresentativo, controlla il risultato e scegli il flusso adatto alla tua raccolta.

Converti un PDF con note