Full Circle Magazine FR

Outils pour utilisateurs

Outils du site

Piste :
issue159:python

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
Prochaine révisionLes deux révisions suivantes
issue159:python [2020/08/03 08:01] – d52frissue159:python [2020/08/05 23:09] – d52fr
Ligne 4: Ligne 4:
  
 It's rather old, and there hasn't been much activity recently. In fact, the last update to the repository was about 3 years ago.** It's rather old, and there hasn't been much activity recently. In fact, the last update to the repository was about 3 years ago.**
 +
 +PyFPDF est une bibliothèque qui vous permet de générer des documents PDF sous Python. Elle a été portée à partir de FPDF (« Free » -PDF) dans une bibliothèque en PHP. Le dépôt est sur github à https://github.com/reingart/pyfpdf et la documentation est à https://pyfpdf.readthedocs.io/en/latest/index.html
 +
 +certaines des fonctionnalités que cette bibliothèque fournit sont la possibilité d'inclure des images graphiques, des impressions à une position définie, des lignes, rectangles, ellipses, entêtes et pieds de page, et la possibilité de créer des formulaires pré-définis pour des choses comme des factures.
 +
 +Elle est assez ancienne et il n'y a pas eu beaucoup d'activité récente. En fait, la dernière mise à jour dans le dépôt date d'environ 3 ans. 
  
 **You can easily install it with pip by using: **You can easily install it with pip by using:
Ligne 14: Ligne 20:
  
 from the clone main folder.** from the clone main folder.**
 +
 +Vous pouvez facilement l'installer avec pip en utilisant :
 +
 +pip install fpdf
 +
 +ou vous pouvez cloner le dépôt github et, à partir de là, l'installer via pip comme ceci :
 +
 +pip install -e
 +
 +depuis le dossier principal du clone.
  
 **Let's jump right in and create our first example program. Enter this program into your favorite IDE and save it as “ftest1.py”. We’ll make some changes to it later on. **Let's jump right in and create our first example program. Enter this program into your favorite IDE and save it as “ftest1.py”. We’ll make some changes to it later on.
Ligne 26: Ligne 42:
  
 Now we'll break down the program. After we import the FPDF library, we instantiate the library, by calling pdf=FPDF(), with the default options.** Now we'll break down the program. After we import the FPDF library, we instantiate the library, by calling pdf=FPDF(), with the default options.**
 +
 +Plongeons-nous dedans et créons notre premier exemple de programme. Saisissez ce programme dasn votre IDE favori et sauvegardez-le sous « ftest1.py ». Plus tard, nous le modifierons un peu.
 +
 +from fpdf import FPDF
 +
 +pdf = FPDF()
 +pdf.add_page()
 +pdf.set_font('Arial', 'B', 16)
 +pdf.cell(40, 10, 'Hello Full Circle Magazine!')
 +pdf.output('tuto1a.pdf', 'F')
 +
 +Maintenant, décomposons le programme, Après l'import de la bibliothèque FPDF, nous instancions la bibliothèque, par l'appel pdf=FPDF(), avec les options par défaut.
  
 **Next, we add a page. These are pretty much the first two things that you have to do before you can do anything else. **Next, we add a page. These are pretty much the first two things that you have to do before you can do anything else.
Ligne 37: Ligne 65:
 orientation = (p:portrait, l:landscape) (default = Portrait) orientation = (p:portrait, l:landscape) (default = Portrait)
  
-  units = (pt:point, mm:millimeter, cm:centimeter, in:inch) (default is mm)+units = (pt:point, mm:millimeter, cm:centimeter, in:inch) (default is mm)
  
- format = (A3, A4, A5, Letter, Legal) (default is A4) (see below)**+format = (A3, A4, A5, Letter, Legal) (default is A4) (see below)** 
 + 
 +Ensuite, nous ajoutons une page. Ce sont pratiquement les deux premières choses que vous devez faire avant que vous puissiez faire autre chose. 
 + 
 +Ensuite, nous paramétrons la police par défaut pour la page ; après, nous utilisons la méthode cell pour imprimer un simple texte et, alors, nous appelons la méthode output pour créer le fichier pdf lui-même. 
 + 
 +Quand nous avons créé l'objet PDF, come je l'ai dit, nous avons utilisé les paramètres par défaut. Voici les options : 
 + 
 +pdf = FPDF(orientation, units, page format) 
 + 
 +où : 
 +       
 +orientation = (p:portrait, l:landscape) (valeur par défaut = Portrait) 
 + 
 +  units = (pt:point, mm:millimeter, cm:centimeter, in:inch) (la valeur par défaut est mm) 
 + 
 + format = (A3, A4, A5, Letter, Legal) (A4 est la valeur par défaut) (voir ci-dessous)
  
 **If you need a custom page size, you can send a tuple with the width and height in the given units. If you are using Portrait mode, the order should be (width, height), but if you are using landscape, it should be (height, width). Also, try as I might, I couldn't get the units to work with the inch option. Nothing seems to render, so I stick with 'mm'. **If you need a custom page size, you can send a tuple with the width and height in the given units. If you are using Portrait mode, the order should be (width, height), but if you are using landscape, it should be (height, width). Also, try as I might, I couldn't get the units to work with the inch option. Nothing seems to render, so I stick with 'mm'.
