Page pour développeurs

 Menu
 · Qu'est-ce que c'est ?
 · Téléchargements
 · Développeurs
 · Besoin d'aide ?
 · Listes de discussions
 · Divers


Qu'est-ce que daCode ?

Explication courte : daCode est un moteur de news écrit en PHP. daCode est avant tout orienté vers la modularité, la vitesse, et les performances. Parmi les fonctionnalités, on compte des themes, l'identification des utilisateurs, un support multilingue, un système de cache, ainsi qu'un système de templates, et bien plus encore.

Explication plus complète : daCode est un moteur de news écrit en PHP. Il fonctionne avec PHP 3 et 4, et nécessite l'utilisation d'une base de données (MySQL ou PostgreSQL). Il peut également être utilisé, en plus d'une base données, avec LDAP ou NIS. daCode est avant tout orienté vers la modularité et les performances. Il utilise donc des classes, ainsi qu'un système de cache. Parmi les autres fonctionnalités, on trouve des thèmes (ainsi qu'un système de templates), l'identification des utilisateurs, un support multilingue, une tribune libre, un module d'astuces, et bien plus encore.

Pour plus d'informations, passez sur le site officiel de daCode situé à l'adresse daCode.org.
Téléchargements

daCode existe actuellement en deux versions : la première est stable, et la seconde est instable, buggée, et destinée avant tout aux développeurs.
La dernière version stable est la version 1.2.0.
Une version instable est crée chaque nuit (on les appelle des nightly builds).

Il est plus que recommandé que vous choisissiez la version stable. Ne téléchargez les nightly builds que si vous savez ce que vous faites, êtes préparés à des problèmes dans le code, ou voulez aider au développement.
Vous voilà prévenus.

Développeurs

Si vous souhaitez participer au développement de daCode, toutes les informations dont vous avez besoins sont ici.
  • SourceForge.net :
    La page du projet sur SourceForge.net est située à l'URI :
    http://sf.net/projects/dacode/.

  • Site de démo :
    Nous avons un site de démo, qui utilise la version CVS du jour (et qui peut ne pas être en bon état). Il est visible à l'adresse demo.dacode.org.
    Si vous voyez des bugs, pensez à nous les rapporter.

  • Quoi de neuf ?
    · ChangeLog - L'intégralité des changements (attention, le fichier est lourd).
    · CURRENT - Ce sur quoi nous travaillons actuellement.
    · NEWS - Le résumé de tous les changements importants.
    · TODO - Ce qui reste à faire.

  • CVS :
    Le repository CVS de daCode est actuellement sur SourceForge.net

    Vous pouvez le parcourir dans votre navigateur web à cette URI :
    http://cvs.sf.net/cgi-bin/viewcvs.cgi/dacode/.

    Voici ce que vous avez à taper dans votre shell pour obtenir une version CVS de daCode à jour :

         cvs -d:pserver:anonymous@cvs.dacode.sf.net:/cvsroot/dacode login

    Pressez [Entrée] quand on vous demande un Password (mot de passe).
    Tapez ensuite:

         cvs -z3 -d:pserver:anonymous@cvs.dacode.sf.net:/cvsroot/dacode co daCode

    Pour les mises à jour suivantes, vous aurez juste à taper cvs update dans votre répertoire daCode, pour mettre à jour votre version locale de daCode.

    Notez que cela ne concerne que les utilisateurs qui ne sont pas listés parmi les developpeurs de daCode. Si vous êtes listés sur cette page, vous devez déjà savoir comment tout cela fonctionne.

  • Nighly builds :
    Les nightly builds sont créées chaque nuit avec le contenu du repository CVS actuel.
    Elles sont très utiles pour ceux qui n'ont pas accès à CVS mais veulent contribuer à daCode.
    Vous voulez la dernière ? Cliquez ici.

  • Patchs :
    AVANT TOUT : lisez le fichier doc/RULES.

    La meilleure façon de soumettre des morceaux de code pour daCode, c'est de créer des patchs.
    Pour cela, vous aurez besoin d'utiliser diff (toujours avec l'option -u).
    C'est très facile à utiliser quand vous avez un accès CVS. Vous n'avez qu'à taper :

         cvs diff -u > ~/dacode.patch

    Pour ajouter un nouveau fichier à votre patch, tapez ceci :

         diff -u /dev/null src/htdocs/newfile.php3 >> ~/dacode.patch

    Si vous n'avez pas accès à CVS, c'est un peu moins trivial.
    Vous aurez besoin de décompresser votre nightly build deux fois, sous deux noms différents. Nommez la première daCode.orig, et la seconde daCode. Faites ensuite l'intégralité de vos modifications dans le répertoire nommé daCode, et aucune dans celui nommé daCode.orig. Quand vous aurez terminé, tapez :

         diff -ur -I "^[-# *]*\$Id[:,_./a-zA-Z0-9 -]*\$$" --exclude CVS daCode.orig daCode > ~/dacode.patch

    Et pour ajouter de nouveaux fichiers à votre patch :

         diff -uNr --exclude CVS daCode.orig daCode > ~/dacode.patch

    Quand votre patch est prêt, envoyez-le sur dacode-dev.

  • Windows :
    daCode peut être utilisé sous Windows sans problème majeur.
    daCode tourne sous Windows avec Apache et PHP 3 ou 4. Il tourne égalemnet sous Windows avec IIS 5 et PHP 3 ou 4.
    Si vous souhaitez développer sous Windows, vous aurez besoin d'un éditeur de code qui supporte les retours à la ligne de type Unix ("\n" pour Unix, contre "\r\n" pour Windows). Vous aurez également besoin de CygWin pour utiliser le repository CVS et pour créer des patchs.

  • Applications tierces :
    Si vous avez crée une application ou un script en rapport avec daCode, vous pouvez le voir rajouté au répertoire contrib/ de daCode.
    Lisez le fichier contrib/README pour plus de détails.

  • Graphismes & themes:
    Si vous désirez faire des logos, des images, ou quoi que ce soit inspiré par daCode, n'hésitez pas à le faire, cela nous fera plaisir. Vous pouvez également nous le faire savoir par email.

    Si vous avez designé un nouveau thème pour daCode, et que vous aimeriez l'y voir inclus, vous aurez à nous en avertir par email. Nous déciderons si nous l'incluons ou non.

  • Site officiel :
    Le site officiel de daCode est daCode.org.

  • Listes de discussions ?
    Les développeurs ont leurs propres listes de discussions (dacode-dev et dacode-cvs). Voyez ci-dessous pour plus d'infos.


