Dotclear

Vous n'êtes pas identifié(e).

Annonce

#51 2007-06-02 22:01:44

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Moe a écrit :

Au cas ou je reposte le problème ici : la doc des Behaviors n'indique pas dans quel fichier coller le code, j'ai essayé de le mettre dans _admin.php d'un plugin et l'exemple ne fonctionne pas. Le behavior "beforePostUpdate" n'existe pas, j'ai aussi essayé avec "adminBeforePostUpdate" et le titre du billet n'a pas été changé non plus.

Désolé d'être lourd, je reviens à la charge : le behaviour "beforePostUpdate" n'existe toujours pas (il n'est pas dans la liste en-dessous de l'exemple), l'exemple est donc non fonctionnel !

Hors ligne

#52 2007-06-03 07:44:03

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Je transmets, merci :)


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#53 2007-06-03 08:13:29

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Vala, Pep a corrigé la doc :)


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#54 2007-06-22 14:02:05

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

J'ai envoyé 2 mails à documentation@dotclear.net, à propos d'une doc en cours de rédaction sur les connexions, qui sont restés sans réponse.

Faut-il mieux faire comme Kozlika, Pep et Franck Paul : écrire sa propre doc, quitte à éparpiller les informations aux 4 coins du Web ? Est-ce que ça (les infos des éminents membres précédemment cités) ne devrait pas plutôt figurer sur le wiki ? Ou alors c'est en attendant que le wiki soi ouvert ?

Hors ligne

#55 2007-06-22 14:34:09

Pep
Membre
Inscription : 2004-08-24
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Ah mais je n'écris aucune doc, moi ! :-)
Concernant les écrits de mes petits camarades, je pense qu'il y a certains articles qui peuvent avoir besoin de mijoter dans un coin personnel avant d'être gravés dans le marbre de doc.dotclear.net. Une sorte de période d'incubation en fait.
Personnellement, je ne pense pas qu'il s'agit là d'un mal.

Pour en revenir au sujet initial, c'est probablement Kozlika qui reçoit les messages envoyés à documentation@dotclear.net. Et comme en ce moment, elle jongle avec ses cartons et n'a qu'une connexion intermittente (et empruntée), voilà qui pourrait expliquer l'absence de réponse.


Who Cares ?

Hors ligne

#56 2007-06-22 20:41:04

Franck
Footer de merde
Lieu : Paris
Inscription : 2004-11-09
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Pep a écrit :

Ah mais je n'écris aucune doc, moi ! :-)
Concernant les écrits de mes petits camarades, je pense qu'il y a certains articles qui peuvent avoir besoin de mijoter dans un coin personnel avant d'être gravés dans le marbre de doc.dotclear.net. Une sorte de période d'incubation en fait.
Personnellement, je ne pense pas qu'il s'agit là d'un mal.…

C'est tout à fait ça ! Je dirai même plus que certaines remarques et questions faites dans les commentaires des billets peuvent permettre d'aboutir à une version plus claire.


Dotclear addicted since 2004

Hors ligne

#57 2007-06-22 21:25:33

Pep
Membre
Inscription : 2004-08-24
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

tortuegt a écrit :

C'est tout à fait ça !

Ah ! Vous voyez que je ne dis pas que des âneries ! ;-)


Who Cares ?

Hors ligne

#58 2007-06-25 11:14:35

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Bien, j'ai fait comme les gourous Dotclear, j'ai écrit une documentation. C'est ma première donc faut être indulgent. Bonne lecture. :)

Hors ligne

#59 2007-08-15 13:38:27

Digimag
Membre
Lieu : Marseille
Inscription : 2006-04-09
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Dans la documentation pour la réalisation du premier plugin on propose $core?url?getType('HelloWorld') alors que urlHandler de Clearbricks ne propose pas de fonction getType(), et au passage ça n'a pas l'air très clair, sans oublier qu'aucun fichier fourni avec Dotclear n'utilise getType, c'est peut-être une erreur ? S'agissait-il de getBase() (dans ce cas, il y a répétition...) ?


