come creare un file pdf di prova
Come generare PDF di esempio per i test
Il PDF con cui devi fare i test non è quasi mai il PDF che hai sulla scrivania. Quello è riservato, ha la lunghezza sbagliata e non ha nessuna delle proprietà che stai cercando di rompere.
01
Perché un PDF inventato batte uno vero
Chi costruisce software che tocca i PDF sbatte presto contro lo stesso muro: ti serve un file, e i file a portata di mano sono buste paga, contratti e relazioni per i clienti. Allegarne uno a una segnalazione di bug è il modo in cui documenti riservati finiscono in un tracker per sempre. Usarne uno come file di prova è il modo in cui finiscono committati in un repository.
L'altro problema è la forma. I documenti veri hanno la lunghezza che capita. Verificare che un'unione abbia conservato l'ordine delle pagine richiede un documento le cui pagine annuncino il proprio numero. Verificare un limite di caricamento richiede un file appena sopra. Verificare un visualizzatore paginato richiede 300 pagine, e nessuno ha in giro un documento di 300 pagine che sia disposto a condividere.
Generarne uno risolve entrambe le cose. Il generatore qui costruisce il documento nel tuo browser e lo passa direttamente a un download: non viene caricato nulla, e nulla nel file va oscurato dopo, perché di reale non c'è mai stato niente.
02
Le impostazioni, e a cosa serve ciascuna
Sono otto e corrispondono a compiti di test precisi anziché essere decorazione.
- Titolo del documento
- Diventa tre cose insieme: i metadati di titolo del PDF, l'intestazione della prima pagina e il nome del file scaricato. Utile quando generi più file di prova e devi distinguerli in una cartella.
- Pagine
- Da una a 500. È il numero a cui ricorrere quando provi l'impaginazione, l'interpretazione degli intervalli di pagine o come si comporta un visualizzatore quando un documento smette di stare comodamente in memoria.
- Numero di file
- Da uno a 20, ciascuno numerato e nominato in modo indipendente. È l'impostazione per provare qualsiasi cosa consumi più documenti insieme.
- Contenuto della pagina
- Nove impaginati, descritti sotto. È quello che decide a cosa serva davvero il file di prova.
- Carattere
- Helvetica, Times o Courier — i tre caratteri incorporati in ogni lettore PDF, così non viene inclusa alcuna font e il file resta piccolo e portabile. Courier è quello da scegliere quando provi l'estrazione a larghezza fissa.
- Formato e orientamento della pagina
- A4, US Letter o Legal, verticale od orizzontale. Vale la pena variare: una quantità sorprendente di codice per PDF è scritta pensando all'A4 e gestisce male il Letter in silenzio, e l'orizzontale rompe assunzioni d'impaginazione che il verticale non espone mai.
- Dimensione approssimativa del file
- Zero per un file piccolo, oppure una cifra in megabyte per riempire il documento finché non ci si avvicina.
- Numeri di pagina
- Un numero stampato su ogni pagina, attivo di default. Lascialo attivo a meno che tu non stia provando proprio un documento che non li ha — non costa nulla ed è il modo più rapido di vedere che qualcosa è andato storto.
03
Nove tipi di pagina, e cosa prova ciascuno
L'impostazione del contenuto non è estetica. Ogni impaginato esiste perché una parte diversa di una catena di elaborazione PDF ha bisogno di una cosa diversa sulla pagina.
- Numeri di pagina giganti
- Il valore predefinito, ed è quello giusto. Un'unica cifra enorme per pagina fa sì che un'occhiata al risultato basti a dire se un'unione, una divisione, una rotazione o un riordino hanno fatto quello che avevi chiesto. Niente rende un errore di ordinamento così evidente.
- Paragrafi di lorem ipsum
- Testo corrente fitto. È ciò che vuoi quando provi l'estrazione del testo, l'indicizzazione per la ricerca o come un convertitore gestisce il flusso dei paragrafi.
- Titoli, paragrafi ed elenchi puntati
- Prosa strutturata. È il file di prova per la conversione da PDF a Word e da PDF a Markdown, perché ha una gerarchia di documento che il convertitore deve dedurre.
- Tabelle di dati
- Righe e colonne con i filetti. L'ingresso per provare da PDF a Excel e da PDF a CSV, dove la parte difficile è ricostruire i confini delle celle da quelle che in realtà sono solo linee e testo posizionato.
- Fatture
- Voci, totali, indirizzi e numeri di riferimento. La forma realistica per provare l'analisi dei documenti, l'estrazione dei campi o qualsiasi cosa affermi di leggere fatture.
- Campi di modulo
- Caselle con etichetta e filetti. Usalo per l'appiattimento, il posizionamento della firma e tutto ciò che deve lasciare intatta la struttura del modulo.
- Grafici a barre
- Grafica vettoriale anziché testo. Buono per provare la rasterizzazione, l'uscita da PDF a immagine e i compressori che trattano i disegni diversamente dalle fotografie.
- Un misto di tutto
- Alterna gli impaginati lungo il documento. È la cosa più vicina a una relazione vera e la scelta singola migliore quando vuoi un file di prova che eserciti quasi tutte le strade.
- Pagine bianche
- Vuote di proposito. Per provare la gestione del conteggio pagine, il rilevamento delle pagine bianche e cosa succede quando l'estrazione, correttamente, non trova nulla.
04
Centrare una dimensione di file di proposito
L'impostazione della dimensione approssimativa è quella che porta qui le persone, di solito perché qualcosa ha rifiutato un caricamento e vogliono trovare il limite vero anziché fidarsi del messaggio d'errore. Imposta una cifra in megabyte e il generatore riempie il documento con dati incomprimibili finché il file non ci si avvicina.
È descritta come approssimativa per un motivo onesto. Il PDF è un formato compresso, e il conteggio finale dei byte dipende da come contenuto e riempimento si comprimono insieme — il risultato di norma cade entro qualche punto percentuale, non sul numero esatto. Se devi provare un confine netto, genera un file appena sotto e uno appena sopra, e lascia che la coppia stringa il limite.
L'altro uso è la prestazione. Un documento da 40 MB è il modo per scoprire se un visualizzatore carica le pagine man mano o prova a caricare tutto il file, e se una barra di avanzamento è reale o decorativa.
05
Lotti, per tutto ciò che mangia più di un file
Porta il numero di file sopra uno e ottieni altrettanti documenti separati, ciascuno con la propria numerazione e il proprio nome, più uno ZIP dell'intero lotto. È il modo più rapido di produrre materiale per l'unione: cinque file da cinque pagine numerate ciascuno, uniti, devono dare 25 pagine che contano da uno a cinque, cinque volte — e qualsiasi scostamento salta subito all'occhio.
È altrettanto utile per qualsiasi cosa abbia una coda: verificare che un caricamento multiplo li gestisca tutti, che un convertitore in blocco non perda l'ultimo elemento, o che un indicatore di avanzamento conti correttamente.
06
Le stesse impostazioni producono sempre lo stesso documento
Il testo segnaposto è assemblato da un elenco fisso di parole anziché estratto a caso, quindi generare due volte con impostazioni identiche dà un documento identico. È questo che rende il risultato utilizzabile come file di prova committato: si può confrontare, verificarne la somma di controllo e metterlo a paragone con un'esecuzione precedente senza che ogni rigenerazione produca differenze fasulle.
Significa anche che una segnalazione di bug può dire "genera cinque pagine di contenuto numerato in A4" e chi la legge ottiene esattamente il file che avevi tu, il che è molto meglio che allegarne uno.