Outils pour utilisateurs

Outils du site


microalg:mise_en_forme

Différences

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

Lien vers cette vue comparative

microalg:mise_en_forme [2017/03/19 11:36] (Version actuelle)
profgra créée
Ligne 1: Ligne 1:
 +# Mise en forme officielle
  
 +## Introduction
 +
 +En programmation,​ on lit davantage que l’on écrit.
 +
 +La mise en forme d’un programme est importante car elle donne
 +beaucoup d’informations sur sa structure. Un programme pourrait
 +être écrit sur une seule ligne et fonctionner correctement,​ mais
 +serait illisible. En plaçant judicieusement des retours à la ligne et
 +des espaces, on facilite la compréhension du programme.
 +Et bien souvent, c’est le programmeur lui-même qui est le principal lecteur !
 +
 +La mise en forme proposée ici est le fruit de l’écriture et de la lecture de nombreux programmes.
 +Des suggestions sont toutefois encore possibles, bien sûr.
 +
 +Nous insistons ici sur les commandes qui reçoivent des « blocs de code »,
 +c’est à dire des lignes de code qui sont groupées (ne pas confondre
 +ces blocs avec les pièces de puzzle).
 +
 +Notez que vous pouvez toujours utiliser l’export MicroAlg pour obtenir la mise
 +en forme officielle.
 +
 +## Repeter
 +
 +(MicroAlg "​repeter-src"​)
 +(Repeter 4 Fois
 +    (Afficher "​Bonjour !")
 +    (Afficher "​Comment vas-tu ?")
 +)
 +(/MicroAlg)
 +
 +Ici, chaque ligne du code à répéter est indentée de quatre espaces.
 +
 +Le mot-clé intermédiaire `Fois` est sur la même ligne que `Repeter`.
 +En effet, bien souvent, le nombre qui vient avant ne prend pas de place,
 +et ces trois éléments forment un tout.
 +
 +On remarque que la parenthèse ouvrante de `Repeter` est rouge et est alignée
 +avec la parenthèse de même couleur qui lui correspond.
 +Les parenthèses ouvrantes des commandes à répéter sont oranges et
 +alignées verticalement aussi.
 +
 +## Si
 +
 +(MicroAlg "​si-src"​)
 +(Si (= personne "​ami"​)
 + Alors
 +    (Afficher "​Bonjour !")
 +    (Afficher "​Comment vas-tu ?")
 +)
 +(/MicroAlg)
 +
 +On retrouve les mêmes idées que pour `Repeter`, sauf pour le mot clé
 +intermédiaire `Alors` : il est seul sur sa ligne et est indenté d’une
 +espace.
 +
 +Mettre `Alors` seul sur sa ligne permet de mieux visualiser et de mieux manipuler (copier-coller) les lignes de ce bloc.
 +
 +La parenthèse ouvrante de la condition du `Si` est alignée avec
 +les parenthèses ouvrantes des commandes du `Alors`.
 +
 +## Tant_que
 +
 +(MicroAlg "​tq-src"​)
 +(Tant_que (=/ n 0)
 + Faire
 +    (Afficher n)
 +    (Affecter_a n (- n 1))
 +)
 +(/MicroAlg)
 +
 +On retrouve les mêmes idées que pour `Si`, sauf que la parenthèse de la
 +condition d’une part et les parenthèses du bloc `Faire` d’autre part ne
 +sont pas alignées.
 +
 +## Si Alors Sinon
 +
 +(MicroAlg "​si-alors-sinon-src"​)
 +(Si (= personne "​ami"​)
 + Alors
 +    (Afficher "​Bonjour !")
 +    (Afficher "​Comment vas-tu ?")
 + Sinon
 +    (Afficher "​Bonjour !")
 +    (Afficher "Quel est ton nom ?")
 +)
 +(/MicroAlg)
 +
 +On retrouve les mêmes idées que pour le `Si` sans `Sinon`. De même,
 +le mot clé intermédiaire `Sinon` est seul sur sa ligne et est indenté
 +d’une espace.
 +
 +La parenthèse ouvrante de la condition du `Si` est alignée avec
 +les parenthèses ouvrantes des commandes du `Alors` et du `Sinon`.
 +
 +## Faire
 +
 +(MicroAlg "​faire-src"​)
 +(Faire
 +    (Afficher n)
 +    (Affecter_a n (- n 1))
 + ​Tant_que (=/ n 0)
 +)
 +(/MicroAlg)
 +
 +On retrouve les mêmes idées que pour le `Tant_que`. La parenthèse
 +fermante du `Faire` est seule sur sa ligne pour deux raisons: ne pas
 +interférer avec les parenthèses de la condition, et respecter
 +l’alignement des parenthèses fermantes de toutes ces commandes.
 +
 +## Cumulation
 +
 +L’indentation doit se cumuler bien sûr.
 +
 +(MicroAlg "​repeter-repeter-src"​)
 +(Repeter 4 Fois
 +    (Afficher "​J’adore !")
 +    (Repeter 2 Fois
 +        (Afficher "​Regarder danser les gens."​)
 +    )
 +    (Afficher "Et toi aimes-tu ?")
 +)
 +(/MicroAlg)
microalg/mise_en_forme.txt · Dernière modification: 2017/03/19 11:36 par profgra