wiki:en/sources
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.

Version 1 (modified by laurentj, 12 years ago) (diff)

--

Working with jelix sources

principles

Sources stored in the subversion repository are not ready to be performed by PHP. There are some preprocessing instructions in some php files, so, sources should be parsed by a preprocessor in order to be used by PHP. This preprocessing instruction allow to build packages for some specific PHP configurations, or some specific jelix editions.

So, here is the process :

  1. get sources of jelix from the subversion repository (svn checkout)
  2. create an ini file which contains options for the builder
  3. launch the build/buildjelix.php script by giving the ini file, then you have in an other directory the php files of jelix
  4. copy this files into your application, or package them etc..

For a contributeur of course he will do :

  1. gets sources of jelix from the subversion repository (svn checkout)
  2. makes modification in sources (bug fix, new feature..)
  3. creates an ini file which contains options for the builder
  4. launches the build/buildjelix.php script by giving the ini file
  5. in the target directory, he have the php files of jelix : he can test jelix.
  6. when it works well, he send a patch or commit his modification.
  1. récupération de la dernière version de jelix dans le dépôt subversion
  2. création d'un fichier de paramètres pour le générateur (un fichier ini)
  3. modification des fichiers sources de jelix (correction de bug, amélioration, nouvelle fonctionnalité etc..)
  4. lancement du générateur de sources finales. On obtient un "build"
  5. 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
  6. si les tests sont concluants, le développeur propose son patch (svn diff) et débute alors le processus de review.

getting sources

We use Subversion to store sources of jelix and to follow the history of modifications. So you have to install a subversion client on your machine. Then you can access to the repository by giving the address of the repository to subversion commands.

For "anonymous" users, the address is:

   http://svn.jelix.org/jelix/trunk

For contributors who have the right to commit into the repository :

   svn+ssh://svnjelix@svn.jelix.org/jelix/trunk

Note: the username to give is always "svnjelix". The server recognize automatically your real login with your ssh key.

So, in a command line, you type

svn checkout http://svn.jelix.org/jelix/trunk

ou

svn checkout svn+ssh://svnjelix@svn.jelix.org/jelix/trunk