Sacha :)

Hors ligne

#60 2007-09-01 10:39:25

Digimag
Membre
Lieu : Marseille
Inscription : 2006-04-09
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Et aussi, quand j'ai vu l'emploi du mot "class" dans la doc, j'ai d'abord eu l'idée de corriger en "classe", mais en m'apercevant que le mot "class" était utilisé à plusieurs reprises, je me suis dit que c'est fait exprès.

Et pareil pour le mot "package" : en français, on emploie plutôt "paquetage". Pourquoi utiliser des termes anglais alors que les mots français existent ?


Sacha :)

Hors ligne

#61 2007-09-01 12:36:18

Philippe
Stagiaire
Lieu : Toulon
Inscription : 2004-06-13
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

>Digimag : la doc sera bientôt ouverte aux contributions des utilisateurs. En attendant, les sorciers sont occupés, et eux seuls peuvent corriger cette rubrique (je comprends vaguement le problème que tu soulèves).  Merci pour le coup de main, et patience ;)

Pour la terminologie, je partage le même avis, quoique je préfère "installeur" à "paquetage".

Mais on parle encore d'une version beta, non ?

Hors ligne

#62 2007-09-01 16:37:30

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

amalgame a écrit :

quoique je préfère "installeur" à "paquetage".

L'installateur installe des installeurs ou l'installateur installe des paquetages ? :)

Hors ligne

#63 2008-01-08 18:11:53

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

Sur la page multiblog, le fait d'appeler le répertoire dotclear "dc2" peut être source de confusion et de plus cela n'a pas d'intérêt (je vous laisse argumenter sur les avantages si vous en trouvez), il est plus simple de garder le nom "dotclear". Pourquoi faire compliqué quand on peut faire simple ?

Hors ligne

#64 2008-01-08 18:14:01

brol
Membre
Inscription : 2005-10-16

Re : Documentation Dotclear 2.0 contributions, suggestions

snip

Dernière modification par brol (2016-09-05 17:23:13)

Hors ligne

#65 2008-01-08 22:08:26

Philippe
Stagiaire
Lieu : Toulon
Inscription : 2004-06-13
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

brol a écrit :

j'imagine que c'est pour différencier pour ceux qui ont déjà un dc1 ?

c'est la seule raison, je pense

mais en considérant que beaucoup de gens installent maintenant dc2 sans avoir de dc1, l'argument de Moe se tient : dotclear, comme nom,  est bien mieux approprié

on corrigera ça dans la doc dès la sortie de la version finale :D

Hors ligne

#66 2008-01-08 22:11:31

brol
Membre
Inscription : 2005-10-16

Re : Documentation Dotclear 2.0 contributions, suggestions

snip

Dernière modification par brol (2016-09-05 17:23:19)

Hors ligne

#67 2008-01-08 22:18:47

Philippe
Stagiaire
Lieu : Toulon
Inscription : 2004-06-13
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

brol a écrit :

dc1 va sortir en version finale ?
oh ! une traaaaaaaaaapp...
hinhinhin ;-)

chut ! si un sorcier passe et voit que j'ai dit [les-mots-défendus], je suis bon pour le tri de {tpl:trucs} pendant une semaine...

Hors ligne

#68 2008-01-08 22:24:42

brol
Membre
Inscription : 2005-10-16

Re : Documentation Dotclear 2.0 contributions, suggestions

snip

Dernière modification par brol (2016-09-05 17:23:25)

Hors ligne

#69 2008-06-19 16:44:29

Marceau
Membre
Inscription : 2008-04-12

Re : Documentation Dotclear 2.0 contributions, suggestions

J'ai écris à documentation at dotclear.net le 13 juin et, à moins qu'un antispam sauvage n'ait sévi, je n'ai toujours pas de réponse. Je renvoie donc ici la première partie du message:

Bonjour

Je voudrais signaler quelques difficultés que j'ai eu en comparant la page