Ligne 53: Ligne 97:
 •  Symbol •  Symbol
 •  ZapfDingbats** •  ZapfDingbats**
 +
 +Si vous avez besoin d'une taille de page personnalisée, vous pouvez envoyer un tuple avec la largeur et la hauteur dans les unités données. Si vous utilisez le mode Portrait, l'ordre devrait être (largeur, hauteur), mais, si vous utilisez le paysage, il devrait être (hauteur, largeur). De plus, essayez comme je le fit, je n'ai pas réussi à faire marcher les unités avec l'option « inch » (pouce). Rien en semblait être restitué ; je suis donc resté aux mm.
 +
 +Ensuite, nous réglons la police à utiliser. L'appel est :
 +
 +<nowiki>fpdf.set_font(family, style='', size = 0)</nowiki>
 +
 +La méthode set-font vous permet de spécifier la police à utiliser pour les lignes suivantes du texte à restituer. Cependant, ce n'est pas aussi libre que vous pourriez le penser. Il y a cinq polices normales utilisables qui sont pré-définies (sauf si vous ajoutez « add_font » en premier). Les voici :
 +• Courier (largeur fixe)
 +• Helvetica or Arial
 +• Times
 +• Symbol
 +• ZapfDingbats
 +
  
 **These 5 fonts provide fixed width, sans-serif, serif, and two symbolic fonts. The font family parameter is case insensitive as well as the font style. Those styles can be: **These 5 fonts provide fixed width, sans-serif, serif, and two symbolic fonts. The font family parameter is case insensitive as well as the font style. Those styles can be:
Ligne 66: Ligne 124:
 If you want to use a special font for some reason, outside of the standard font set provided, you can use the add_font method. However, it is fairly difficult, so we'll discuss it in a future article. In the meantime, you can look at the documentation to see how to do it.** If you want to use a special font for some reason, outside of the standard font set provided, you can use the add_font method. However, it is fairly difficult, so we'll discuss it in a future article. In the meantime, you can look at the documentation to see how to do it.**
  
-**Now, we'll take a look at the cell method, that allows you to place the text to be rendered. This method will print a rectangular area with optional borders, possibly background and foreground colors, and the character string. The text can be aligned to the right or left or can be centered. When the call is finished, the current position moves to the right or to the next line, depending on a parameter passed, and allows for an optional link to be attached to the text. The format of the method parameters is fairly comprehensive, but, luckily, the author of the library has set a number of defaults, so it isn't as bad as it could be.+Parmi ces 5 polices sont fournies une à largeur fixe, une sans-serif, une serif et deux polices symboliques. Le paramètre des familles de polices est insensible à la casse de même qu'au style de police. Ces styles peuvent être :
  
 +     B : gras
 +     I : italique
 +     U : sousligné
 +     vide : normal
 +     
 +Note : si vous voulez changer la taille de la police dans le document, changer la famille ou le style, vous pouvez appeler :
 +
 +fpdf.set_font_size(size)
 +
 +Si vous voulez utiliser une police spéciale pour un raison quelconque, en dehors de u lot de polices fournies en standard, vous pouvez utiliser la méthode add_font. Cependant, elle est assez compliquée, donc nous en parlerons dans en un article futur. Entre temps, vous pouvez regarder la documentation pour voir comment le faire.
 +
 +**Now, we'll take a look at the cell method, that allows you to place the text to be rendered. This method will print a rectangular area with optional borders, possibly background and foreground colors, and the character string. The text can be aligned to the right or left or can be centered. When the call is finished, the current position moves to the right or to the next line, depending on a parameter passed, and allows for an optional link to be attached to the text. The format of the method parameters is fairly comprehensive, but, luckily, the author of the library has set a number of defaults, so it isn't as bad as it could be.
  
 fpdf.cell(w, h=0, txt='', border=0, ln=0, align='', fill=false, link='') fpdf.cell(w, h=0, txt='', border=0, ln=0, align='', fill=false, link='')
  
  We'll take a look at each parameter in a bit more depth...**  We'll take a look at each parameter in a bit more depth...**
 +
 +Maintenant, nous allons regarder la méthode cell, qui vous permet de placer le texte à restituer. cette méthode imprimera une zone rectangulaire avec des bordures optionnelles, un possibilité de couleurs de fond et de premier-plan, et la chaîne de caractères. Le texte peut être aligné à droite ou à gauche, ou peut être centré. Quand l'appel est fini, la possition actuelle se déplace à d'autre ou sur la ligne suivante, suivant comment un paramètre a été passé, et vous donne la possibilité d'attacher un lien optionel au texte. Le format des paramètres de la méthode se comprend plutôt bien, mais, par chance, l'auteur de la bilbiothèque a placé un certain nombre de défauts ; aussi, elle n'est pas aussi mauvaise qu'elle l'aurait pu.
 +
 +fpdf.cell(w, h=0, txt='', border=0, ln=0, align='', fill=false, link='')
 +
 +Regardons chacun des paramètres un peu plus en détail...
    
 **w: Cell width. If this value is 0, the cell will extend to the right margin. **w: Cell width. If this value is 0, the cell will extend to the right margin.