Besoin d'aide ?

Si vous avez des problèmes avec l'installation de daCode, des difficultés à utiliser une fonction, l'impossibilité de comprendre comment fonctionnent les thèmes, etc, vous avez deux solutions pour voir votre problème résolu.
Notez que dans les deux cas, ce sont les mêmes personnes qui vous liront, puisque la page située sur SourceForge.net renvoit votre demande sur la mailing-list.

Notez également que vous pouvez venir sur irc, sur irc.openprojects.net sur le channel #daCode.
Listes de discussions

Pas moins de six (6) listes de discussions sont utilisées pour daCode. Chacune, hébergée sur le même serveur que daCode.org, a son propre usage.
  • dacode-announce [S'abonner]
    Cette liste à très faible trafic contient les annonces des nouvelles versions de daCode.

  • dacode-user [S'abonner]
    Utilisez cette liste si vous avez besoin d'aide ou avez un problème quelconque avec daCode.
    La page de demande d'aide sur SourceForge.net renvoit les messages vers cette liste. Pensez à détailler votre problème, et à donner le numéro de version de votre daCode.

  • dacode-bugs [S'abonner]
    Cette liste sert à rapporter des bugs et à les fixer.
    Les bugs postés depuis SourceForge.net sont repostés dans cette liste automatiquement.

  • dacode-corp [S'abonner]
    Si vous souhaitez voir une fonctionnalité dans daCode, mais ne savez pas comment la coder, c'est ici qu'il faut s'abonner.
    Les demandes de fonctionnalités faites depuis SourceForge.net sont également postées ici.

  • dacode-dev [S'abonner]
    Vous souhaitez parler du développement de daCode ? Soumettre un patch ? Cette liste est faite pour vous.
    Notez que les patchs postés sur SourceForge.net sont redirigés ici.

  • dacode-cvs [S'abonner]
    Tous les changements fais dans le repository CVS sont automatiquement repostés ici.
    Cette liste peut être très active.
    Si vos patchs sont vraiment gros, postez-les ici plutôt que dans dacode-dev.

On peut parler en français et en anglais sur toutes ces listes. Vous pouvez essayer une autre langue, mais il y a peu de chances que vous receviez une autre réponse que quelque chose du genre "What?" ou "Je ne comprends pas".
Divers

Quelques liens utiles :
Dernière mise à jour : $Date: 2002/01/16 10:14:18 $ par $Author: netsabes $.
ChangeLog · Un bug sur cette page ? · Tree CVS de cette page

Valid XHTML 1.0!     SourceForge Logo     Valid CSS!