Documentazione & FAQ

Incorpora il tuo primo PDF

Apri un documento nel tuo archivio, copia il codice embed e incollalo in un blocco HTML del tuo sito.

Usa il link pubblico della pagina documento. L’indirizzo dell’anteprima privata è riservato al tuo account.

Embed di base

<script
  src="https://browse.pub/embed-script"
  data-src="https://browse.pub/embed/YOUR_DOCUMENT_TOKEN"
  data-title="Lettore PDF">
</script>

Sostituisci YOUR_DOCUMENT_TOKEN con il token del tuo link pubblico, oppure usa direttamente il codice già pronto nella pagina documento.

Il viewer occupa tutta la larghezza del contenitore. L’altezza predefinita è il 60% della finestra, con un minimo di 320 px.

Autorizza il tuo sito prima di provare l’embed. In un CMS, usa un blocco HTML personalizzato o Embed che consenta gli script.

Personalizza il viewer

Scegli uno stile uniforme per il tuo archivio, oppure adatta un viewer a un sito specifico.

  1. Impostazioni globaliIl punto di partenza per ogni documento: proporzioni, sfondo, evidenziazioni, ombra centrale e visibilità del titolo.
  2. Impostazioni del documentoModifica lo stile globale per un singolo PDF. Lascia un campo sull’impostazione globale per continuare a ereditarne le modifiche.
  3. Attributi dell’embedI valori scritti nel codice hanno la precedenza sulle impostazioni salvate, solo per quell’embed.

Un esempio personalizzato

<script
  src="https://browse.pub/embed-script"
  data-src="https://browse.pub/embed/YOUR_DOCUMENT_TOKEN"
  data-title="Lettore PDF"
  data-height="600px"
  data-background="#f4f4f1"
  data-highlight="auto"
  data-show-title="false"
  data-language="it">
</script>

Il codice di base segue le modifiche alle impostazioni salvate. Il codice configurato della pagina documento fissa i valori inclusi: copialo di nuovo per aggiornarli.

Tutte le opzioni dell’embed

Aggiungi questi attributi al tag script. Solo data-src è obbligatorio; ometti le opzioni di stile per usare le impostazioni salvate del documento.

Usa true o false per gli interruttori e colori esadecimali a sei cifre, come #30383c.

data-srcObbligatorio
L’URL pubblico del documento, copiato dalla sua pagina. Mantieni l’indirizzo completo, incluso https://.
data-title
Un’etichetta accessibile per l’iframe, ad esempio “Relazione annuale”. Non rinomina il PDF e non modifica il titolo dentro al viewer.Default: Lettore PDF
data-width
Larghezza del viewer: un valore CSS come 100% o 900px. Mantieni 100% per un embed responsive.Default: 100%
data-height
Altezza del viewer: un valore CSS come 600px o 75dvh. Impostandola rimuovi anche l’altezza minima predefinita.Default: 60dvh (60vh se non supportato), minimo 320px
data-force-aspect-ratio
auto — lascia decidere al viewer; true — forza proporzioni uniformi; false — mantieni le proporzioni originali.
data-background
Colore di sfondo del viewer, ad esempio #30383c o #f4f4f1. I controlli si adattano al contrasto dello sfondo.
data-highlight
auto — adatta le evidenziazioni della ricerca al colore della pagina; oppure un colore fisso come #ffd144.
data-shadow
true / false — mostra o nasconde l’ombra centrale tra le pagine affiancate.
data-show-title
true / false — mostra o nasconde il titolo del documento dentro al viewer.
data-language
it / en — scegli la lingua dell’interfaccia del viewer per questo embed.Default: la lingua dell’interfaccia del proprietario del documento

Scegli i siti autorizzati

Aggiungi i siti nelle impostazioni globali per tutto l’archivio, oppure nella pagina documento per un solo PDF. Le due liste si sommano.

Inserisci un dominio per riga, senza https://, www, percorsi o caratteri jolly.

example.com
archive.example.com
localhost:8080

example.com consente anche www.example.com, sia in HTTP sia in HTTPS. Gli altri sottodomini vanno aggiunti separatamente; specifica la porta se il sito usa una porta non standard.

Una lista vuota blocca l’embed sui siti esterni. Il link pubblico resta apribile direttamente: la lista controlla dove incorporare il viewer, non chi può leggere il link pubblico.

Qualcosa non funziona?

Parti da questi controlli rapidi.

Il dominio non è autorizzato

Aggiungi il dominio della pagina che contiene l’embed, non browse.pub. Per un’anteprima del CMS, autorizza anche il dominio dell’anteprima. Controlla porta ed eventuale sottodominio.

Il sito ospitante non può essere verificato

L’embed usa l’header Referer del browser per verificare il sito ospitante. Evita la policy no-referrer; strict-origin-when-cross-origin permette di verificare l’origine.

Non appare nulla, o lo stile non si aggiorna

Controlla che il CMS mantenga il tag script, che l’URL data-src sia completo e che il documento non sia nel cestino. Se lo stile è vecchio, rimuovi gli attributi espliciti per ereditare le impostazioni salvate, oppure ricopia il codice configurato.

Serve una mano? ciao@iperstudio.net