Converti in blocco una cartella di PDF in flipbook

Hai una cartella. Cinquanta PDF di prodotti che la riempiono. Ognuno deve diventare un flipbook con un titolo sensato, e ti servono i link di condivisione in un foglio di calcolo entro fine giornata. Farlo a mano — carica, dai un nome, aspetta, copia il link, incollalo, ripeti — è il tipo di compito che si divora un pomeriggio e la tua pazienza.

Questa guida ti mostra come convertire in blocco i PDF in flipbook per un'intera cartella con un solo loop della shell, raccogliere ogni URL risultante in un CSV e andare avanti anche se un file è rotto. Si dà per scontato che tu abbia già installato e autenticato la CLI di FlipLink. In caso contrario, parti prima da Primi passi con la CLI di FlipLink — bastano un paio di minuti.

Il mattone di base: un file alla volta

Prima di ciclare su cinquanta file, fanne funzionare uno come si deve. Il comando della CLI che trasforma un PDF in un flipbook è:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

--title è ciò che vedono i lettori; --name è l'etichetta interna. Aggiungi --json e il comando stampa la risposta grezza dell'API invece di un riepilogo leggibile — è da quel JSON che andremo a estrarre il link di condivisione più avanti:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --json

Quell'unica risposta contiene tutto ciò che ti serve: l'ID del nuovo flipbook e il suo URL pubblico. Ora dobbiamo solo eseguirla una volta per ogni file.

Il loop: converti ogni PDF di una cartella

Ecco il cuore della cosa. Metti i tuoi PDF in una cartella, entraci con cd ed esegui un loop bash su *.pdf. Da ogni nome di file ricaviamo un titolo pulito — togliamo l'estensione .pdf e sostituiamo trattini e trattini bassi con spazi:

#!/usr/bin/env bash
for f in *.pdf; do
  # Turn "spring-product-catalog.pdf" into "spring product catalog"
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f  ->  \"$name\""
  fliplink flipbook create "$f" --title "$name" --json
done

Questo percorre la cartella, converte ogni PDF e stampa il risultato JSON per ognuno. Funziona, ma l'output è un muro di JSON e un singolo file difettoso lascerebbe comunque proseguire gli altri. Sistemiamo entrambe le cose — prima l'output, poi la gestione degli errori.

Raccogliere i risultati in un CSV

Quello che vuoi davvero alla fine è un foglio di calcolo: una riga per flipbook, con il suo ID e il link di condivisione. Passa ogni risultato --json attraverso jq per estrarre solo questi due campi e aggiungere una riga al CSV.

La risposta della creazione contiene l'ID e un URL del flipbook. Estraiamo entrambi, usiamo un segnaposto come ripiego se un campo manca, e scriviamo una riga di intestazione una sola volta in cima:

#!/usr/bin/env bash
out="flipbooks.csv"
echo "file,id,url" > "$out"           # write the CSV header once

for f in *.pdf; do
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f"

  json="$(fliplink flipbook create "$f" --title "$name" --json)"

  # Pull ID + URL from the JSON; '// "?"' supplies a fallback if absent
  row="$(printf '%s' "$json" | jq -r '[.ID, .URL] | @csv' 2>/dev/null)"

  printf '%s,%s\n' "$f" "$row" >> "$out"
done

echo "Done. Results in $out"

jq -r '[.ID, .URL] | @csv' costruisce un frammento CSV correttamente quotato a partire dai due campi, e @csv gestisce per te eventuali virgole o virgolette presenti nei valori. Apri flipbooks.csv in un qualsiasi foglio di calcolo e avrai la tua lista di distribuzione.

Se preferisci recuperare il link di condivisione canonico separatamente, la CLI ha un comando dedicato proprio per questo — fliplink flipbook share-link <flipbookId> — che puoi richiamare con l'ID appena raccolto.

🚀

Prova FlipLink Gratis

Converti il tuo PDF in pochi secondi. Senza registrazione, senza carta di credito — basta caricare il file.

