PDF.js: installation et utilisation
par Christophe Lerolle, le 13 février 2020

0- Inspiration:
--------------

PDF.js est intégré nativement dans les navigateurs Firefox et Chrome.
Pour certains autres, on peut l'ajouter sous forme d'extension du navigateur.

J'ai trouvé l'idée de l'auto-héberger dans http://influence-pc.fr/14-03-2014-inclure-des-pdf-sur-votre-site-avec-pdf-js-cree-par-mozilla
Le principal intérêt est de permettre un affichage de tout fichier PDF directement dans le navigateur,
de façon identique quel que soit le navigateur et l'OS employés. 
( quelques navigateurs ne permettent pas d'élargir le panneau de gauche - Table des Matières... dommage. )
De plus les fonctions d'affichage sont traduites, à ce jour, en 124 langues visibles dans /1com/pdf.js/web/locale
J'ai testé PDF.js avec succès sous Windows, Android, iOS, MacOS et Linux. 

La page d'enrobage "affiche.php", facultative, ajoute une aide au visiteur qui ne connaît pas la présentation de PDF.js
et permet au webmestre de tracer les fichiers visionnés...

1- Installation:
---------------

sous ch.lerolle.free.fr/1com j'ai créé le dossier pdf.js
j'y ai installé les 2 sous-dossiers build et web, obtenus dans http://mozilla.github.io/pdf.js/getting_started/ (pris la version Stable v 2.2.228)
ainsi que le présent tutoriel
c'est prêt !

2- Utilisation:
--------------

exemple 1: http://ch.lerolle.free.fr/1com/pdf.js/web/viewer.html?file=/rsrc/ebook/arch-gratuit/Guide.boum.org-d-autodefense-numerique-tome2-en-ligne-a4-20170713.pdf
utilisation sans aide ni compteur-de-visite: affiche le fichier ouvert à la première page

exemple 2: http://ch.lerolle.free.fr/1com/pdf.js/web/viewer.html?file=/rsrc/ebook/arch-gratuit/Guide.boum.org-d-autodefense-numerique-tome2-en-ligne-a4-20170713.pdf#part.3
affiche le fichier ouvert à la page 125 ( chapitre 3 = Outils)

exemple 3: http://ch.lerolle.free.fr/1com/affiche.php?doc=/rsrc/ebook/arch-gratuit/Guide.boum.org-d-autodefense-numerique-tome2-en-ligne-a4-20170713.pdf
affiche le fichier "enrobé" par la page générique http://ch.lerolle.free.fr/1com/affiche.php ,
dont le source est ici: http://ch.lerolle.free.fr/1com/affiche-source.php?file=/1com/affiche.php

3- Commentaires sur la page d'enrobage "affiche.php":
----------------------------------------------------

○ le traitement du format PDF commence en ligne 40,
○ l'aide affichée commence en ligne 56,
○ l'appel du script de mise en forme est fait en ligne 115. 
J'ai choisi d'ouvrir le doc en 'Pleine Largeur', via #zoom=page-width, 
on peut préférer en 'Pleine Page' avec l'option #zoom=page-fit (pour connaître le paramétrage d'une option, choisir le mode d'affichage au centre, puis copier la cible affichée en survolant à droite le bouton Marque-page (Affichage courant). 
○ la variable $chemin_document contient le chemin d'accès au document à afficher, relatif à la racine du site. Pour des raisons de sécurité, les développeurs ont choisi de n'autoriser la mise en page d'un fichier seulement s'il est sur le même serveur que le script...