Modules

Bibliothèque `pdfreader` (pdfReader) — v1.0.0

20 commandes pour BERKIOS CODE qui gèrent la lecture d'un PDF page par page : navigation, progression, signets, reprise de lecture, citation et zoom. Chaque commande existe en français, anglais, espagnol et swahili ; la forme qualifiée pdfreader.<nom> fonctionne aussi. Permission demandée : stockage (uniquement pdf-memoriser et pdf-reprendre).

Bibliothèque de macros et lecteur natif : deux responsabilités distinctes

Une bibliothèque BERKIOS (format berkios-library/1) est un ensemble de macros : elle combine les commandes intégrées et ne peut pas, à elle seule, ouvrir un fichier ni décoder son contenu.

Le runtime Flutter de BERKIOS GRAPHIC intègre désormais le composant natif Lecteur PDF (type: "pdfreader"), disponible dans la catégorie Affichage & contenu et utilisé par l'exemple examples/bibliotheques/05-lecteur-pdf-natif.berkios.json. Ce composant ouvre le sélecteur de fichiers de l'appareil et affiche le PDF réellement sélectionné via file_picker et pdfrx/PDFium. Le document est lisible à l'écran, avec défilement, zoom et sélection de texte.

La bibliothèque pdfreader reste responsable de l'état de lecture (page, progression, signets, reprise, calculs et citations). Ses macros seules ne rendent pas le PDF et ne remplissent pas automatiquement les champs page/total. L'extraction du texte du document dans une variable BERKIOS CODE n'est pas encore exposée par une commande dédiée.

Conventions

Une page, un total, un zoom, des signets ou un résultat sont des noms de composants ou de variables $nom. Les signets sont une liste de numéros séparés par des virgules (3, 7, 12), sans doublon et triée.

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-page-suivante` · `pdf-next-page` · `pdf-pagina-siguiente` · `pdf-ukurasa-unaofuata`	`pdf-page-suivante "Page" "Total"`	Passe à la page suivante, sans dépasser le nombre total de pages.
`pdf-page-precedente` · `pdf-previous-page` · `pdf-pagina-anterior` · `pdf-ukurasa-uliotangulia`	`pdf-page-precedente "Page"`	Revient à la page précédente, sans descendre sous la page 1.
`pdf-premiere-page` · `pdf-first-page` · `pdf-primera-pagina` · `pdf-ukurasa-wa-kwanza`	`pdf-premiere-page "Page"`	Va à la première page.
`pdf-derniere-page` · `pdf-last-page` · `pdf-ultima-pagina` · `pdf-ukurasa-wa-mwisho`	`pdf-derniere-page "Page" "Total"`	Va à la dernière page (le total doit être renseigné).
`pdf-aller-page` · `pdf-go-to-page` · `pdf-ir-a-pagina` · `pdf-nenda-ukurasa`	`pdf-aller-page "Page" "Total" "Numéro"`	Va à un numéro de page, ramené entre 1 et le total (décimales ignorées).

Progression

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-page-sur` · `pdf-page-of` · `pdf-pagina-de` · `pdf-ukurasa-wa`	`pdf-page-sur "Page" "Total" "Résultat"`	Écrit le repère « 3 / 12 ».
`pdf-progression` · `pdf-progress` · `pdf-progreso` · `pdf-maendeleo`	`pdf-progression "Page" "Total" "Résultat"`	Pourcentage de lecture (page / total), de 0 à 100, arrondi à l'entier.
`pdf-pages-restantes` · `pdf-pages-left` · `pdf-paginas-restantes` · `pdf-kurasa-zilizobaki`	`pdf-pages-restantes "Page" "Total" "Résultat"`	Nombre de pages qu'il reste à lire (0 si la dernière page est atteinte).
`pdf-temps-restant` · `pdf-time-left` · `pdf-tiempo-restante` · `pdf-muda-uliobaki`	`pdf-temps-restant "Page" "Total" "Minutes par page" "Résultat"`	Estimation, en minutes, du temps de lecture restant.