Ligne 90: Ligne 166:
  
 Finally, we call pdf.output to render the file and save it as the filename specified (which is the ‘F’ parameter). There are other parameters that you can research in the document.** Finally, we call pdf.output to render the file and save it as the filename specified (which is the ‘F’ parameter). There are other parameters that you can research in the document.**
 +
 +w - largeur de la cellule. Si cette valeur est 0, la cellule s'étendra jusqu'à la marge droite.
 +
 +h - hauteur de la cellule. La valeur par défaut est 0.
 +
 +txt - la chaîne à imprimer.
 +
 +border - 0 : pas de bordure. 1 ; cadre (ou une chaîne contenant quelles sont les lignes du cadre à restituer)
 +
 +ln - 0 : à droite. 1 : au début de la ligne suivante. 2 : en dessous.
 +
 +align - « L » : alignement à gauche, « C » : centré, « R » : alignement à droite
 +
 +fill - True : fond coloré. False : transparent. Valeur par défaut = False
 +
 +link - URL ou indentifiant retourné par add_link()
 +
 +Enfin, nous appelons pdf.output pour un rendu du fichier et sa souvegarde sous le nom de fichier spécifié (qui est le paramètre « F »). Il y a d'autres paramètres, que vous pouvez chercher dans le document.
  
 **Once the program is done, you can open it with your default PDF viewer. It should look something like the image above. **Once the program is done, you can open it with your default PDF viewer. It should look something like the image above.
Ligne 102: Ligne 196:
  
 Notice that we added all the parameters for the cell method. In this version, we will be adding a border with transparent fill, make the text centered, have the cell go from the far left extending to the far right of the page, set the next text line to be on the line below, and added a link to the Full Circle Magazine website, when you click on the text. We also changed the output file name.** Notice that we added all the parameters for the cell method. In this version, we will be adding a border with transparent fill, make the text centered, have the cell go from the far left extending to the far right of the page, set the next text line to be on the line below, and added a link to the Full Circle Magazine website, when you click on the text. We also changed the output file name.**
 +
 +Une fois le proramme terminé, vous pouvez l'ouvrir avec votre visionneuse de PDF par défaut. IL devrait ressembler à quelque chose comme l'image ci-dessus.
 +
 +Maintenant, nous regarderons l'ajout du paramètre link (lien) à la méthode cell. Canfez les deux dernières lignes de votre programme de test pour :
 +
 +pdf.cell(0, 10, 'Hello Full Circle Magazine!',
 +
 +    1,1,'C',0,"http://fullcirclemagazine.org")
 +
 +pdf.output('test1a.pdf', 'F')
 +
 +Notez que nous avons ajouté tous les paramètres à la méthode cell. Dans cette version, nous ajouterons une bordure avec un remplissage transparent, centrerons le texte, la cellule s'étendant de l'extrême gauche à l'extrême droite de la page, paramètrerons pour que la prochaine ligne soit sur la ligne du dessous et ajouterons un lien vers le site Web du Full Circle Magazine, quand nous cliquons sur le texte. Nous changerons aussi le nom du fichier de sortie.
  
 **Save the program as “test1a” and try it again (see image below). **Save the program as “test1a” and try it again (see image below).
issue159/python.txt · Dernière modification : 2020/08/09 09:48 de auntiee