Page 1 sur 1

[wiki] Prompts devant les commandes

Publié : jeu. 26 juin 2014, 23:53
par Moviuro
Plop,

Incompréhension de ma part : FoolEcho a supprimé les # ici : https://wiki.archlinux.fr/index.php?tit ... oldid=5473

Et ça a l'air d'être pareil sur toutes les pages : résultat des courses, quelqu'un sur IRC nous demande pourquoi sur https://wiki.archlinux.fr/Wifi#Configur ... C3.A9rique il n'y a pas de # devant les commandes qui nécessitent les privilèges super-utilisateur (et on n'est pas capables de répondre).

Perso, je suis bien fan de l'idée qu'avait Mandriva à l'époque où j'utilisais : http://archive.openmandriva.org/wiki/fr ... ntit.C3.A9 (un fond de boîte rouge pour les commandes nécessitant les privilèges superutilisateur).

Voilà, il va falloir faire quelque chose pour le wiki de toutes façons, sinon on court à la cata...

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 00:05
par mélodie
Salut,

je n'aime pas trop le rouge, hors doses homéopathiques. Je suis pour les '$' et les '#' qui indiquent "user" ou "root".

FoolEcho, est-ce vrai ? Si oui pourquoi ôter les # devant les commandes administrateur ?

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 00:19
par Moviuro
mélodie a écrit :je n'aime pas trop le rouge, hors doses homéopathiques.
C'était une idée lancée comme ça, il faudrait que, si on utilise un thème de couleur, ça s'intègre correctement à la palette de bleus de Archlinux ;)

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 01:24
par benjarobin
C'est une règle du Wiki, je en sais pas qui l'a fixé par contre, je crois Tuxce, car # indique un commentaire... Personnellement je n'ai pas d'opinion sur le sujet.

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 10:15
par FoolEcho
Moviuro a écrit :Voilà, il va falloir faire quelque chose pour le wiki de toutes façons, sinon on court à la cata...
Un peu alarmiste, non ? :roll:
(le wiki est ainsi depuis des lustres... :sifflote2:)
mélodie a écrit :FoolEcho, est-ce vrai ? Si oui pourquoi ôter les # devant les commandes administrateur ?
C'est une règle un peu plus que tacite du wiki, disons. :mrgreen:
L'essentiel du wiki est à usage de l'administrateur d'un système, donc inutile de préciser que les commandes qui s'y trouvent doivent être lancés en root (et pour ceux qui ne savent pas, on peut espérer qu'ils se demandent pourquoi ça marche pô et potentiellement ça évite qu'ils fassent des bétises :P ); le fait qu'effectivement le # en shell indique aussi un commentaire et que, parfois, dans le wiki, on les fait aussi figurer, ce qui est plus clair à la lecture (exemple qui serait imbuvable avec les prompts en plus: http://wiki.archlinux.fr/Miroirs#Trier_les_miroirs ) (si après en rajoutant les prompts, il faut commencer à expliquer aux néophytes qu'il ne faut pas faire un copier-coller bête et méchant et ce qui différencie un utilisateur de root... :mrgreen: ) ; un aspect pratique parfois (directement copier-coller de plusieurs lignes, cf exemple précédent).

Le wiki admet plusieurs syntaxes et modèles:
-affichage d'une commande simple ou plusieurs, si root: on supprime le prompt sinon on peut rajouter le $.
-en cas d'exemple plus poussé, pour montrer le retour d'une commande notamment, utilisez Command.

