Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
atelier:coloration-syntaxique [22/10/2013 12:01] bendia créée |
atelier:coloration-syntaxique [10/05/2015 13:29] captnfab [Conventions] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ====== Utiliser la coloration syntaxique dans le forum ====== | ====== Utiliser la coloration syntaxique dans le forum ====== | ||
| - | | ||
| ===== Pourquoi ===== | ===== Pourquoi ===== | ||
| + | Sans coloration syntaxique, il est pénible de s'y retrouver en lisant un long message avec tout mélangé du texte, des commandes et des sorties de commandes. | ||
| + | Pour aider les entraideurs, merci de respecter les conventions suivantes : | ||
| - | **Premier exemple d'intervention sur le forum : ** | + | ===== Conventions ===== |
| - | Voici une question très longue et très complexe au milieu de laquelle j'insère une commande\\ | + | ==== Pour une commande utilisateur et sa sortie ==== |
| - | ls -l | egrep '[^.tex]$' \\ | + | |
| - | et vous pouvez constater que le retour n'est pas piqué des hannetons\\ | + | |
| - | total 16 \\ | + | |
| - | -rw-r--r-- 1 user user 1243 févr. 6 2013 APropos \\ | + | |
| - | -rw-r--r-- 1 user user 731 févr. 5 2013 APropos~ \\ | + | |
| - | drwxr-xr-x 4 user user 4096 sept. 25 18:37 src \\ | + | |
| - | **Deuxième exemple d'intervention sur le forum : ** | + | Pour indiquer la commande qui doit être passée en tant que simple utilisateur, utilisez les balises : |
| + | <code>[code=user]ma_commande[/code] | ||
| + | [code]sa sortie[/code]</code> | ||
| - | Voici une question très longue et très complexe au milieu de laquelle j'insère une commande | + | Soit, par exemple : |
| - | <code user>ls -l | egrep '[^.tex]$'</code> | + | <code>Voici le résultat de la commande : |
| - | et vous pouvez constater que le retour n'est pas piqué des hannetons | + | [code=user]ls -l /lib/systemd/[/code] |
| - | <code>total 16 | + | [code]total 336 |
| - | -rw-r--r-- 1 user user 1243 févr. 6 2013 APropos | + | drwxr-xr-x 6 root root 36864 mai 10 10:26 system |
| - | -rw-r--r-- 1 user user 731 févr. 5 2013 APropos~ | + | -rwxr-xr-x 1 root root 300612 avril 17 16:37 systemd-udevd |
| - | drwxr-xr-x 4 user user 4096 sept. 25 18:37 src</code> | + | [/code] |
| + | </code> | ||
| + | Ce qui apparaîtra sur le forum comme : | ||
| + | > Voici le résultat de la commande : | ||
| + | > <code user>ls -l /lib/systemd/</code><code>total 336 | ||
| + | drwxr-xr-x 6 root root 36864 mai 10 10:26 system | ||
| + | -rwxr-xr-x 1 root root 300612 avril 17 16:37 systemd-udevd | ||
| + | </code> | ||
| - | Je vous laisse juger sur pièce de la lisibilité de ces 2 interventions ;-) | + | ==== Pour une commande root et sa sortie ==== |
| + | Pour indiquer la commande qui doit être passée en tant que [[doc:systeme:superutilisateur|super-utilisateur]], même chose, en remplaçant « user » par « root » : | ||
| + | <code>[code=root]ma_commande[/code] | ||
| + | [code]sa sortie[/code]</code> | ||
| - | ===== Comment ===== | + | Soit, par exemple: |
| + | <code>Voici le résultat de la commande : | ||
| + | [code=user]ls -l /var/log/apache2/[/code] | ||
| + | [code]total 336 | ||
| + | -rwxr-xr-x 1 root root 36864 mai 10 10:26 access.log | ||
| + | -rwxr-xr-x 1 root root 300612 mai 10 16:37 error.log | ||
| + | [/code] | ||
| + | </code> | ||
| - | Pour indiquer une commande qui doit être passée en tant que simple utilisateur, utilisez les balises | + | Ce qui apparaîtra sur le forum comme : |
| + | > Voici le résultat de la commande : | ||
| + | > <code root>ls -l /var/log/apache2/</code><code>total 336 | ||
| + | -rwxr-xr-x 1 root root 36864 mai 10 10:26 access.log | ||
| + | -rwxr-xr-x 1 root root 300612 mai 10 16:37 error.log | ||
| + | </code> | ||
| - | <code>[code=user]ma_commande[/code]</code> | + | ==== Les fichiers et langages de programmation ==== |
| - | Pour indiquer une commande qui doit être passée en tant que [[doc:systeme:superutilisateur|super-utilisateur]], utilisez les balises | + | Il est également possible d'activer la coloration syntaxique pour différents type de fichiers. |
| + | Exemple pour indiquer une extrait de //[[doc:systeme:apt:sources.list|sources.list]]//, utilisez le code « apt_sources » : | ||
| - | <code>[code=root]ma_commande[/code]</code> | + | Soit, par exemple: |
| + | <code>[code=apt_sources]deb http://ftp.debian.org/debian jessie main contrib non-free[/code]</code> | ||
| - | Pour indiquer qu'il s'agit d'une entrée de //[[doc:systeme:apt:sources.list|sources.list]]//, utilisez les balises | + | Ce qui donne sur le forum: |
| + | <code apt_sources>deb http://ftp.debian.org/debian jessie main contrib non-free</code> | ||
| - | <code>[code=apt_sources]deb entree_sources.list[/code]</code> | + | Même chose pour « apt_preferences » |
| - | Pour indiquer le retour d'une commande, utilisez simplement les balises | + | Il en va de même avec les langages de programmation (perl, bash, C, python, etc.): |
| - | <code>[code]Le retour de ma commande[/code]</code> | + | Il suffit (en général) de faire : |
| - | + | ||
| - | + | ||
| - | P.S. : Cela supporte même des tas d'autres langages de programmation. Il suffit en général de faire | + | |
| <code>[code=langage]code[/code]</code> | <code>[code=langage]code[/code]</code> | ||
| - | + | Pour obtenir la distinction de leurs colorations particulières. | |
| - | Merci à **captnfab** qui a codé ça 8-) | + | |
| - | ===== Utilisation ===== | + | <note tip>**Il est tout à fait possible** de mettre en page son message même après l'avoir publié. Il suffit de cliquer sur le bouton //Modifier// en bas à droite de votre message, puis d'insérer les balises avant et après les commandes et les retours. |
| + | </note> | ||
| - | Il est tout à fait possible de mettre en page son message même après l'avoir publié. Il suffit de cliquer sur le bouton //Modifier// en bas à droite de votre message, puis d'insérer les balises avant et après les commandes et les retours. | + | ===== La prime ===== |
| - | ===== En prime ===== | + | DF ne reculant devant aucun sacrifice, il est dit et entendu ici que tout membre DF qui indiquera sur le forum par copie/colle le lien vers cette page ci-dessous : |
| - | + | ||
| - | Tout membre DF qui indiquera le lien vers cette page | + | |
| - | * ''%%[i][url=http://wiki.debian-facile.org/atelier:coloration-syntaxique]Le code, ça pique moins les yeux en couleur[/url][/i]%%'' | + | * %%[i][url=http://wiki.debian-facile.org/atelier:coloration-syntaxique]Voir le tuto : Le code, ça pique moins les yeux en couleur[/url][/i]%% |
| - | sera récompensé par **1 point chocolat DF** en plus de l'économie en lunettes et autre soins ophtalmologiques que sa contribution lui aura procurée :-D | + | aura pour récompense **1 point chocolat DF** de plus dans sa besace ! (//en plus de l'économie en lunettes et autre soins ophtalmologiques que sa contribution lui aura procurée//) :-D |
| + | |||
| + | //Petit rappel annexe : il faut **1000** points pour prétendre au carré de chocolat, et c'est Jojo le gourmand qui tient les comptes// LOL | ||
| <note warning>Afin d'éviter de privilégier la forme sur le fond, le point chocolat ne sera attribué **qu'une seule fois** par discussion</note> | <note warning>Afin d'éviter de privilégier la forme sur le fond, le point chocolat ne sera attribué **qu'une seule fois** par discussion</note> | ||
| + | |||
