A quoi ça sert de « commenter » du code ?
Désactiver une partie d’un squelette en « commentant », permet parfois d’y voir plus clair pour un debugage de squelette.
Cela permet aussi d’envoyer le squelette sur le site alors que l’on pas encore terminé une partie (c’est cette partie qu’on « commente »).... ou bien simplement de placer des commentaires pour ceux qui les liront.
Les commentaires dans un script sont importants aussi pour vous : dans 6 mois, vous aurez peut-être oublié pourquoi vous aviez mis tel filtre, tout en vous rapellant que vous aviez eu du mal à obtenir le résultat voulu.
Enfin, toujours à titre de débugage, vous pouvez faire apparaître certaines valeurs, vérifier la présence de certaines variables, de leur valeur... ou tout simplement vérifier qu’une boucle rubrique donne les bonnes rubriques : dans le cas d’une boucle qui sert à encadrer une boucle article afin de faire un listing,si votre boucle rubrique ne sort pas le bon résultat, la boucle article n’ira pas non plus. (bien sur, vous n’oublierez pas de remettre les commentaires)
Voila, les mises en commentaires servent à plein de choses.
Comme dans Spip on peut habituellement utiliser des balises Spip, du PHP, du HTML et enfin du javascript, il faut savoir ce que l’on va mettre en commentaire.
Les interactions sont nombreuses, je rappelle que l’ordre d’exécution est :
- Balises Spip (boucles, et
#TEXTE...) - PHP
- dans le navigateur : HTML Javascript et feuilles de style.
Pour désactiver une partie d’un squelette :
- Si c’est une partie en HTML, un simple commentaire HTML suffira :
<!--
ici ce n'est plus interprété par le navigateur (mais ce l'est encore par Spip)
-->
- Pour le PHP :
<?php # commentaire ?>
- Ou bien encore le
<?php
// echo "cette ligne n'est plus interprétée par le php";
?>
- Et enfin le
<php /*
echo "ce bloc et tout qui suit n'est pas interpreté...";
echo "(les instructions Spip sont encore interprétées par Spip..., n'oubliez pas de les refermer correctement, mais elle ne s'afficheront pas.)";
echo "...jusqu'au";
*/ ?>
- Vous pouvez aussi essayer de détruire les boucles :
Sachez que les boucles Spip même mises en commentaire seront quand même interprétées par Spip, ce qui peut vous poser un problème lors de l’utilisation du filtre {doublons} ou {unique} , dans ce cas, il vous faudra casser la boucle (en écrivant volontairement mal le mot BOUCLE de cette façon :
<B-OUCLE_art(ARTICLES){id_article}>
#TEXTE
</B-OUCLE_art(ARTICLES){id_article}>bien sur, il faut aussi le faire pour la boucle fermante, ce qui n’est pas pratique.
Pour les <INCLURE(...)> c’est plus simple, puisqu’il suffit de le faire à un seul endroit :<IN-CLURE(...)>
Je rapelle encore que le dans un squelette, l’ordre d’interprétation est :
- Spip
- PHP
- HTML et JavaScript et... dans le navigateur
Si vous voulez utiliser une variable php dans un critère de boucle, voyez cette discution à ce sujet.
Vos commentaires
# Le 12 octobre 2004 à 10:29, par vitaalis
En réponse à : > Comment désactiver une partie d’un squelette ?
Comment me debarasser du bouton « modifier cet article » dans article-dist.html ? J’ai eu beau fouiller dans le code - cet element me reste insaisissable.
# Le 30 janvier 2005 à 17:20, par Coma
En réponse à : > Comment désactiver une partie d’un squelette ?
Moi aussi, j’ai cherché partout et je sais pas comment faire...
Quelqu’un peut-il nous aider ?
# Le 30 janvier 2005 à 19:11, par mathieu
En réponse à : > Comment désactiver une partie d’un squelette ?
Cet élément n’apparaît _que_ pour les administrateurs, et est inséré par
[(#FORMULAIRE_ADMIN)].Il n’y a donc pas lieu de l’enlever.
Pour voir votre site tel que le voient les visiteurs lambda, allez dans l’espace privé, déconnectez-vous, et revenez sur le site (en actualisant les page à cause du cache navigateur of course).
Cette question a déjà été soulevée dans la FAQ, me semble-t-il.
# Le 31 janvier 2005 à 17:14, par ?
En réponse à : > Comment désactiver une partie d’un squelette ?
^^ Merci beaucoup :)
# Le 21 septembre 2007 à 21:14, par Grégoire
En réponse à : > Comment désactiver une partie d’un squelette ?
Bonsoir
De toute façon, il n’est pas visible par l’internaute.
Il n’apparaît que pour ceux qui sont logués/identifié.
Il y a une balise #FORMULAIRE_ADMIN je crois bien, pour afficher ces boutons. Il suffit qu’elle ne soit pas présente, mais c’est se retirer un outil pratique pour les rédacteurs.
Répondre à ce message
# Le 10 novembre 2005 à 10:27, par Minh
En réponse à : Comment désactiver une partie d’un squelette ?
A partir de la version 1.8, la balise #REM peut être utilisée pour insérer des remarques dans les squelettes :
[(#REM) Petit commentaire pour expliquer l'astuce]Répondre à ce message
# Le 12 avril 2004 à 11:23, par jeanmichel
En réponse à : > Comment désactiver une partie d’un squelette ?
je narrive pas a supprimer mozilla et warning user etc qui reviennent systematiquement et qui me donnent une page blanche
# Le 9 août 2004 à 01:11, par Grégoire
En réponse à : > Comment désactiver une partie d’un squelette ?
Peut-on avoir plus de précisions ?
Dans mes_fonction.php3, tu peux personnaliser certaines variables... très utilie, je crois que la solution est à écrire dedans (la liste est dans /ecrire/inc_version.php3)
Amicalement
Grégoire
Répondre à ce message
# Le 28 avril 2004 à 15:16, par RilaX
En réponse à : > Comment désactiver une partie d’un squelette ?
Grace a la fonction « remplacer » qui esxiste dans la plupart des editeurs, il deviens plus simple de ’fausser’ les balises. Il suffit de mettre en surbrillance la partie du code dans laquelle se trouve les boucles a « casser », ensuite editer/remplacer et vous remplacer p>
Comme ca quand vous avez fini votre debbugage (plus la peine de selectionner la partie du code concerné) il suffit de faire edition/remplacer et vous remplacez
j’ai bon ?
# Le 28 avril 2004 à 15:22, par RilaX
En réponse à : > Comment désactiver une partie d’un squelette ?
Bon, super. La prochaine fois j’essaierai d’utiliser mon cerveau avant de cliquer sur « poster », ou au moins je relirais !
je disais donc qu’on pouvait remplacer
<Bpar
<Bcacaproutet une fois le debuggage terminé, on peut remplacer
<Bcacaproutpar<BRépondre à ce message