:chinois:

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 12:44
par Moviuro
FoolEcho a écrit :(si après en rajoutant les prompts, il faut commencer à expliquer aux néophytes qu'il ne faut pas faire un copier-coller bête et méchant et ce qui différencie un utilisateur de root... :mrgreen: ) ; un aspect pratique parfois (directement copier-coller de plusieurs lignes, cf exemple précédent).
Là, je suis d'avis que c'est le wiki qui a des lacunes : il suffit de voir http://paste.ubuntu.com/7629219/ par exemple qui affiche des numéros de lignes et dont on peut copier-coller le tout sans problèmes. Suffit de faire la même chose sur le wiki avec des #, $ ou rien du tout.

Ensuite, copier coller sans réfléchir, c'est toujours une mauvaise idée... mais c'est un autre sujet.

Plus avant, https://wiki.archlinux.fr/Yaourt est super pas clair quant à l'install à la main de yaourt : il faut le faire en tant que user et non en tant que root (ce qui va à l'encontre de tout le reste du wiki puisqu'il est --je cite-- à usage de l'administrateur d'un système)
FoolEcho a écrit :le fait qu'effectivement le # en shell indique aussi un commentaire et que, parfois, dans le wiki, on les fait aussi figurer, ce qui est plus clair à la lecture (exemple qui serait imbuvable avec les prompts en plus: http://wiki.archlinux.fr/Miroirs#Trier_les_miroirs )
Là, je pense qu'on pourrait jouer sur les couleurs : mettre le prompt d'une couleur donnée et le texte (incluant le # des commentaires) d'une autre :
Exemple a écrit :# # On met à jour le système
# pacman -Syu
Et la sélection du texte sur plusieurs lignes doit retourner :

Code : Tout sélectionner

# On met à jour le système
pacman -Syu
(désolé pour l'utilisation de la citation, mais j'ai pas vu comment mettre la fonte en chasse fixe pour rendre l'exempe lisible)

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 13:25
par FoolEcho
Moviuro a écrit :Là, je suis d'avis que c'est le wiki qui a des lacunes : il suffit de voir http://paste.ubuntu.com/7629219/ par exemple qui affiche des numéros de lignes et dont on peut copier-coller le tout sans problèmes. Suffit de faire la même chose sur le wiki avec des #, $ ou rien du tout.
Comparer ce qui est comparable. Un nopaste et un wiki n'ont pas les mêmes visées du tout...
Moviuro a écrit :Plus avant, https://wiki.archlinux.fr/Yaourt est super pas clair quant à l'install à la main de yaourt : il faut le faire en tant que user et non en tant que root (ce qui va à l'encontre de tout le reste du wiki puisqu'il est --je cite-- à usage de l'administrateur d'un système)
C'est le boulot de yaourt d'avertir l'utilisateur qu'il peut avoir besoin des droits root et qu'il est dangereux de le lancer directement ainsi.
Et c'est le boulot de l'administrateur de se poser la question du pourquoi... (l'utilisation de yaourt suppose... plus ou moins :mrgreen: ... que l'utilisateur se renseigne un peu plus sur makepkg et pacman...)

Mais rien ne t'empêche de le lancer en tant que tel directement, root ou pas, donc... comme tout autre commande du shell accessible dans l'environnement d'un utilisateur donné...

Et les pages ne sont pas immuables donc rien n'empêche d'apporter des précisions... sachant que tu as peut-être sélectionné la seule page du wiki qui joue un peu les contre-exemples... :sifflote2:

Perso, je m'en fiche... Mais modifier pour faire apparaître explicitement les prompts partout implique de le faire sur toutes les pages... sachant qu'il n'y a de règle sur l'affichage du code d'une commande ou d'une ligne de fichiers par exemple, ça implique de reprendre *toutes* les pages existantes du wiki... tu trouves que ça en vaut la chandelle ? moi, pas... à la rigueur modifier celle de yaourt pour que ça soit plus clair, ok parce que c'est plus rapide dans ce sens-là... l'autre sens n'apporte rien du tout... :|

Alors si le seul souci venait de la page yaourt, y a qu'à la rendre plus claire, c'est tout (j'vois pas en quoi celle du wifi est pas claire... rfkill ne nécessitant pas d'être root pour la lancer par exemple... mais peut-être ne faut-il pas le préciser ?)... :|

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 13:56
par Moviuro
FoolEcho a écrit :tu as peut-être sélectionné la seule page du wiki qui joue un peu les contre-exemples... :sifflote2:
Oui, c'était un contre-exemple.
FoolEcho a écrit :Perso, je m'en fiche... Mais modifier pour faire apparaître explicitement les prompts partout implique de le faire sur toutes les pages... sachant qu'il n'y a de règle sur l'affichage du code d'une commande ou d'une ligne de fichiers par exemple, ça implique de reprendre *toutes* les pages existantes du wiki... tu trouves que ça en vaut la chandelle ? moi, pas... à la rigueur modifier celle de yaourt pour que ça soit plus clair, ok parce que c'est plus rapide dans ce sens-là... l'autre sens n'apporte rien du tout... :|
D'après Enjolras, depuis la migration vous vous êtes bien amusés à enlever tous les prompts ;)
FoolEcho a écrit :Alors si le seul souci venait de la page yaourt, y a qu'à la rendre plus claire, c'est tout (j'vois pas en quoi celle du wifi est pas claire... rfkill ne nécessitant pas d'être root pour la lancer par exemple... mais peut-être ne faut-il pas le préciser ?)... :|
Là je suis pas d'accord. Parce que dire "par défaut tout lancer en tant que root" ça peut tout casser. Ma position est certainement biaisée mais perso, je lance tout en tant que user jusqu'à ce qu'on me dise Permission denied auquel cas je sudo ou su
FoolEcho a écrit :
Moviuro a écrit :Là, je suis d'avis que c'est le wiki qui a des lacunes : il suffit de voir http://paste.ubuntu.com/7629219/ par exemple qui affiche des numéros de lignes et dont on peut copier-coller le tout sans problèmes. Suffit de faire la même chose sur le wiki avec des #, $ ou rien du tout.
Comparer ce qui est comparable. Un nopaste et un wiki n'ont pas les mêmes visées du tout...
FoolEcho a écrit :un aspect pratique parfois (directement copier-coller de plusieurs lignes, cf exemple précédent).
Bah il faudrait savoir :wink: Le paste est cool pour ça : copier coller sans réfléchir. Et comme au final, c'est que de l'HTML (que ce soit le wiki ou le paste Ubuntu), bah oui, c'est comparable.

Ça doit bien être faisable un modèle wiki :

Code : Tout sélectionner

{{customcommand|
p="$"|l="# On vérifie que filesystem est correctement installé"|
p="$"|l="ls -l /"|
p=""|l="lrwxrwxrwx   1 root root     7 Jun 12 01:11 bin -> usr/bin/
drwxr-xr-x   4 root root 16384 Jan  1  1970 boot/"}}
Qui retourne :
$ # On vérifie que filesystem est correctement installé
$ ls -l /

Code : Tout sélectionner

lrwxrwxrwx   1 root root     7 Jun 12 01:11 bin -> usr/bin/
drwxr-xr-x   4 root root 16384 Jan  1  1970 boot/
Et si on sélectionne le texte, ne retourner que :

Code : Tout sélectionner

# On vérifie que filesystem est correctement installé
ls -l /

Re: [wiki] Prompts devant les commandes

Publié : ven. 27 juin 2014, 14:28
par FoolEcho
Moviuro a écrit :D'après Enjolras, depuis la migration vous vous êtes bien amusés à enlever tous les prompts ;)
Oui, mais c'était l'occasion de le faire vu que tout n'a pas été remis. Moins de page, moins de boulot.
Et si tuxce passe dans le coin, il te dira peut-être plus que ce que j'ai dit.

Pour moi, avec ou sans, c'est une question de cohérence mais vu que la plupart des commandes sont du type pacman truc ou systemctl machin, préciser le prompt root ne présente aucun intérêt. De là, pas de prompt == lancement en root, c'est spécifié ainsi sur le fr sinon on précise. Point... KISS. Et à part certaines pages peut-être pas claires, je ne vois pas l'intérêt de le préciser partout.
Moviuro a écrit :
FoolEcho a écrit : Alors si le seul souci venait de la page yaourt, y a qu'à la rendre plus claire, c'est tout (j'vois pas en quoi celle du wifi est pas claire... rfkill ne nécessitant pas d'être root pour la lancer par exemple... mais peut-être ne faut-il pas le préciser ?)... :|

Là je suis pas d'accord. Parce que dire "par défaut tout lancer en tant que root" ça peut tout casser. Ma position est certainement biaisée mais perso, je lance tout en tant que user jusqu'à ce qu'on me dise Permission denied auquel cas je sudo ou su
Là, je ne vois pas ce que tu veux dire puisque je n'ai absolument pas dit ça... :|
Moviuro a écrit :Ça doit bien être faisable un modèle wiki :
Ben oui... Il s'appelle Command quand tu veux présenter commande/sortie et j'en ai déjà donné le lien... Après, si tu veux le modifier pour y mettre de la couleur, je ne vois pas ce que ça change mais ce n'est pas moi qui t'en empêche... :P

Quant à sélectionner sans les prompts ou les lignes, je ne sais pas ce dont est capable le wiki en l'état, mais à mon avis, c'est usine à gaz pour trois fois rien vu que seule la commande est intéressante à copier et que l'essentiel se résume à pacman ou systemctl etc.... (et à part par léger gain de temps, je ne vois rien dans le wiki qui justifie d'avoir une fonctionnalité pareille)... :|