extranet/includes/html2pdf/_lisez_moi.txt

182 lines
11 KiB
Plaintext
Raw Normal View History

2009-06-16 08:47:07 +00:00
*******************************************************
** Ce programme est distribu<62> sous la licence LGPL, **
** reportez-vous au fichier _LGPL.txt ou <20> **
** http://www.gnu.org/licenses/lgpl.html **
** pour en savoir plus. **
** **
** Copyright 2000-2009 par Laurent Minguet **
*******************************************************
********************************
* HTML2PDF v3.22a - 15/06/2009 *
********************************
Utilisation :
------------
- regardez les exemples fournis pour voir le fonctionnement.
- les formulaires ne marchent QUE avec ADOBE READER 8 et ADOBE READER 9.0
- il est TRES IMPORTANT de fournir du HTML 4.01 valide au convertisseur,
mais seulement ce que contient le <body>
- pour les borders : il est conseill<6C> qu'ils soient au format "solid 1mm #000000"
- pour les paddings : ils ne sont applicables qu'aux balises table, th, td, div, li
- la liste des balises HTML reconnues se trouve dans le fichier "_balises_html.xls"
- la possibilit<69> de prot<6F>g<EFBFBD> vos PDF est pr<70>sente, CF Exemple 7. Elle utilise le script
fpdf_protection de Klemen Vodopivec.
- Certaines balises sp<73>cifiques ont <20>t<EFBFBD> introduites :
* <page></page> (CF Exemple 7) :
permet de d<>finir l'orientation, les marges left, right, top et bottom, l'image
et la couleur de fond d'une page, sa taille et position, le footer.
Il est egalement possible de garder les header et footer des pages pr<70>c<EFBFBD>dentes,
grace <20> l'attribue pageset="old" (CF Exemple 3)
* <page_header></page_header> (CF Exemple 3)
* <page_footer></page_footer> (CF Exemple 3)
* <nobreak></nobreak> :
permet de forcer l'affichage d'une partie sur une m<>me page.
Si cette partie ne rentre pas dans le reste de la page, un saut de page est
effectu<74> avant.
* <barcode></barcode> (CF Exemples 0 et 9) :
permet d'inserer des barcodes dans les pdfs, CF Exemples 0 et 9
Les types de codebar possible sont : EAN13, UPC_A, CODE39. Ceci utilise les
scripts de The-eh et Olivier
* <bookmark></bookmark> (CF Exemples 7 et About) :
permet d'inserer des bookmark dans les pdfs, CF Exemple 7 et About.
Il est egalement possible de cr<63>er un index automatiquement en fin de
document, CF exemple About.
Ceci utilise les scripts d'Olivier et de Min's
Modification :
-------------
3.22a: redistribution de HTML2PDF sous la licence LGPL !!! (au lieu de GPL)
3.22 : correction sur le background-color
refonte totale de la gestion de text-align. les valeurs center et right marchent maintenant meme en cas de contenu riche
3.21 : ajout de la propri<72>t<EFBFBD> css FLOAT pour la balise IMG
correction sur la gestion des TFOOT
correction sur le positionnement des images
3.20 : ajout de la gestion des margins pour la balise DIV
ajout de la gestion de la propriete css LINE-HEIGHT
correction sur l'interpretation de la valeur de certains styles CSS (background-image, background-position, ...)
correction sur la reconnaissance des balises thead et tfoot
correction sur la balise select
correction sur les fichiers de langue (merci <20> Sinan)
3.19 : optimisation du parseur HTML - merci <20> Jezelinside
ajout de la balise TFOOT
am<61>lioration de la gestion des tableaux : les contenus des balises THEAD et TFOOT sont maintenant r<>p<EFBFBD>t<EFBFBD>s sur chaque page.
ajout de la balise sp<73>cifique BOOKMARK afin de cr<63>er des "marques-page"
possibilit<69> de rajouter un index automatique en fin de fichier
ajout de la langue turque TR (merci <20> Hidayet)
am<61>lioration de la m<>thode Output. Elle est maintenant <20>galement utilisable comme celle de FPDF
3.18 : correction sur les sauts de page automatique pour les balises TABLE, UL, OL
correction sur l'interpretation des styles pour la balise HR
correction sur l'interpretation du style border-collapse pour la balise TABLE
prise en compte de margin:auto pour les tables et les divs
les commentaires dans les CSS sont accept<70>s
3.17 : ajout de la gestion des balises INPUT (text, radio, checkbox, button, hidden, ...), SELECT, OPTION, TEXTAREA (cf exemple 14)
ajout de la possibilit<69> de mettre des scripts dans le pdf, via $html2pdf->pdf->IncludeJS(...); (cf exemples JS)
correction sur le saut de page automatique pour les images
correction sur les sauts de lignes automatiques pour certaines balises (UL, P, ...)
ajout de la langue NL (merci <20> Roland)
3.16 : ajout de la gestion de list-style: none (cf exemple 13)
correction dans la gestion des fontes ajout<75>es <20> fpdf (via la m<>thode AddFont)
nombreuses corrections sur le calcul des largeurs des <20>l<EFBFBD>ments table, div, hr, td, th
ajout de l'exemple about.php
(pour info, les PDF g<>n<EFBFBD>r<EFBFBD>s <20> partir des exemples sont maintenant dans le r<>pertoire /exemples/pdf/, et sont supprimables)
3.15 : correction sur l'identification des styles en cas de valeurs multiples dans la propriete class
prise en compte de border-radius pour la limite des backgrounds (color et image)
ajout des proprietes CSS border-top-*, border-right-*, border-bottom-*, border-left-*
ajout de la propri<72>t<EFBFBD> CSS list-style-image (cf exemple 12)
pour la balise table, ajout de l'interpr<70>tation de align="center" et align="right" (cf exemple 1)
correction dans le positionnement des images
correction de quelques bugs
ajout d'une fonction d'analyse des ressources HTML2PDFgetTimerDebug (cf d<>but du fichier html2pdf.class.php)
3.14 : ajout d'une langue (pt : Brazilian Portuguese language) et amelioration de la methode vueHTML (merci <20> Rodrigo)
correction du positionnement du contenu des DIVs. gestion des proprietes valign et align
ajout de la propriete CSS border-collapse (cf exemple 0)
ajout de la propriete CSS border-radius (cf exemple 1)
correction de quelques bugs
3.13 : reecriture de la balise hr, avec prise en compte des styles (cf exemple 0)
ajout de la propriete backcolor pour la balise page (cf exemple 9)
ajout des proprietes backleft et backright pour la balise page afin de pouvoir changer les marges des pages (cf exemple 8)
nombreuses corrections sur les balises et les styles
3.12 : ajout des balises ol, ul, li (cf exemple 12)
correction sur le calcul de la taille des td en cas de colspan et rowspan
ajout de la m<>thode setTestTdInOnePage afin de pouvoir desactiver le test sur la taille des TD (cf exemple 11)
correction de quelques bugs
3.11 : ajout des balises div, p, pre, s
gestion des styles CSS position (relative, absolute), left, top, right, bottom (cf exemple 10)
meilleur gestion des border : border-style, border-color, border-width (cf exemple 10)
possibilit<69> d'indiquer les marges par d<>fault, via le constructeur (cf exemple 2)
3.10a: correction pour compatibilit<69> php4 / php5
3.10 : ajout des liens internes (cf exemple 7)
gestion complete des background : image, repeat, position, color (cf exemple 1)
gestion de underline, overline, linethrough (cf exemple 2)
correction de quelques bugs
3.09 : mise <20> jour vers fpdf version 1.6, ajout de barcode, correction de l'affichage de certains caract<63>res sp<73>ciaux
correction du calcul de la hauteur de ligne de la balise br
detection en cas de contenu trop grand dans un TD
am<61>lioration de la balise page (ajout de l'attribue pageset, avec les valeurs new et old)
ajout de FPDF_PROTECTION, accesible via $pdf->pdf->SetProtection(...)
3.08 : version op<6F>rationnelle de page_header, ajout de page_footer, correction des borders des tableaux
3.07 : correction de l'interpretation de cellspacing, am<61>lioration de la balise page_header
3.06 : premi<6D>re gestion de la balise page_header, correction des dimensions des tableaux
3.05 : ajout de la propri<72>t<EFBFBD> vertical-align, ajout de la gestion des fichiers de langue
3.04 : correction du saut de page automatique pour les tableaux. Ajout de propri<72>t<EFBFBD>s <20> la balise PAGE
3.03 : correction de bugs au niveau de la gestion des images PHP par FPDF, meilleure gestion des erreurs
3.02 : ajout de la gestion des noms des couleurs, correction de la gestion des images g<>n<EFBFBD>r<EFBFBD>es par php, correction de quelques bugs
3.01 : correction de quelques bugs, ajout d'une protection pour les balises non existantes
3.00 : refont totale du calcul des tableaux. Prise en compte des colspan et rowspan
2.85 : ajout de la propri<72>t<EFBFBD> cellspacing, nouvelle gestion des padding des tableaux (identique <20> l'html)
2.80 : ajout des types de border dotted et dasheds
2.75 : ajout des top, left, right, bottom pour padding et border
2.70 : correction de la balise HR, ajout de la propri<72>t<EFBFBD> padding pour les table, th, td
correction des dimensions, les unit<69>s px, mm, in, pt sont enfin r<>ellement reproduites, correction de font-size, border, ...
ajout d'une propri<72>t<EFBFBD> <20> la balise page : footer
correction dans l'affichage et le calcul des tables
2.55 : v<>rification de la validit<69> du code (ouverture / fermeture) - ajout des unit<69>s mm, in, pt
2.50 : correction de nobreak, des marges, ajout de nombreuses balises
2.40 : refonte totale de l'identification des styles CSS. Les h<>ritages marchent.
2.39 : corrections diverses, ajout de certaines propri<72>t<EFBFBD>s (bgcolor, ...)
2.38 : meilleur identification des propri<72>t<EFBFBD>s border et color
2.37 : nombreuses corrections : balise A, couleur de fond, retour <20> la ligne, gestion des images dans un texte, ...
2.36 : ajout des balises STRONG, EM
2.35 : am<61>lioration de la gestion des feuilles de style
2.31 : correction de quelques bugs
2.30 : premi<6D>re version op<6F>rationnel des feuilles de style
2.25 : ajout de la balise LINK pour le type text/css
2.20 : premier jet de la gestion des feuilles de style, ajout de la balise STYLE
2.15 : n'interpr<70>te plus l'HTML en commentaire <!-- -->
2.10 : ajout des balises H1 -> H6
2.01 : correction de quelques bugs
2.00 : premi<6D>re version diffus<75>e
Aide et Support :
----------------
pour toutes questions et rapport de bug, merci d'utiliser exclusivement le lien de support ci-dessous.
Je ne r<>pondrais <20> aucune question en dehors, afin que tout le monde puisse profiter des r<>ponses.
Informations :
-------------
Programmation en PHP4
Programmeur : Spipu
email : webmaster@spipu.net
site : http://html2pdf.fr/
wiki : http://html2pdf.fr/wiki.php
support : http://html2pdf.fr/forum.php
Remerciement :
-------------
* Olivier PLATHEY pour sa librairie Fpdf (http://www.fpdf.org/)
* yAronet pour l'hebergement du forum de support
* toutes les personnes qui m'ont aid<69> <20> d<>velopper cet librairie, et <20> traduire les diff<66>rents textes