> On va a priori intégrer cette proposition (en fr uniquement pour
> l'instant) dans l'alpha 4.0… histoire que les gens puissent tester et
> faire des retours.
(désolé c'est un peu en vrac)
Un point sur ça : la version 4.0.0-alpha a donc cette première version d'une aide en ligne intégrée à SPIP, dont le contenu est puisé dans des fichiers inclus du plugin Aide. Le contenu des fichiers peut donc suivre la version de SPIP associée au plugin. Un pipeline "aide_index" permet de compléter la liste des pages d'aides (et donc des plugins peuvent ajouter du contenu dedans)
Très bonne idée.
Pour les images, il est vrai qu’en terme de maintenance (des que l’interface change) ou de traduction (si des textes apparaissent), avoir des graphismes dans l’aide peut présenter des difficultés et qu’il ne faut pas en abuser.
Un type de graphisme peut néanmoins retenir notre attention : il est très utile de pouvoir présenter les icônes des objets éditoriaux.
Compte tenu de cette utilité, serait-il possible d’imaginer un appel simplifié pour elles ? un style peut-être ?
Moi j’aime bien ce principe car c’est hyper simple à mettre en œuvre.
J’en ai profité pour l’utiliser dans Todo et je le ferais aussi dans FAQ.
Plugonet a aussi une aide sur les paquet.xml qu’il serait bien de traduire en aide nouvelle. D’ailleurs je me disais qu’on pourrait alors l’intégrer au plugin Dev qui est plus utilisé que Plugonet.
Je viens d’essayer ! Visiblement j’étais en mode noob car j’ai mis du temps à piger : quand on clique sur « Aide », il apparaît une popin avec
1 col principale à droite qui ne contient que qq lignes d’introduction
1 col à gauche. Elle présente un lien qui porte le titre de la section de droite « Raccourcis typographiques » mais quand on clique sur ce lien il n’apparaît rien de nouveau.
Il m’a fallu un peu de temps pour comprendre que c’est le titre de la colonne de droite qu’il fallait cliquer pour avoir du nouveau.
Ensuite il s’est passé un truc sur mon site que je n’ai pas reproduit sur contrib.spip/ecrire : c’est que le clic a quitté la popin et m’a amené sur une nouvelle page… qui reprenait l’introduction mais avec d’autres infos en plus. J’ai vérifié après mais n’ai pas trouvé d’erreur javascript donc mystère sur mon site car sur contrib on reste bien dans la popin.
Il reste que je me demande pourquoi il y a cette première étape. Du moins dans la configuration de base où toute l’aide tient dans une seule page et où il n’y a qu’un lien possible, la première étape est inutile.
Ensuite, le lien à droite (sil faut garder cette étape), ressemble à un titre et il ne m’était pas venu à l’idée de le cliquer. Peut être ça se serait mieux passé s’il y avait eu plusieurs liens à droite… En tout cas c’est le lien à gauche (qui ne fait rien) que j’ai cliqué spontanément.
À part ça l’exemple de code apparaît en italique. Peut être car la balise code est inclue dans une balise quote. Je pense qu’il faudrait forcer le non italique dans le code.
Autre chose (constaté sur contrib) : la popin s’affiche actuellement à la taille nécessaire pour afficher le premier écran qui ne contient que l’introduction. Elle est donc large mais pas haute du tout. Quand on arrive sur l’aide entière, elle garde sa taille pas haute, mais seule la colonne de droite a une scrollbar. Du coup, on n’accède pas aux dernières options de la colonne de gauche. On peut alors obtenir le recalcul de la taille de la popin en changeant le zoom ou la taille de la fenêtre.
Et puis : sur contrib, /ecrire/AIDE/fr/articlenumero.gif est requêté mais n’existe pas. (sur mon site cette requête redirige par une 301 vers le html de l’accueil public : c’est peut être ça qui provoque l’affichage non ajax ?)
L’affichage « ajax » je l’ai corrigé après le tag -alpha je crois. Donc tout dépend de comment tu es à jour.
Pour le lien de « aide » qui ouvre la modale, qui ensuite est pas très clair : oui, je n’ai pas trouvé mieux pour l’instant (il faut conserver le fait que le menu gauche envoie vers une ancre du contenu central).
L’actualisation de la modale qui ne recalcule pas sa hauteur, oui j’ai vu cela, et je présume que c’est un bug ou un manque dans la boite modale utilisée : il faudra creuser.
Je trouve étrange d’y mentionner l’utilisation du HTML dès la première phrase, alors que c’est un sage qu’on a tendance à mettre en retrait.
Juste une remarque, chez moi (et certainement sur pas mal de sites, et encore plus sur un site vide mais là c’est chaud à prendre en charge) le lien d’exemple vers la rubrique 12 (qui n’existe pas encore sur ce site) génère un <a href="http://localhost/trunk/ecrire/?exec=rubrique&id_rubrique=10"><mark class="danger-js" title="Texte échappé">⚠️</mark> <span class=debug-traduction-erreur>rubrique</span> 10</a> qui peut surprendre. Peut-être qu’on pourrait utiliser le chiffre 1 pour les deux liens internes afin de limiter la casse ?
Sinon, mêmes remarques que @JLuc sur le fait que le lien à gauche depuis la première page d’aide ne soit pas fonctionnel, ainsi que le pb de hauteur de la modale quand on passe sur un page dont le contenu est plus long.
Alors là tu parles de _intro , pas du résumé. Et ce texte est juste copié de ce qu’il y avait avant…
Je ne sais pas comment faire mieux pour conserver la cohérence de l’ensemble. Enfin si je pourrais mettre directement ici le lien vers la page à recharger en ajax, mais du coup le menu ne se comporte pas pareil en fonction de l’endroit où on serait.
Faut peut être voir si @cerdic a une idée là dessus…
