Changes between Version 2 and Version 3 of fr/sources

Timestamp:

Dec 5, 2006, 3:09:06 PM (14 years ago)

Author:

laurentj

Comment:

--

fr/sources

@@ -76 +76 @@
 Avant de faire des modifications, il faut préparer votre environnement. Vous devez avoir le répertoire contenant les sources du dépot, et le répertoire qui contiendra une version utilisable du framework. Par exemple :
 
+Pour le répertoire du dépot, et contenant donc trunk/lib etc. :
+{{{
+   /home/laurent/projets/jelix/svn/ 
+}}}
 
+Pour le répertoire cible, contenant la version interprétable/utilisable par php
 {{{
-   /home/laurent/projets/jelix/svn/ pour le répertoire du dépot, et contenant donc trunk/lib etc..
-   /home/laurent/projets/jelix/tests/ pour le répertoire cible, contenant la version interprêtable par php
-
+   /home/laurent/projets/jelix/tests/ 
 }}}
 
 
-Afin d'initialiser le répertoire cible tapez en ligne de commande :
-
-{{{
-make TESTPATH=/home/laurent/projets/jelix/tests/ all-test
-
-}}}
-
-
-
-Cela va vous générer dans ce répertoire tests :
-   lib/
-   temp/
-   testapp/
-   myapp/
-   ..
-
-
-Il faut ensuite configurer votre serveur web local pour qu'il pointe sur tests/ ou directement sur tests/testapp/www et/ou tests/myapp/www/
-
-Ensuite, à chaque modification que vous faites dans jelix, et avant de pouvoir tester, il faut refaire un make, ou appeler directement buildjelix.php. 
-
-{{{
-  make TESTPATH=/home/laurent/projets/jelix/tests/ jelix-test
-}}}
-
-ou
-
-{{{
-  php build/buildjelix.php -D TESTPATH=/home/laurent/projets/jelix/tests/ build/config/jelix-test.ini
-}}}
-
-Vous pouvez aussi créer votre propre fichier ini pour éviter d'avoir à indiquer tout le temps le chemin, ou avoir un build personnalisé de jelix. Copiez alors le fichier jelix-test.ini sous un autre nom, où vous voulez, et modifiez-le à votre convenance.
+Créez un fichier monbuild.ini, sur le modèle de ceux que vous trouvez dans build/config (jelix-test.ini par ex). Il contiendra alors :
 
 
@@ -131 +103 @@
 }}}
 
-puis vous exécuterez :
+
+Ensuite, vous lancez la commande
 
 {{{
-  php build/buildjelix.php monfichier.ini
+  php build/buildjelix.php monbuild.ini
 }}}
+
+
+Même principe pour les applications de test myapp et testapp. Il faut alors utiliser le script build/buildapp.php avec le fichier de config adéquate dans build/config (myapp-test.ini ou testapp-test.ini)
+
+{{{
+  php build/buildapp.php montestapp.ini
+}}}
+
+
+
+'''Note''': il faut lancer le build à chaque modification dans les sources de jelix, avant de le tester.
+
 
 === Générer un package ===
 
-Le principe est exactement le même que pour générer une version de travail. Vous avez par exemple :
+Le principe est exactement le même que pour générer une version de travail. Vous avez par exemple : /home/laurent/projets/jelix/dist/ pour le répertoire qui contiendra les futurs zip/tar.gz
 
-   /home/laurent/projets/jelix/svn/trunk/... pour le répertoire du dépôt
-   /home/laurent/projets/jelix/dist/ pour le répertoire cible
+Créez un nouveau fichier ini mondist.ini sur le modèle de monbuild.ini, en indiquant ce repertoire et en activant les options PACKAGE_TAR_GZ et/ou PACKAGE_ZIP
 
-Faites alors :
 
 {{{
-make DISTPATH=/home/laurent/projets/jelix/dist/ jelix-dist
+MAIN_TARGET_PATH = /home/laurent/projets/jelix/dist/
+PHP_VERSION_TARGET =
+ENABLE_PHP_FILTER =
+ENABLE_PHP_JSON =
+ENABLE_PHP_XMLRPC =
+ENABLE_DEVELOPER = 1
+PACKAGE_TAR_GZ = 1
+PACKAGE_ZIP = 1
+STRIP_COMMENT =
+ENABLE_OPTIMIZE =
 }}}
 
-Ce qui est en fait équivalent à 
+et ensuite :
 
 {{{
-  php build/buildjelix.php -D TESTPATH=/home/laurent/projets/jelix/dist/ build/config/jelix-dist.ini
+  php build/buildjelix.php mondist.ini
 }}}
-
-Si vous avez fait un fichier ini personnalisé, il vous suffit simplement de mettre la valeur 1 (ou "on") pour les paramètres PACKAGE_TAR_GZ et/ou PACKAGE_ZIP.
 
 
 Vous aurez alors dans /home/laurent/projets/jelix/dist/ des archives prêtes à être distribuées.
 
+=== Utilisation du Makefile ===
 
-=== Autres paramètres pour make ===
+Il existe un fichier makefile, utilisable par la commande Make, qui est appel les scripts de build pour jelix et autres applications stockées dans le dépot. Le Makefile accepte différentes cibles, qui permettent de générer des repertoires de travail ou des paquets à distribuer avec les paramètres standards. Tapez simplement make pour en avoir la liste.
 
-Le Makefile accepte différentes cibles, qui permettent de générer des repertoires de travail ou des paquets à distribuer avec les paramètres standards. Tapez simplement make pour en avoir la liste.
+Toutefois, il n'est en principe pas à utiliser (et disparaitra peut être). Il est surtout utile pour le serveur de jelix.org.
 
-Il permet de travailler aussi avec jtpl standalone et autres produits issus de Jelix.
+Pour ceux qui veulent absolument l'utiliser, il est possible de modifier dynamiquement le MAIN_TARGET_PATH d'un des fichier ini en passant la valeur TESTPATH ou DISTPATH à make. Ex :
 
+{{{
+make TESTPATH=/home/laurent/projets/jelix/tests/ all-test
+}}}
 
+Cela va vous générer toutes les applis et jelix dans le répertoire tests :
+   lib/
+   temp/
+   testapp/
+   myapp/
+   ..
 
 ----