Page 1 of 1

Aide à la lecture d'un code pour débutant.

Unread postPosted: 12 Sep 2010, 11:58
by Levak
Bonjour à tous, je me permets de créer ce petit tutoriel, ou du moins, de faire une demande générale concernant une coloration syntaxique de tous les codes Nspire que vous voudriez ajouter à vos messages.
En fait, avec le nouveau programme (réforme des lycées) je vois qu'en ne serait-ce que 2 jours, deux demandes ont été faite concernant une aide à la programmation.
Aussi, il est, il me semble, important de vous demander à tous de suivre un petit modèle que j'ai utilisé et que je trouve assez confortable, comme si l'on était dans un éditeur pour programmation.

En gros, voilà le topos :

- toutes les fonctions d'origine, les fonctions pré-conçues par l'OS sont à mettre en gras
- toutes les variables ou fonctions crées par l'utilisateur, sont à colorer en rouge foncé et à mettre en gras
- toutes les chaines de caractères sont à colorer en indigo (avec les guillemets)
- toutes les listes ou matrices sont à colorer en orange
- toutes les valeurs numériques sont à colorer en bleu
- tous les commentaires en © xxx sont à colorier en vert

Ainsi, pour faciliter la lecture du code, chaque indentation prendra 2 espaces minimum. Comme le forum parse les discussion, il sera impératif d'encadrer ce dernier avec la balise html pre

Exemple :


Define algo(nombre)=
© Début du programme
Prgm
© Si le nombre est supérieur à 1000, alors :
If nombre 1000 then
Disp "VRAI, le nombre est supérieur à 1000"

© Sinon :
Else
Disp "FAUX, le nombre est inférieur ou égal à 1000"

© Fin de la condition
EndIf

© Fin du programme
EndPrgm


Code: Select all
pre
[b]Define[/b] [b][color=darkred]algo[/color][/b]([b][color=darkred]nombre[/color][/b])=
[color=green]  © Début du programme[/color]
  [b]Prgm[/b]
    [color=green]© Si le nombre est supérieur à 1000, alors :[/color]
    [b]If[/b] [b][color=darkred]nombre[/color][/b]  [color=blue]1000[/color] [b]then[/b]
      [b]Disp[/b][color=indigo] "VRAI, le nombre est supérieur à 1000"[/color]

    [color=green]© Sinon :[/color]
    [b]Else[/b]
      [b]Disp[/b] [color=indigo]"FAUX, le nombre est inférieur ou égal à 1000"[/color]

    [color=green]© Fin de la condition[/color]
    [b]EndIf[/b]

  [color=green]© Fin du programme[/color]
  [b]EndPrgm[/b]
/pre


Comme vous pouvez le voir, c'est impossible de "debugguer" une fois le code coloré, il faudra donc colorer le code qu'une fois ce dernier terminé d'être construit et indenté.


@+

Levak :%):

#######
#EDITED #
#######

Re: [TUTO] Aide à la lecture d'un code pour débutant.

Unread postPosted: 12 Sep 2010, 12:46
by Excale
Bonne idée.
J'aurais bien ajouté une petite chose: pourquoi ne pas mettre les remarques (©xxx) en gris?


et puis:
Code: Select all
[color=vert]Prgm[/color]

[color=green] plutôt, non? :;):

Re: [TUTO] Aide à la lecture d'un code pour débutant.

Unread postPosted: 12 Sep 2010, 13:36
by Levak
Merci de ta remarque, j'ai finalement mis les commentaires en vert et les instructions pré-conçues en Gras, c'est beaucoup plus lisible comme ça.

Je m'en vais corriger les 3 endroits où j'ai pondu un code syntaxiquement coloré =)