Afin de faciliter la vie des auteurs, nous allons commencer par mettre l'archive de livraison à mort.
A sa place, il sera désormais possible de créer un répertoire spécifique au sein même du dossier du plugin / thème.
Ce répertoire sera nommé da_infos et pourra contenir les fichiers suivants :
- details.txt : Ce simple fichier texte, encodé au
format UTF8, pourra contenir plusieurs sections, dont 3 sections prédéfinies
- Description (obligatoire)
- Installation (facultative)
- Screenshots (facultative)
- screenshot-large.(png|jpg) : Une capture d'écran grand format, dans le cas d'un thème uniquement
- screenshot-##.(png|jpg) : Des captures d'écran numérotées (## = de 1 à n) supplémentaires, aussi bien pour un thème (autres vues que la simple page d'accueil) ou pour un plugin (captures d'écran de l'interface d'administration, des widgets, etc.)
- un fichier CHANGELOG "standard" (Enfin, c'est encore sous réserve pour l'instant).
De notre point de vue, la présence d'un tel dossier présente les avantages suivants :
- L'auteur peut faire sa tambouille tranquillement en local, avec ses outils de prédilection
- Ce dossier et les fichiers qu'il contient sont par défaut pris en charge par les packagers DC1 et DC2
- Isoler ces fichiers dans un sous-dossier permet de ne pas "polluer" le dossier de l'extension
- Il serait possible, si nécessaire, de filtrer ce dossier des packages redistribués par DotAddict.org (après soumission donc) ou de l'ignorer au moment de l'installation du package sur un Dotclear.
Nous reviendrons un peu plus tard sur le format du fichier details.txt. D'ici là, vos réactions seront les bienvenues.
Commentaires
par Sacha
Et on peut pas inviter les contributeurs sur l'interface d'administration Dotaddict ? Ils font leur billet en wiki, le classement, ajoutent les pièces jointes, prévisualisent, enregistrent. Tout simplement.
Il ne reste plus qu'à le faire valider par l'équipe de maintenance Dotaddict, et c'est publié.
Techniquement, ça ne me semble pas être difficile à faire, il faut juste une interface pour s'enregistrer et peut-être un petit plugin pour bien affiner les permissions (mettre en place une validation supplémentaire après l'édition d'un billet existant).
Parce que là, il faut travailler avec les fichiers de l'archive, sans aucune interface, et c'est pas cool du tout... :'(
Et si je peux aider dans la conception du truc, c'est volontiers, qu'on ne me dise pas "Where's your patch?"
par Tomtom
@Sacha: Ce système est mis en place pour que chaque billet (donc pour plugins et thèmes) aient exactement la même structure mais cela laisse quand même la liberté aux contributeurs de pouvoir "personnaliser" sa description avec le wiki de Dotclear.
Aussi, le problème avec ton idée, c'est que retoucher les billets un à un après soumission pour les rendre conforme aux "standards" Dotaddict est long est fastidieux. Là, tout se fera en automatique :D
par Pep
Sacha > C'est la première idée qui nous était venue au démarrage de DA, justement parce que c'était la plus simple. Mais en utilisation, elle serait devenue rapidement inefficace et ingérable.
par Sacha
Tomtom, Pep, je ne suis pas convaincu. Mais puisque vous êtes bien décidés, faites comme bon vous semble, et voyons voir ce que ça donne en pratique.
par Tomtom
@Sacha: En même temps, lorsque l'on dépose un plugin sur DA, il faut bien renseigner les parties description / installation. Est-ce vraiment gênant d'écrire ces parties dans un fichier plutôt que dans un formulaire? A savoir aussi pour le reste : auteur / version / description courte / etc... ce sera traité automatiquement en fonction du _define.php
par Pep
Sacha > Nous ne comptons pas non plus discuter du choix d'architecture qui a été fait en connaissance de cause il y a maintenant 9 mois par l'ensemble de l'équipe.
par Pierre
Bonjour, est-ce normale que la page de dépôt de plugin (http://plugins.dotaddict.org/infos/...) ne soit pas accessible et qu'un message indique qu'elle seras de nouveau en ligne le 08/08/08 (nous sommes le 16/08). Je tenais juste à vous le signaler.
Pierre
par Pep
Oui et non : les soumissions de plugins ne sont toujours pas ré-ouvertes, nous avons pris du retard sur le planning initialement prévu.
Désolé.
par brol
Je le trouvais pourtant pratique ce zinzin de livraison-plugin.zip.