developpement

Méthode de développement

NOALYSS est développé en MVC et utilise beaucoup l'objet.

Nous avons détaillé la méthode de développement, elle se trouve aussi dans le manuel, à télécharger sur http://download.noalyss.eu

Vous pouvez aussi la lire en ligne

Obtenir le code

Afin d'obtenir le trunk, pour suivre le développement, prenez-le depuis le repository git sur htts://savannah.nongnu.org

git clone git://git.savannah.nongnu.org/noalyss.git
git clone git://git.savannah.nongnu.org/noalyss-plugins.git

Environnement de développement

Régles et conseils

Agenda de développement

Vérifier si une tâche ou l'autre correspond à ce que vous voulez faire. Dans tous les cas, pensez à venir sur la Mailing list pour en discuter L'agenda se trouve ici.

En général, on utilise des tâches ou bugs pour le suivi.

Editeur conseillé

PhpStorm , eclipse ou netbeans sont fortement conseillés.

Netbeans vient avec tout ce dont vous avez besoin pour le PHP, pour Eclipse, il faudra ajouter les plugins git, PDT

Téléchargement de Netbeans

Tutoriel pour Eclipse avec PHP

PhpStorm

CodeLite

Atom

Outils

Code

1. Nommage Les fonctions sont en minuscule, verbe + action séparé par un souligné Les classes commencent toujours une lettre capitale

2. Documentation Dans la mesure du possible, documentez votre code en respectant les tags Doxygen. La documentation du code source est accessible en ligne ou dans le fichier de noalyss télécharger dans le répertoire doc

Plus d'information : Code avec Doxygen

3. Traduction Tous les textes (en français) doivent être entourés de _(): exemple

  $msg="Valide";
   echo "Bonjour";

deviennent

  $msg=_("Valide");
  echo _('Bonjour');

Cela permet aux scripts dans dev/ de retrouver les chaînes à traduire GETTEXT

Si vous souhaitez soumettre un patch

Afin de soumettre un patch , vous devez d'abord “cloner” la base de données (voir plus haut) ,

Ensuite vous créer votre propre branch soit à partir de UNSTABLE ou STABLE : UNSTABLE si c'est un développement pour la prochaine version, soit STABLE si c'est une correction de bug à mettre de la version STABLE.

Example :

git switch stable # ou unstable
git checkout -b mon_dev1

Puis après avoir modifié et testé , vous devez faire

git format-patch unstable..mon_dev1

Automatiquement des fichiers contenant les patch vont être générés, vous devez les envoyer et ils seront intégrés : compressez et envoyez le fichier obtenu sur la ML contrib.

Si vous souhaitez plus d'information sur les patches https://ariejan.net/2009/10/26/how-to-create-and-apply-a-patch-with-git/

Si vous souhaitez seulement être au courant de l'évolution, vous pouvez soit

Documentation du code source

Traduction

Traduction basée sur gettext.

  • developpement.txt
  • Dernière modification : 2024/04/13 09:03
  • de dany