Projet:Scribunto/Guide/Structure Lua 2

Introduction

Le code sert à structurer les tests et actions à faire (en fonction des paramètres généralement), dans le but de générer du code wiki, que ce soit du texte simple ou de la structuration d'information (catégories, box, liens…).

Regrouper le code dans des fonctions

Lorsque le code génère du simple texte ce n'est pas très important, mais lorsqu'on génère du code wiki structurant il est important de regrouper ce code dans des fonctions (voire, s'il y en a assez, dans un module distinct). L'intérêt est double :

Sur ce dernier point il est d'ailleurs possible/probable que si les modules Lua se généralisent les briques de base servant à générer des choses finissent par devenir des modules. Cette structuration facilite(ra) alors l'extraction du code ou sa gestion par d'autres personnes.
Un exemple dans les infobox pourrait être la création de modules fournissant les fonctions qui correspondent aux briques de base des infobox (infobox début, infobox image, infobox titre, …). Chacun pourra inclure le module gérant ces briques de base et les utiliser sans (quasiment) modifier son code.

Aller plus loin : séparation code/données/sortie

Dans un module complexe on va trouver plusieurs niveaux :

Il paraît important de séparer ces différents éléments dans des fonctions différentes, mais aussi dans des modules distincts. L'intérêt est multiple, au delà de séparer le code en morceaux plus « digestes ».
Pour les données brutes :

Pour les éléments structurant la sortie :

Pour la structuration du code :