HTMLgen

Package non standard à installer en plus, qui permet de générer du html. Faire ensuite : import HTMLgen.

Exemple de génération d'un document :

    doc = HTMLgen.SimpleDocument()
    doc.append(HTMLgen.Heading(1, 'MyPage', align = 'center'))
    menuList = HTMLgen.List()
    menuList.append('first item ' + str(HTMLgen.Href(myUrl1, 'with link1')))
    menuList.append('second item ' + str(HTMLgen.Href(myUrl2, 'with link1')))
    doc.append(menuList)
    doc.append(HTMLgen.Div('some text'))
    doc.write()
  

Les deux façons d'inclure des sous-éléments dans un élément donné (ici un div) :

• une façon plus propre :

  div = HTMLgen.Div()
  div.append('line1')
  div.append(HTMLgen.BR())
  div.append('line2')
      

• une façon moins propre, en concaténant du texte :

  div = HTMLgen.Div(html_escape = 'off')
  div.append('line1' + str(HTMLgen.BR()) + 'line2')
      

Définition des éléments :

• on peut mettre un style à un document : HTMLgen.SimpleDocument(style = 'div.main {display: inline-block; background: yellow}')
• HTMLgen.Div(Class = 'main', id = 'myId') : pour mettre une classe à un élément (attention, l'attribut 'class' ne marche pas car mot réservé python, alors que 'Class' ou 'CLASS' marchent, car les attributs ne sont pas sensibles à la casse).
• HTMLgen.HREF('/url/link.html', 'lien') : rajout d'un lien.
• HTMLgen.BR() : élément <br>
• HTMLgen.IMG('/img/image.jpg') : pour créer une image.

Exemple de génération d'un document contenant une table :

doc = HTMLgen.SimpleDocument()
myTable = HTMLgen.TableLite(border = 1, cellspacing = 0)
tr = HTMLgen.TR()
th = HTMLgen.TH('col1'); tr.append(th)
th = HTMLgen.TH('col2'); tr.append(th)
myTable.append(tr)
tr = HTMLgen.TR()
td = HTMLgen.TD('val1'); tr.append(td)
td = HTMLgen.TD('val2'); tr.append(td)
myTable.append(tr)
doc.append(myTable)
doc.write()
  

Pour écrire le document dans un fichier : doc.write('myFile').

Par défaut, il y a un escape html sur les chaînes de caractères. Pour éviter de l'avoir : td = HTMLgen.TD('<b>en gras</b>', html_escape = 'off').

On peut mettre des styles à un élément, par exemple : div = HTMLgen.Div(message, style = 'color: red; text-align: center; font-size: 200%;')

Attention : HTMLgen est très limité : si un attribut n'a pas été prévu, on ne peut pas le rajouter (exemple attribut title dans Href dans la version 2.2.2)