library/html2pdf/LISEZMOI.md

   1 HTML2PDF v4.5.0 - 2015-12-18
   2 ============================
   3
   4 License:
   5 --------
   6 ```
   7  Ce programme est distribué sous la licence LGPL,
   8  Pour plus d'informations, reportez-vous au fichier _LGPL.txt ou à
   9  http://www.gnu.org/licenses/lgpl.html
  10
  11  Copyright 2008-2015 par Laurent Minguet
  12 ```
  13
  14 Utilisation :
  15 ------------
  16
  17  * nécessite au minimum PHP 5.3.2
  18
  19  * Utilisez composer pour l'installer
  20    * Composer : https://getcomposer.org/
  21    * Package officiel : spipu/html2pdf
  22
  23  * Si vous installez html2pdf sans utiliser composer, cela ne marchera pas.
  24    Vous devez faire "composer install" dans le répertoire d'html2pdf
  25    afin d'installer TCPDF en tant que dépendance.
  26
  27  * regardez les exemples fournis, et lisez le wiki pour comprendre le fonctionnement.
  28
  29  * il est TRES IMPORTANT de fournir du HTML 4.01 valide au convertisseur,
  30  mais seulement ce que contient le `<body>`. Utilisez la balise `<page>`.
  31
  32  * pour les borders : il est conseillé qu'ils soient au format `solid 1mm #000000`
  33
  34  * pour les paddings : ils ne sont applicables qu'aux balises table, th, td, div, li
  35
  36  * Une fonte par défaut peut être précisée,au cas ou la fonte demandée n'existe pas ou si aucune fonte n'est indiquée :
  37
  38  `$html2pdf->setDefaultFont('Arial');`
  39
  40  * la possibilité de protéger vos PDF est présente, CF Exemple 7.
  41
  42  * Certains tests peuvent être activés (true) ou de désactivés(false) :
  43
  44   * méthode setTestIsImage      : tester que les images existent bien
  45
  46   * méthode setTestTdInOnePage  : tester que le contenu des TDs rentre sur une seule page
  47
  48   * méthode setTestIsDeprecated : tester que les anciennes propriétes des balises spécifiques ne sont plus présentes
  49
  50  * Un mode DEBUG permettant de connaitre les ressources utilisées lors de la construction du PDF est présent.
  51 Il est activable en rajoutant la commande suivante juste après le constructeur (cf exemple 0):
  52 `$htmlpdf->setModeDebug();`
  53
  54  * Certaines balises spécifiques ont été introduites :
  55
  56   * <page></page>  (CF Exemple 7 & wiki)
  57     * permet de définir le format, l'orientation, les marges left, right, top et bottom, l'image
  58     * et la couleur de fond d'une page, sa taille et position, le footer.
  59     * Il est également possible de garder les header et footer des pages précédentes,
  60     * grâce à l'attribue pageset="old" (CF Exemple 3 & 4 & wiki)
  61
  62   * <page_header></page_header> (CF Exemple 3 & wiki)
  63
  64   * <page_footer></page_footer> (CF Exemple 3 & wiki)
  65
  66   * <nobreak></nobreak> (cf wiki)
  67     * permet de forcer l'affichage d'une partie sur une même page.
  68     * Si cette partie ne rentre pas dans le reste de la page, un saut de page est effectué avant.
  69
  70   * <barcode></barcode>  (CF Exemples 0 et 9 & wiki)
  71     * permet d'insérer des barcodes dans les pdfs, CF Exemples 0 et 9
  72     * Les types de codebar possible sont ceux de TCPDF
  73
  74   * <qrcode></qrcode> (CF Exemple 13 & wiki)
  75     * permet d'insérer un codebar à 2 dimensions de type QRcode
  76     * (QR Code is registered trademark of DENSO WAVE INCORPORATED | http://www.denso-wave.com/qrcode/)
  77
  78   * <bookmark></bookmark>  (CF Exemples 7 & About & wiki)
  79     * permet d'insérer des bookmarks dans les pdfs, CF Exemple 7 et About.
  80     * Il est également possible de créer un index automatiquement en fin de document (cf wiki)
  81
  82   * propriété css "rotate" :
  83     * valeurs possibles : 0, 90, 180, 270
  84     * applicable uniquement sur les divs (cf exemple 8)
  85
  86 change log :
  87 ------------
  88
  89 Regardez le fichier _changelog.txt
  90
  91 Aide et Support :
  92 -----------------
  93
  94  pour toutes questions et rapport de bug, merci d'utiliser exclusivement le lien de support ci-dessous.
  95  Je ne répondrai à aucune question en dehors, afin que tout le monde puisse profiter des réponses.
  96
  97 Informations :
  98 -------------
  99
 100 * Programmeur : Spipu
 101 * Web Site    : http://html2pdf.fr/
 102 * Wiki        : http://html2pdf.fr/fr/wiki
 103 * Support     : http://html2pdf.fr/fr/forum
 104
 105 Remerciement :
 106 --------------
 107
 108  * Olivier Plathey pour avoir conçu FPDF
 109  * Nicola Asuni pour les modifications qu'il a accepté d'apporter à TCPDF
 110  * yAronet pour l'hébergement du forum de support
 111  * toutes les personnes qui m'ont aidé à développer cette librairie, et à traduire les différents textes