Votre documentation d'extension, vous le gérez comment ?

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

Sinon il faudrait voir aussi pour sélectionner les champs à intégrer dans les tableaux car la sémantique des fichiers manifest est riche. Après faire un lien entre le 0 de la valeur par défaut avec le libellé mis pour a valeur 0 dans la zone. Actuellement pour un booleen j'ai 0 False, 1 True --- default : 0
l'idée sera d'avoir 0 False, 1 True --- default : False

dans le même genre avoir un affichage en mode développeur. Cela affiche le libellé traduit mais aussi la clé du JText. A voir si c'est utile.

Manu

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

dans le même genre avoir un affichage en mode développeur. Cela affiche le libellé traduit mais aussi la clé du JText. A voir si c'est utile.

Manu

hé hé, ben moi j'en ai trouvé qq unes des clés JText() non traduites. Ce sont des paramètres de filtres de vues, qui n'étaient pas affichés, donc non traduits

J'ai donc pu les rajouter dans les fichiers de Lang...

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

@Manu,

Serait-ce compliqué de pouvoir organiser l'arborescences des fichiers .md comme suit :
(je t'ai fait une Issue concernant ce sujet, car j'ai voulu filtrer admin/site, mais les results sont identiques...)

-Docs
-- Component
--- Admin
---- Items
---- Views
---- Plugins (if exists)
---- Modules (if exists)
---- Config.xml

--- Site
---- Items
---- Views
---- Plugins
---- Modules

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

en fait non pas du tout

c'est juste que si je le fais, je le fais pour tout le monde... difficile de trouver une arborescence pour tout le monde...

on peut aussi proposer un choix d'arborescence :
{category} - {lang} - {identifier} - {extension}
{lang} - {category} - {identifier} - {extension}

toi tu me demandes : {category} - {identifier} - {extension}
actuellement : {lang} - {category} - {extension}

çà pourrait le faire facilement oui

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

OK je comprends,

{identifier}, c'est bien admin ou site ?
et {category } c'est quoi pour toi ? moi, c'est le nom du composant, donc nom du Répertoire.

car je trouvais plus logique de faire :

{lang} - {category} - {extension} - {identifier}

et dans ce cas, tu n'aurais pas de fichier admin_ et site_ mélangés dans la même arbo ... comme l'arbo de l'install

mais c'est toi le Patron !

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

{lang} - {category} - {extension} - {identifier}
lang : en-GB
category : AllEvents (la catégorie liée à tes extensions)
extension : une ligne dans l'écran extension
identifier : Site / admin

et oui tu as raison (désolé) tu demandes : {lang} - {category} - {extension} - {identifier}

çà me va bien çà.

Je cablerai tout çà demain.

Manu

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

Haaaa, yes super ! t'es le meilleur

Autre point: (je travaille dessus pour te proposer qq chose)
J'ai remarqué que le .md issus de mon fichier config.xml ne représentait que les Options du premier fieldset.

Or le fichier de config de mon composant est très riche (~ 500 lignes) et présente un vrai tableau de bord pour paramétrer chaque vue.
Chaque <Fieldset> contient une douzaine de <field name>


C'est peut-être la page de doc la plus importante du composant ...

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

C'est que j'ai un bug alors

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

corrigé pour config et arborescence aussi.

résultat dispo sur mon site, c'est bien cela que tu voyais ?

Manu

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

c'est pas vraiment un bug, mais un raccourci.
Tu ne récupères que les Field->options du premier Fieldset, or la structure est comme suit :

<fieldset>
   [@attributes][n] 
      { $key=>$value }
      <field>
         [@attributes][n]
            { $key=>$value }
      </field>
</fieldset> 

Pour la documentation, il faut donc récupérer:
- Le Nom des Fieldsets et ses Attributs (options)
-- Le Nom des Fields et ses Attributs (options)

et c'est pas si simple

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

corrigé pour config et arborescence aussi.

résultat dispo sur mon site, c'est bien cela que tu voyais ?

Manu

Suis allé sur ton MarkNotes, mais en cliquant sur config_allevents, il ne se passe rien ... pas de display.
....
Aucun Doc ne s'affiche. J'ai l'arbo des fichiers sur toute la page...

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

euh... chez moi çà marche : https://www.allevents3.com/documenta...allevents.html
github a jour

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

Reload de la page Ok. ha ouais... Superbe !

je mets à jour ...

[elecoest]

Re : Votre documentation d'extension, vous le gérez comment ?

ne pas oublier que sans MarkNotes pas de Manifest2MD

[liubov]

Re : Votre documentation d'extension, vous le gérez comment ?

Tu m'as devancé, j'étais en train de mettre en forme ma boucle en Local ...

UN TRAVAIL EXCEPTIONNEL , Manu

http://liubov.net/marknotes/