Vai al contenuto
PDFLove

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.

Domande

Domande collegate

Il PDF generato si può condividere pubblicamente?

Sì. Niente al suo interno è reale — il testo è segnaposto assemblato da un elenco fisso di parole, le fatture e le tabelle portano valori inventati, e nel file non viene scritto alcun metadato su di te. È pensato proprio per essere ciò che alleghi a una segnalazione pubblica al posto di un documento vero.

Posso generare un PDF di dimensione esatta?

Vicina, non esatta. Il generatore riempie il documento finché non si avvicina alla cifra impostata, di norma entro qualche punto percentuale. Il PDF comprime il proprio contenuto, quindi nessun generatore può promettere un conteggio esatto di byte. Generane uno per lato del limite se devi provare il confine con precisione.

Quanto può essere grande il documento che costruisce?

Fino a 500 pagine per file e fino a 20 file per volta. È tutto costruito nel tuo browser, quindi un documento da 500 pagine richiede qualche secondo su un portatile e sensibilmente di più su un telefono.

Quale tipo di contenuto scelgo se non sono sicuro?

Numeri di pagina giganti. È l'unico che rende un errore di ordine visibile a colpo d'occhio, che è poi il modo in cui la gestione dei PDF fallisce davvero. Passa agli impaginati ad articolo o a tabella quando stai provando specificamente l'estrazione di testo o di dati.

Serve una connessione a internet?

Solo per caricare la pagina la prima volta. Il documento è assemblato da codice che gira nel tuo browser e scritto direttamente in un download, quindi una volta caricato lo strumento continua a funzionare offline.