Blog Emmanuel Orchanian

astuce bdd bureautique codage culture débat design énigme français hacking html mathématiques méthodologie santé typographie 

 

 [179 vues] 2022-07-26 Emmanuel Orchanian

NOTE : cet article a été affiché dans sa langue originale.

Qu'est ce qu'un commentaire dans un code ?

Les commentaires sont des textes dans les codes qui... ne servent à rien, c'est de la déco dans le code.

En vérité😋, ils servent essentiellement à trois choses :

  1. Mettre des notes personnelles pour mieux comprendre un code
  2. "Castrer"un code en faisant de telle sorte qu'il ne soit plus interprété


    

    

En vérité, ils servent essentiellement à trois choses :

  1. Mettre des notes personnelles pour mieux comprendre un code
  2. "Castrer"un code en faisant de telle sorte qu'il ne soit plus interprété

Vous pouvez appuyer sur CTRL+U pour voir un code source, et lire alors tous les commentaires.

Tous les langages on leurs commentaires

Langage Mono-ligne Multi-ligne
HTML (n'existe pas) <!--    -->
CSS (n'existe pas) /*   */
SCSS // /*   */
JavaScript // /*   */
PHP // ou # /*   */
SQL -- /*   */
.ini ; (n'existe pas)

Pourquoi ces fichus commentaires en HTML ?

Le HTML est trop vieux maintenant on pourrait dire, si on passe les commentaires HTML en /* */ des millions de pages web créeraient des bugs (surtout ceux qui parlent de code 😋)

N'empêche c'est frustrant d'avoir eu les commentaires les plus pourris pour le langage qui gouverne tous les autres, les trouve, les amènes tous et les lie. 💍

Jet Brain Mono

Le Jet Brain est une police d'écriture faite pour le codage, on aime ou on n'aime pas.

Par exemple le >= (plus grand ou égal) se transforme en >=

Il est curieux de voir l'interprétation des typographistes de Jet Brain Mono par rapport aux commentaires HTML :

    <!--    <!--
-->     -->

Et le CSS, on en parle ?

Ce qui me dérange aussi, c'est que le CSS n'a pas de commentaires mono-ligne//
L'alternative est de passer par le langage SCSS qui lui l'autorise.

C'est d'autant plus dérangeant que c'est un langages pour les débutants et que les commentaires mono-lignes sont très utiles pour déboguer, donc ça fait une double difficulté aux apprenants du CSS.

Selon-moi ils n'ont pas voulu mettre de commentaires mono-ligne pour ne pas castrer le code lors de la minification (quand tout le code passe sur une seule ligne).
L'alternative serait de trouver des package dans les éditeurs de code qui mettent des commentaire multi-lige sur chaque ligne au lieu de le faire par bloc,
par exemple :


    .img-art{
        /* background-color: beige;
        background-position: center;
        background-repeat: no-repeat;
        background-size: cover; */
    }

    DEVIENDRAIT

    .img-art{
        /* background-color: beige; */
        /* background-position: center; */
        /* background-repeat: no-repeat; */
        /* background-size: cover; */
    }

Hacking

Ce n'est pas le sujet du jour mais les commentaires peuvent aussi servir à hacker, un des meilleurs exemples qui me viens à l'esprit ce sont les injections SQL, je n'expliquerai pas ce que c'est ici en détail la page Wikipédia le fait mieux que moi ! 😊.
Dans les grands lignes, ça consistes à écrire un commentaire dans un champs de saisie.
de telle sorte que quand le texte sera envoyé pour être validé par l'ordinateur, celui-ci commence un commentaire, et que ça arrête l'interprétation du reste du code.

En gros, le hacking consiste à écrire du code informatique là où on attend du simple texte...

Lien pour les curieux

Documentation MDN

Merci d'avoir lu !
Si en général vous avez une question, une curiosité, n'hésitez pas me contacter.