Re: SPIP 4 — proposition d'enlever que lques plugins-dist par défaut

Matthieu Marcillaud <[email protected]> Fri, 30 Apr 2021 20:18:40 +0200
Newsgroups gmane.comp.web.spip.devel
Message-ID <[email protected]>
Le 30/04/2021 à 19:04, Bruno Bergot a écrit :
[...]

> J'arrive un peu tard, mais je suis pour le retrait de toute la liste 
> proposée.

J'ai enlevé donc les plugins qui n'étaient pas discutés.

Il reste les cas donc de :

- squelettes par rubriques
- aide
- compagnon

Je vais tacher de faire un résumé de différentes discussions rapidement 
à leur sujet.


Squelettes par rubriques
------------------------

Il est pratique, notamment simple pour débuter.

Contrairement à Composition, il fait une recherche sur toutes les 
inclusions pour vérifier s'il existe un =12.html ou -12.html ou .en.html 
et en remontant aussi la hiérarchie de rubriques le cas échéant. Le fait 
que ça s'applique sur toutes les inclusions est gourmand. Compositions 
ne le fait que sur certains blocs (notamment ceux déclarés à z-core).

Effectivement les 2 plugins n'ont pas exactement les mêmes 
caractéristiques (Compositions est visible dans l'espace privé par exemple)

Je pense qu'on peut proposer "squelettes par rubriques" uniquement en 
plugin et l'enlever des plugins-dist. La fonctionnalité ne disparait 
pas, et peut être réactivée donc facilement au besoin.


Compagnon
---------

Il est mignon, mais il gène les utilisateurs aguerris. Certaines 
personnes ne voient pas que les messages peuvent se fermer.

J'ai amélioré l'UI des boites de compagnon pour mieux voir que ça se 
ferme. Ce point est réglé.

On peut peut être ajouter un bouton supplémentaire sur le message de 
bienvenue d'un auteur sur l'accueil (et celui-ci seulement) qui dit en 
gros (formulation sympa à trouver) "Je connais SPIP ! (ne plus 
m'afficher le compagnon nulle part)"


Aide
----

Il semble qu'il faut conserver le plugin au moins pour pouvoir gérer 
l'aide des raccourcis typographique ; potentiellement uniquement 
ceux-là. Mais ça veut dire qu'il faut… revoir le plugin pour que ça soit 
à jour. (je dirais : gasp ! faut un peu de temps quoi !)

Une proposition serait d'intégrer cette documentation d'aide directement 
dans le plugin. Ça ne facilite pas les traductions : car ce serait des 
fichiers (en chaîne de langue c'est trop difficile à gérer vu la 
longueur des textes).

Par exemple dans un répertoire : aide/fr_FR/raccourcis_liens.spip (ou 
.md j'y reviens après)

Il y aurait une déclaration explicite de "groupe" d'aide, et d'entrées, 
qui passerait par un pipeline. Par exemple (très rapide, juste pour l'idée)

$liste = [
	'raccourcis' => [
		'titre' => _T('aide:groupe_raccourcis_typo'),
		'entrees' => [
			'liens' => [
				'titre' =>_T('aide:groupe_raccourcis_typo_liens'),
'fichier' => 'raccourcis_liens.spip'
		]
	]
];

L'exemple à l'inconvénient de devoir déclarer les titres et l'ordre (des 
groupes, des entrées), mais c'est probablement plus simple et clair que 
de l'extraire des fichiers automatiquement.

Les aides éventuelles, appelleraient par exemple #AIDER{raccourcis} (le 
nom du groupe), qui ouvrirait la modale (comme actuellement) avec en 
colonne le titre de chaque entrée (mais uniquement de ce groupe 
'raccourcis'), en en contenu le texte de chaque entrée (pris dans les 
fichiers .spip).

En tout cas c'est une piste possible.

Le lien "aide" du bandeau, pourrait ouvrir un menu avec tous les groupes 
déclarés (si tel est le cas), ou disparaitre...

C'est des réflexions live… désolé.

> J'y pensais hier, mais Arno m'a devancé, la seule aide utile est il me 
> semble cette des raccourcis typo du porte-plume. Et je me dis qu'on 
> pourrait facilement la garder à jour et la traduire en la déportant dans 
> un fichier MD inclus dans le plugin, ce qui ne bloque en rien l'envie de 
> compléter ou traduire celle-ci, et en plus aurait l'avantage de 
> versionner la doc en synchro avec la branche en cours.

Oui, j'aimerais bien en .md… mais on n'a pas librairie dans le core pour 
traduire le .md ensuite en html… donc… soit on a ajoute une… soit on le 
fait pas comme ça ! Et l'avantage du .spip, c'est que tu appliques 
propre() et tu peux montrer en direct des exemples (pour les tableaux 
notamment).

MM.
_______________________________________________
liste: https://listes.rezo.net/mailman/listinfo/spip-dev
doc: https://www.spip.net/
dev: https://core.spip.net/
irc://irc.freenode.net/spip