![]() |
Débutants - installer les sources | ![]() |
Vous n'avez jamais installé un logiciel à
partir des sources ? Lancez-vous avec TeXmacs.
Si plusieurs personnes travaillent en même temps à développer un logiciel, il faut que chacun dispose sur son disque dur des sources du logiciel, et quand chacun les modifie, il doit synchroniser ses sources modifiées avec les sources originales qui se trouvent sur un serveur. On utilise pour cela un logiciel de gestion de versions. Subversion (en abrégé SVN) est un tel logiciel. Il est développé par la fondation Apache.
SVN est un logiciel fait pour gérer facilement le
développement d'un programme fait entre plusieurs personnes (et
même une seule). Il travaille sur une logique client/serveur. Il
y a le serveur SVN où se trouvent tous les fichiers sources et
il y a ton poste de travail, dans lequel tu dois installer un client
SVN et qui fera la copie du projet qui se trouve dans le serveur SVN
(c'est ce qu'on appelle un checkout, copie initiale des fichiers, en
abrégé co
). Quand tu modifieras des
fichiers, il faudra envoyer les modifications au serveur SVN
grâce à un commit
, tu peux ajouter des
commentaires pour expliquer ce que tu as fait par exemple, tout est
sauvegardé sur le serveur.
Ça permet de développer un truc en gardant une trace de
toutes les modifications, et en permettant par exemple de gérer
les conflits lorsque deux personnes modifient en même temps le
même fichier (pour que l'un n'écrase pas le travail de
l'autre), tout ça grâce au versioning (chaque fichier
à chaque modification a une version différente). Disons
qu'un fichier X a la version 10, tu le modifie et tu commites, il aura
la version 11 sur le serveur. Deux personnes récupèrent
(commande update de svn) et modifient la version 11, la
première personne qui le modifie et qui commite la modification
(commiter envoyer la modification au serveur
SVN qui centralise tout), n'aura pas de problème, la version du
fichier X sur le serveur SVN sera maintenant 12. Mais la
deuxième personne voudra commiter des modifications à la
version 11, elle aura un conflit à régler car elle ne
modifie pas la dernière version présente sur le serveur
SVN, c'est à dire la 12.
Deux lectures rapides:
Qu'est-ce que c'est qu'un logiciel de gestion de versions. L'exemple de Subversion.
Les sources sont un ensemble de fichiers contenant toutes les lignes de code du programme. Tu les télécharges, tu les installes en suivant la procédure qui suit. Mais elles ne permettent pas directement de lancer le programme. Pour cela, il faut faire ce que l'on appelle une compilation. La compilation prend les sources (mais ne les modifie pas), et crée à partir d'elles un exécutables (une « application »).
Donc : tu télécharges les sources, tu les modifies comme tu veux, tu les compiles pour pouvoir les utiliser sur ton ordinateur, et en parallèle tu les « commites » pour que le logiciel officiel soit mis à jour avec tes modifications. Compiler et « commiter » sont deux actions indépendantes. Tu peux aussi compiler et mettre à disposition de tous l'exécutable obtenu. C'est ainsi que sur le site texmacs.org tu peux régulièrement mettre à jour l'application texmacs.app.
Quand on installe les sources, il faut indiquer au programme utilisé dans quel dossier on veut placer les sources, et dans quel dossier on veut placer le résultat des complications que l'on fera à partir des sources.
Ce paragraphe concerne uniquement mac os X.
Sous mac os X, le logiciel Xcode semble incontournable.
Choisir un dossier sur le disque dur où l'on mettra les sources. Par exemple ~/Sources est idéal. Mais on peut choisir n'importe quel autre dossier. Attention toutefois : veiller à ce que dans le path (=chacun des sous dossiers successifs depuis la racine du disque dur), il n'y ait pas de caractères ésotériques : espaces, astérisques etc.
Installer QT. QT (rien à voir avec Quicktime de Apple) est un système d'interface utilisateur développé par la compagnie nordique Nokia. Les nouvelles versions de TeXmacs s'appuient sur QT.
Télécharger QT (le premier lien : Cocoa, 64bit, libs and dev tools), c'est 178 MB, il s'installe tout seul, laisser faire.
Dans ~/Sources, télécharger les librairies suivantes, dans cet ordre :
libgmp (télécharger le .bz2)
Readline (premier lien indiqué
"ftp.cwru.edu")
Guile (installer guile 1.8.8 ; pas 2.0, c'est pas compatible)
Ghostscript (second lien, celui en bz2)
Ce sont des programmes annexes, dont TeXmacs aura besoin. Tous doivent être compilés pour que TeXmacs puisse faire appel à eux. Pour cela, pour chacun des dossiers décompressés précédents, faire, dans le terminal :
cd
[path du dossier concerné obtenu en faisant
glisser ce dossier dans la fenêtre du terminal]
exemple cd ~/Sources/gmp-5.0.4
./configure –prefix=/usr/local
L'instruction –prefix=/usr/local permet d'indiquer à l'ordinateur qu'il faudra mettre les librairies compilées (=les exécutables obtenus) toutes dans le même dossier (sinon ça devient vite le bordel).
make -jN
Remplace N par le nombre de processeurs que tu as: make
-j2
si c'est un intel core 2 par exemple
sudo make install
le sudo c'est parce que les choses compilées sont envoyées dans /usr/local qui nécessite des autorisations.
Attention ! à la fin de readline...
faire en plus (et avant d'installer Guile, donc) :
sudo ln -f -s /usr/local/lib/libreadline.6.2.dylib
/usr/lib/libreadline.dylib
Explications si l'on veut :
La librairie /usr/lib/libreadline.dylib n'est qu'un lien vers
libedit.3.dylib, qui est la vraie librairie du MacOS. Avec ls -l
/usr/lib/libreadline*
, on voit en effet ça: lrwxr-xr-x 1
root wheel 15 Jul 22 2011 /usr/lib/libreadline.dylib ->
libedit.3.dylib. Alors le truc est simple : on refait le lien pour
qu'il pointe vers la nouvelle librairie. L'effet de l'instruction
donnée est donc de remplacer le lien dont on parlait ci-dessus
par un lien vers ton nouveau truc (ln
fait des liens vers
des fichiers, -s toto titi
fait pointer titi vers toto,
-f
veut dire "forcer" parce qu'il y a
déjà un lien en place)
On pourra aussi avoir besoin plus tard de ce qu'indique la page installer les sources, à savoir : Aspell, Libiconv, Netpbm and ImageMagick mais si on débute mieux vaut attendre un peu, tout marche plus ou moins bien sans ça.
Faire un check out des fichiers source de texmacs. Checkout (en
abrégé co
) veut dire :
télécharger entièrement les sources de la toute
dernière version. Il faut ne faire ça qu'une fois, la
première fois qu'on installe.
cd ~/Sources
(ou cd
[path des sources]
si l'on a décidé de mettre ce dossier ailleurs)
ensuite, au choix :
svn co svn://svn.savannah.gnu.org/texmacs/trunk
ou bien, si tu as les accès "d'écriture" (c'est à dire le permis de Joris) pour envoyer tes changements directement au serveur :
svn co
svn+ssh://tonnomici@svn.savannah.gnu.org/texmacs/trunk
Explication du /trunk : Les fichiers sources d'un logiciels contiennent trois dossier à la racine : trunk, branches, et tag. Les deux dernier servent à archiver toutes les sources successives obtenues par modifications des uns et des autres. C'est très lourd à télécharger, et nécessaire que si l'on plonge vraiment dans le code.
Le résultat de cette opération : un dossier ~/Sources/texmacs/trunk/ contenant "web" (image du site internet www.texmacs.org), "src" (les sources elles-mêmes) et "misc" (des trucs divers).
Si tu as accès d'écriture, il faut configurer tes clés ssh.
cd
[fais glisser ici le dossier trunk/src des sources
de TeXmacs].
./configure –with-qt=/usr/local/Qt4.8
–disable-macosx-extensions
Comme vu précédemment, cette instruction sert juste à faire quelques réglages avant de passer à l'action. Tu verras plein de trucs: le système essaie de trouver toutes les librairies dont il a besoin pour compiler TM.
Lorsque tu auras besoin de te mettre à jour par rapport aux sources du serveur (que d'autres utilisateurs éventuels auront modifiées), par exemple avant de faire de nouveaux changements ou pour voir les derniers changements dans le code et les compiler, alors il faut faire :
cd
[fais glisser ici le dossier trunk des sources de
TeXmacs].
svn update
Des trucs défileront: c'est sont les changements depuis la dernière fois que tu as téléchargé, c'est à dire depuis que tu as fait "svn co svn://blabla" pout la première et seule fois, ou depuis que tu as fait "svn update" la dernière fois.
Faire commit
veut dire envoyer tes changements. Pour
ça il te faut l'accès d'écriture (tu as
déjà tout configuré plus haut).
cd
[fais glisser ici le dossier trunk des sources de
TeXmacs].
svn status
si tu as créé un fichier toto.tm dans les sources,
cette instruction status va le détecter et afficher quelque
chose du style : ? ă ă ă toto.tm
Ça veut dire que ce fichier n'est pas géré par svn. Il faut l'ajouter:
svn add toto.tm
svn commit -m "Un message court en expliquant tes
changements" toto.tm
Résumé :
Chaque fichier que tu crées doit être ajouté
(svn add nomdefichier
) puis envoyé au serveur
(svn commit -m "message" nomdefichier
). Un
fichier qui était déjà là n'a pas besoin
d'être ajouté encore une fois par l'instruction
add
: le commit
suffit.
Pour compiler l'application TeXmacs à partir des sources, utilise XCode "Build->Build and run" ou le raccourci Pomme+R. [Une commande make bundle existe aussi]
This webpage is part of GNU TeXmacs and the larger GNU project. Verbatim copying and distribution of it is
permitted in any medium, provided this notice is preserved. For
more information or questions, please contact Joris van
der Hoeven.
Free Software Foundation, Inc., 59 Temple Place -
Suite 330, Boston, MA 02111, USA