source: trunk/README.fr @ 4439

Last change on this file since 4439 was 4439, checked in by fkr, 16 years ago

Bug:
Submitted by:
Reviewed by:
Approved by:
Obtained from:

updated french README from matt@, that includes the note about README.platforms

  • Property svn:eol-style set to native
File size: 5.7 KB
Line 
1QU'EST-CE QUE DARWINPORTS
2
3        DarwinPorts est une infrastructure permettant de compiler,
4        d'installer et d'empaqueter un logiciel, similaire en termes de
5        fonctionnalités à l'architecture des ports FreeBSD afin de
6        maintenir une extensibilité future.
7
8        DarwinPorts fonctionne et permet d'être compilé sur MacOS X 10.2
9        (Darwin 6.0) et MacOS X 10.3 (Darwin 7.0.0). Le système est
10        portable, et est écrit en TCL avec un set limité d'extensions TCL
11        en C.
12
13                Le "DarwinPorts User Guide" est disponible à :
14                http://www.opendarwin.org/projects/darwinports/guide/
15       
16        Pour une documentation plus appronfondie sur l'architecture
17        interne de ce système de ports, reportez-vous au fichier
18        base/docs/INTERNALS.
19
20        Notez svp que l'architecture de DarwinPorts est composé de deux
21        parties. "L'infrastructure de DarwinPorts", qui réside dans le
22        sous-répertoire base/ est le seul composant obligatoire du système,
23        et le répertoire "dports" qui contient la description des logiciels
24        portés. Le dernier composant peut être optionnel et peut être
25        récupéré sur le net ou une copie locale peut également être
26        utilisée.
27        Reportez-vous à la documentation sur /etc/ports/sources.conf
28        ci-dessous.
29
30INSTALLATION
31
32        Pour des instructions d'installation spécifiques à d'autres
33        plateformes, reportez-vous au fichier base/docs/README.platforms.
34
35    Étapes de l'installation :
36
37        1. cd base/
38           ./configure
39                Vous place dans le répertoire base/ et lance le script
40                configure. Des paramètres peuvent être passés au script
41                (cf. ci-dessous).
42
43        2. make
44                Lancez 'make' pour compiler tout ce qui est nécessaire.
45
46        3. sudo make install
47                Lancez 'sudo make install' pour installer DarwinPorts
48                sur votre système.
49
50        4. [optionnel] éditez /etc/ports/ports.conf
51                Le fichier de configuration "/etc/ports/ports.conf"
52                définit la majeure partie des options de configuration de
53                l'infrastructure de DarwinPorts si vous desirez changer les
54                chemins et emplacements ou sonts stockés les données,
55                changez les options suivantes :
56
57                portdbpath - Spécifie la base où stocker les données
58                spécifiques au système de ports.
59
60                prefix - Indique la base dans laquelle installer les ports
61
62        5. [optionnel] éditez /etc/ports/sources.conf
63                Le fichier /etc/ports/sources.conf liste l'emplacement des
64                hiérarchies des ports locales et distantes. Si l'argument
65                "--with-dports-dir=RÉP." n'a pas été utilisé lors du
66                lancement du script "./configure", la hiérarchie de dports
67                (darwinports/dports, depuis la copie que vous avez
68                installé) sera ajoutée au fichier "source.conf".
69
70    Tout le code TCL nécessaire sera compilé et installé comme indiqué ci-
71    dessous:
72        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
73        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
74        [FreeBSD]       /usr/local/lib/tcl8.3/darwinports1.0
75                        - Librairie TCL permettant d'interagir avec le
76                          système DarwinPorts.
77
78        PREFIX est situé par défaut à /opt/local mais ce choix peut être
79        modifié en changeant le répertoire  pour base/ et en lançeant
80        manuellement ./configure avec l'argument --prefix
81
82        $PREFIX/bin/port
83                - Utilitaire en mode texte pour la compilation de port
84        $PREFIX/share/darwinports/
85                - Librairies TCL internes du système de ports
86
87        Les fichiers suivants sont fournis en vue de la personnalisation
88        du système :
89
90        /etc/defaults/ports.conf
91            - Réglages par défaut des ports pour tout le système
92        /etc/ports/ports.conf
93            - Réglages personnels des ports pour les utilisateurs
94        /etc/ports/sources.conf
95            - Liste des sources pour les ports (endroit où récupérer les
96              données des ports)
97
98
99UTILISATION DE LA COMMANDE 'PORT'
100
101    Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable
102    path (ou $PREFIX/bin si vous avez choisi d'installer DarwinPorts dans
103    un autre emplacement). Si vous ne savez pas comment faire, ajoutez la
104    ligne suivante dans votre fichier ~/.cshrc (cela est valable si vous
105    utilisez tcsh sous Panther également).
106
107        set path=($path /opt/local/bin)
108
109    Si vous utilisez Panther (OSX 10.3), ajoutez la ligne suivante à votre
110    fichier ~/.profile (cela est valable si vous utilisez un shell de type
111    Bourne sous Jaguar également).
112
113        export PATH=$PATH:/opt/local/bin
114
115    Vos changements ne seront pris en compte que lorsque vous ouvrirez un
116    nouveau shell.
117
118    La commande suivante compilera et installera le port :
119
120        port install <nom_du_port>
121
122    Pour rechercher un port spécifique, essayez d'utiliser "port search" :
123
124        port search vi
125
126    Référez-vous à la page man de "port" pour une documentation plus
127    complète sur cette commande.
128
129    Il est également possible d'effectuer des opérations, comme compiler
130    ou récupérer tous les ports du système en utilisant la commande
131    "portall". Elle prend les mêmes arguments essentiels que la commande
132    "port" mais opère de façon interactive sur chaque port dans dports/.
133    Lorsque vous effectuez un "make clean" depuis ce répertoire, par
134    exemple, un "portall clean" est également invoqué pour nettoyer
135    complètement.
136
137CRÉER DE NOUVEAUX PORTS
138
139    Un port consiste en un répertoire contenant un fichier Portfile et ses
140    fichiers associés. Actuellement les seuls fichiers livrés avec un port
141    sont les patchs, et sont au minimum censés être gardés.
142
143    Un fichier Portfile consiste en un code TCL valide, évalué par un
144    interpréteur de DarwinPorts. Les fichiers Portfiles utilisent une
145    syntaxe très stricte composée de paires de type clé/valeur, permettant
146    d'autoriser à l'auteur l'utilisation complète des fonctionnalités
147    offertes par TCL lorsque cela lui est nécessaire.
148
149    Pour commencer reportez-vous au fichier base/doc/exampleport et la page
150    man de portfile(7).
Note: See TracBrowser for help on using the repository browser.