http://doc.dotclear.net/2.0/resources/templates

avec le contenu de la classe dcTemplate (DC2 RC1)

1 - Dans la liste des tags de catégories, il y a deux fois {{tpl:CategoryURL}}, le deuxième ne devrait-il pas être {{tpl:CategoryShortURL}} ? (de même dans la page à laquelle le lien renvoie)

2 - Dans la liste des tags de billets, {{tpl:DateHeader}} et {{tpl:DateFooter}} me semble être plutôt de type bloc et devraient donc s'écrire <tpl:DateHeader> et <tpl:DateFooter> ? (de même dans la page à laquelle ces liens renvoient)

3 - Dans la liste des tags système, il y a deux fois {{tpl:SysIfFormError}},
il me semble que le premier est un tag de type bloc et devrait donc s'écrire <tpl:SysIfFormError>, alors que le second est en fait {{tpl:SysFormError}} (de même dans la page à laquelle ces liens renvoient)

Mais peut-être que ceci n'est qu'une situation postérieure à la rédaction de ces pages.

J'ai trouvé également dans la classe dcTemplate les nouveaux tags non documentés :
{{tpl:CommentPreviewCheckRemember}}
{{tpl:SysSearchString}}
{{tpl:SysSelfURI}}

J'ai repéré ces problèmes en rédigeant une documentation plus complète pour les rédacteurs de templates. Cette documentation recense tous les attributs utilisables dans chaque tag, ainsi que les contextes dans lesquels on peut les utiliser et des exemples d'utilisation.

La suite demande l'accompagnement d'une pièce jointe, ce qui ne semble pas possible sur ce forum.

Hors ligne

#70 2008-06-20 06:34:35

olivier
Administrator
Inscription : 2004-10-11

Re : Documentation Dotclear 2.0 contributions, suggestions

Tu peux envoyer un mail à l'adresse donnée dans le premier message de ce fil :)


La seule difference entre un fou et moi, c'est que je ne suis pas fou. (Dali)

Hors ligne

#71 2008-06-20 07:07:13

Marceau
Membre
Inscription : 2008-04-12

Re : Documentation Dotclear 2.0 contributions, suggestions

Je peux, c'est même par là que j'ai commencé si tu relis le début de mon message, mais comme personne n'a répondu, je me demande si c'est la peine.

Hors ligne

#72 2008-06-20 07:09:39

Marceau
Membre
Inscription : 2008-04-12

Re : Documentation Dotclear 2.0 contributions, suggestions

Et puis ça ne dit rien sur le problème que je signale, alors tant pis.

Hors ligne

#73 2008-06-20 07:46:11

olivier
Administrator
Inscription : 2004-10-11

Re : Documentation Dotclear 2.0 contributions, suggestions

Ce n'est pas moi qui m'occupe de relever cette adresse. Je ne comprends pas bien le "alors tant pis". Pour ce qui concerne l'erreur dans la doc, on va corriger, merci de l'avoir signalé.


La seule difference entre un fou et moi, c'est que je ne suis pas fou. (Dali)

Hors ligne

#74 2008-06-20 08:36:17

Marceau
Membre
Inscription : 2008-04-12

Re : Documentation Dotclear 2.0 contributions, suggestions

Il me semble que les erreurs viennent des commentaires du source de dcTemplate, qui ont apparemment servi à générer la doc si j'en juge par le source du wiki,

C'est donc plutôt dans le source de dctemplate qu'il faudrait corriger les commentaires avant de régénérer la doc, mais bon, peut-être que je suis à coté de la plaque.

Bonne continuation.

Hors ligne

#75 2008-06-20 09:55:36

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Documentation Dotclear 2.0 contributions, suggestions

C'est amalgame et moi et pour des raisons différentes nous sommes tous les deux un peu négligents ces temps-ci, désolée.

On va s'en occuper.


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

Vous n'êtes pas identifié(e).

Pied de page des forums

Sites map