developer.jelix.org is not used any more and exists only for history. Post new tickets on the Github account.
developer.jelix.org n'est plus utilisée, et existe uniquement pour son historique. Postez les nouveaux tickets sur le compte github.

Changes between Version 15 and Version 16 of fr/sources


Ignore:
Timestamp:
Jul 21, 2009, 12:00:38 PM (11 years ago)
Author:
laurentj
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • fr/sources

    v15 v16  
    44
    55
    6 == principes ==
     6== Principes ==
    77
    8 Travailler avec les sources de Jelix est assez différent des projets PHP traditionnels, en ce sens que les sources que l'on trouve dans le dépôt subversion, n'est pas directement utilisable par PHP. En clair, le contenu qui est proposé dans les archives en téléchargement, est légèrement différent de ce qui est dans le dépôt.
     8Travailler avec les sources de Jelix est assez différent des projets PHP traditionnels, en ce sens que les sources que l'on trouve dans le dépôt des sources, n'est pas directement utilisable par PHP. En clair, le contenu qui est proposé dans les archives en téléchargement, est légèrement différent de ce qui est dans le dépôt.
    99
    1010En effet, certains fichiers sources de Jelix contiennent des directives spéciales permettant à un pré-processeur, de générer un fichier source final qui sera différent selon des paramètres qu'on lui fournit. Ce pré-processeur est piloté par un script, que l'on appelera un "générateur" de sources finales (le résultat, les sources finales, sont appelées aussi un "build"). Cela permet de fournir des versions différentes de Jelix
     
    1818Ainsi, quand on travail sur jelix, on suit ces étapes :
    1919
    20  1. récupération de la dernière version de jelix dans le dépôt subversion (svn checkout)
     20 1. récupération de la dernière version de jelix à partir du dépôt principal des sources Mercurial (hg clone etc)
    2121 1. création d'un fichier de paramètres pour le générateur (un fichier ini)
    2222 1. modification des fichiers sources de jelix (correction de bug, amélioration, nouvelle  fonctionnalité etc..)
    2323 1. lancement du générateur de sources finales. On obtient un "build"
    2424 1. test du build avec une application, et en particulier testapp (qui est fournie dans le dépôt subversion) qui contient tout les tests unitaires
    25  1. si les tests sont concluants, le développeur propose son patch (svn diff) et débute alors le processus de review.
     25 1. si les tests sont concluants, le développeur propose son patch et débute alors le processus de review.
    2626
    2727Pour ceux qui veulent juste avoir une version optimisée/personnalisée, seules ces étapes sont nécessaires :
    2828
    29  1. récupération de la dernière version de jelix dans le dépôt subversion
     29 1. récupération de la dernière version de jelix dans le dépôt mercurial
    3030 1. création d'un fichier de paramètres pour le générateur afin d'obtenir la version souhaitée
    3131 1. lancement du générateur de sources finales.
     
    3535== Récupérer les sources ==
    3636
    37 Il faut les récupérer à partir du dépôt [http://subversion.tigris.org/ Subversion]. Il faut donc installer sur votre machine un client subversion. Puis ensuite le configurer pour accéder au dépôt.
     37Jusqu'en juillet 2009, les sources étaient gérés par l'outils  [http://subversion.tigris.org/ Subversion]. Depuis, nous utilisons [http://hg-scm.org Mercurial]
    3838
    39 Pour rappel, subversion est outil de contrôle de version : il permet d'enregistrer et d'historiser toutes les modifications faites sur les fichiers sources d'un projet.
     39Pour récupérer les sources, il vous faut donc installer Mercurial sur votre machine, et ensuite cloner l'un des dépots disponible (il y en a plusieurs, suivant les branches) principal http://hg.jelix.org/jelix/jelix-trunk/ (ou l'un de ceux qui sont dans http://hg.jelix.org/jelix/ , suivant ce que vous voulez faire).
    4040
    41 Voici l'adresse du dépôt subversion de Jelix, pour les contributeurs "anonymes" :
     41Pour rappel, Mercurial est outil de contrôle de version : il permet d'enregistrer et d'historiser toutes les modifications faites sur les fichiers sources d'un projet.
     42
     43Voici l'adresse du dépôt principal de Jelix, pour les contributeurs "anonymes" :
    4244
    4345{{{
    44    http://svn.jelix.org/jelix/trunk
     46   http://hg.jelix.org/jelix/jelix-trunk/
    4547}}}
    4648
     
    4951
    5052{{{
    51    svn+ssh://svnjelix@svn.jelix.org/jelix/trunk
     53   ssh://hg@jelix.org/jelix/jelix-trunk
    5254}}}
    5355
    54 Note: l'utilisateur à indiquer est toujours "svnjelix". Le serveur reconnait automatiquement votre login grâce à votre clé ssh.
     56Note: l'utilisateur à indiquer est toujours "hg". Le serveur reconnait automatiquement votre login grâce à votre clé ssh que vous avez donné.
    5557
    5658
    57 Cela donne donc, avec un client subversion en ligne de commande :
     59Cela donne donc en ligne de commande :
    5860
    5961
    6062{{{
    61 svn checkout http://svn.jelix.org/jelix/trunk
     63hg clone http://hg.jelix.org/jelix/jelix-trunk/
    6264}}}
    6365ou
    6466{{{
    65 svn checkout svn+ssh://svnjelix@svn.jelix.org/jelix/trunk
     67hg clone ssh://hg@jelix.org/jelix/jelix-trunk
    6668}}}
    6769
    6870
    69 jelix/trunk (branche principale) contient la prochaine version majeure en cours de développement (1.1, 1.2 etc.). Si vous voulez récupérer d'autres branches ou versions officielles, en particulier les branches de maintenances des versions sorties comme la branche 1.0.x (1.0, 1.0.1, 1.0.2...) indiquez par exemple jelix/branches/1.0.x.
    70 
    71 
    72 {{{
    73    svn+ssh://svnjelix@svn.jelix.org/jelix/branches/1.0.x
    74 }}}
    75 
    76 Bien sûr, si vous voulez récupérer le dépôt entier :
    77 
    78 {{{
    79    svn+ssh://svnjelix@svn.jelix.org/jelix
    80 }}}
    81 (attention, cela peut être volumineux)
    82 
     71jelix-trunk constitue la branche principale du framework : il contient la prochaine version majeure en cours de développement (1.1, 1.2 etc.). Si vous voulez récupérer d'autres branches ou versions officielles, en particulier les branches de maintenances des versions sorties comme la branche 1.0.x (1.0, 1.0.1, 1.0.2...), elles sont stockées dans http://hg.jelix.org/jelix/releases/. Pour avoir la branche 1.0.x : http://hg.jelix.org/jelix/releases/jelix-1.0.x (ou ssh://hg@jelix.org/jelix/releases/jelix-1.0.x
    8372
    8473
     
    9887== Les outils de constructions ==
    9988
    100 Les sources obtenues via le dépôt subversion ne peuvent pas être utilisable directement par PHP. Pour pouvoir utiliser Jelix, il faut générer les sources finales interpretables par PHP. Pour ce faire il y a un script build/buildjelix.php. C'est le fameux "générateur". C'est une sorte de makefile. Il prend en argument un nom de fichier ini qui déclare des paramètres de génération. Vous en avez quelques exemples dans le repertoire build/config/.
     89Les sources obtenues via le dépôt mercurial ne peuvent pas être utilisable directement par PHP. Pour pouvoir utiliser Jelix, il faut générer les sources finales interpretables par PHP. Pour ce faire il y a un script build/buildjelix.php. C'est le fameux "générateur". C'est une sorte de makefile. Il prend en argument un nom de fichier ini qui déclare des paramètres de génération. Vous en avez quelques exemples dans le repertoire build/config/.
    10190
    10291
     
    10594Avant de faire des modifications, il faut préparer votre environnement. Vous devez avoir le répertoire contenant les sources du dépôt, et le répertoire qui contiendra une version utilisable du framework. Par exemple :
    10695
    107 Pour le répertoire du dépot, et contenant donc trunk/lib etc. :
     96Pour le répertoire du dépot, et contenant donc lib/ etc. :
    10897{{{
    109    /home/laurent/projets/jelix/svn/
     98   /home/laurent/projets/jelix/hg/jelix-trunk
    11099}}}
    111100