Drop your PDF here or click to browse

Max 40MB

I piani a pagamento da $39 portano questo limite a 150 MB.

Non lasciare che un file difettoso blocchi tutto il batch

Le cartelle sono caotiche. Un PDF potrebbe essere corrotto, troppo grande, oppure spingerti oltre la quota del tuo piano. Il loop predefinito registrerebbe tranquillamente l'errore come una riga e andrebbe avanti — ma non sapresti quali file hanno davvero funzionato.

La CLI ti dà un segnale chiaro tramite i suoi codici di uscita:

• 0 — successo
• 1 — un errore di richiesta o HTTP (rete, upload troppo grande, autenticazione)
• 2 — un errore applicativo (l'API ha restituito Result: ERROR, ad esempio quota superata)

Controlla il codice di uscita dopo ogni chiamata. Registra i successi nel CSV, i fallimenti in una lista separata, e tieni il batch in esecuzione in ogni caso:

#!/usr/bin/env bash
out="flipbooks.csv"
fail="failed.txt"
echo "file,id,url" > "$out"
: > "$fail"                            # truncate the failure log

ok=0; bad=0
for f in *.pdf; do
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f"

  if json="$(fliplink flipbook create "$f" --title "$name" --json)"; then
    row="$(printf '%s' "$json" | jq -r '[.ID, .URL] | @csv' 2>/dev/null)"
    printf '%s,%s\n' "$f" "$row" >> "$out"
    ok=$((ok + 1))
  else
    code=$?                            # 1 = request error, 2 = application error
    echo "$f (exit $code)" >> "$fail"
    bad=$((bad + 1))
  fi
done

echo "Converted $ok, failed $bad. See $out and $fail."

Poiché la CLI esce con un codice diverso da zero in caso di fallimento, il ramo if viene eseguito solo a fronte di un successo reale, quindi il tuo CSV non si riempie mai di righe vuote. Alla fine ottieni un conteggio e un failed.txt che elenca esattamente quali file analizzare — riavvia solo quelli una volta che li hai sistemati.

Una nota sull'assegnazione alle cartelle

Una domanda che salta fuori spesso: “Il loop può mettere tutto in una cartella FlipLink specifica?” Non esiste un flag --folder su fliplink flipbook create — non cercarlo, non c'è.

Un paio di cose da sapere su come funzionano le cartelle di FlipLink: vengono create su richiesta e spariscono di nuovo quando sono vuote, quindi non c'è nulla da pre-creare. Per mettere un flipbook in una cartella, usa la scappatoia della CLI — il comando api — che può raggiungere qualsiasi endpoint, compresi quelli senza un sottocomando dedicato:

fliplink api PUT /api/assign-to-folder/<flipbookId> --data '{"Folder":"Marketing/Q2"}'

Inserisci quella chiamata nel ramo di successo del loop, passando l'ID che hai raccolto dalla risposta della creazione. Se non sei sicuro dei nomi esatti dei campi per un endpoint, consulta il riferimento API in tempo reale invece di tirare a indovinare — ogni parametro è documentato lì, con una console Try-It.

Per concludere

Una cartella di PDF, un solo loop della shell e un CSV di link di condivisione pronto alla fine — è tutto qui il lavoro. Lo stesso schema scala da cinque file a cinquecento, e il controllo del codice di uscita fa sì che un singolo file difettoso non mandi mai all'aria l'intera esecuzione. Per saperne di più sui flussi di lavoro scriptabili di FlipLink, la documentazione della CLI copre ogni comando, e Operazioni in blocco spiega come tutto questo si inserisce in una pipeline di pubblicazione più ampia — perfetto per tenere aggiornati a blocchi i cataloghi di prodotti.

Letture correlate

• Primi passi con la CLI di FlipLink
• Scripting della CLI di FlipLink con jq
• Documentazione della CLI
• Operazioni in blocco
• Caso d'uso: cataloghi di prodotti
• Riferimento API