Reprise de lecture

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-memoriser` · `pdf-remember` · `pdf-recordar` · `pdf-kumbuka`	`pdf-memoriser "clé" "Page"`	Mémorise la page atteinte pour la prochaine ouverture de l'application.
`pdf-reprendre` · `pdf-resume` · `pdf-reanudar` · `pdf-endelea`	`pdf-reprendre "clé" "Page"`	Relit la page mémorisée (page 1 si rien n'a été mémorisé).

Signets

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-signet-ajouter` · `pdf-bookmark-add` · `pdf-marcador-agregar` · `pdf-alamisho-ongeza`	`pdf-signet-ajouter "Signets" "Page"`	Ajoute une page à la liste des signets (sans doublon, triée).
`pdf-signet-retirer` · `pdf-bookmark-remove` · `pdf-marcador-quitar` · `pdf-alamisho-ondoa`	`pdf-signet-retirer "Signets" "Page"`	Retire une page de la liste des signets.
`pdf-signet-existe` · `pdf-bookmark-exists` · `pdf-marcador-existe` · `pdf-alamisho-ipo`	`pdf-signet-existe "Signets" "Page" "Résultat"`	true si la page est déjà dans les signets, sinon false.
`pdf-signets-nombre` · `pdf-bookmark-count` · `pdf-marcadores-total` · `pdf-alamisho-idadi`	`pdf-signets-nombre "Signets" "Résultat"`	Nombre de signets.

Document et citation

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-est-pdf` · `pdf-is-pdf` · `pdf-es-pdf` · `pdf-ni-pdf`	`pdf-est-pdf "Nom" "Résultat"`	true si le nom ou l'adresse se termine par .pdf (majuscules acceptées).
`pdf-ouvrir-lien` · `pdf-open-link` · `pdf-abrir-enlace` · `pdf-fungua-kiungo`	`pdf-ouvrir-lien "https://exemple.org/guide.pdf"`	Ouvre l'adresse http(s) d'un PDF écrite dans le script (pas un nom de composant) ; refuse une adresse invalide ou qui ne finit pas par .pdf.
`pdf-citation` · `pdf-quote` · `pdf-cita` · `pdf-nukuu`	`pdf-citation "Résultat" "Document" "Page" "Extrait"`	Compose une citation : « extrait » — document, p. 3.

Zoom

Commande (fr · en · es · sw)	Syntaxe	Effet
`pdf-zoom-avant` · `pdf-zoom-in` · `pdf-acercar` · `pdf-kuza`	`pdf-zoom-avant "Zoom"`	Augmente le zoom de 25 points (100 par défaut, 400 maximum).
`pdf-zoom-arriere` · `pdf-zoom-out` · `pdf-alejar` · `pdf-punguza`	`pdf-zoom-arriere "Zoom"`	Diminue le zoom de 25 points (25 minimum).

Exemple

quand clic
  pdf-page-suivante "page" "total"
  pdf-progression "page" "total" "progression"
  pdf-memoriser "mon-livre" "page"

quand clic
  pdf-signet-ajouter "signets" "page"
  pdf-citation "citation" "document" "page" "extrait"

Deux projets complets, qui embarquent la bibliothèque, sont dans examples/bibliotheques/ : 03-liseuse-pdf.berkios.json (navigation, progression, signets, zoom, reprise) et 04-fiche-lecture-pdf.berkios.json (temps restant, citation, copie et export). Régénérer : node scripts/build-bibliotheque-pdfreader-example.mjs.

Bon à savoir

Total obligatoire : pdf-page-suivante, pdf-derniere-page, pdf-aller-page et pdf-progression s'arrêtent avec « Nombre de pages inconnu. » si le total est vide ou inférieur à 1.
pdf-ouvrir-lien : l'adresse doit être écrite directement dans le script (pdf-ouvrir-lien "https://…/guide.pdf"), car la commande intégrée ouvrir ne lit pas la valeur d'un composant. Elle refuse une adresse qui n'est pas http(s) ou ne finit pas par .pdf.
Mémoire partagée : pdf-memoriser utilise la mémoire locale de l'application ; donnez à la clé un nom propre ("mon-livre") pour ne pas écraser d'autres valeurs.
Variables réservées : les commandes utilisent en interne des variables commençant par $pdf. Évitez ces noms dans vos scripts.
Dans une ligne : comme toute commande de bibliothèque, elles s'utilisent en début de ligne (pas après si … alors).
Traductions espagnole et swahilie écrites sans relecture par des locuteurs natifs : à relire avant diffusion large.
Le Dart généré n'a pas été compilé ici ; seules les commandes intégrées déjà présentes dans le runtime sont utilisées.

Cette page en Markdown · llms.txt · documentation complète pour les IA

Bibliothèque pdfreader (pdfReader) — v1.0.0