Ticket #285: README.fr

File README.fr, 4.6 KB (added by ports@…, 21 years ago)

Revision of the french DP-README file

Line 
1QU'EST-CE QUE DARWINPORTS
2
3        DarwinPorts est une infrastructure permettant de compiler, d'installer et d'empacter un logiciel, similaire en termes de fonctionnalités à l'architecture des ports FreeBSD afin de maintenir une extensibilité future.
4
5        DarwinPorts fonctionne et permet de compiler sur MacOS X 10.2 (Darwin 6.0). Le système est portable, est écrit en TCL avec un set limité d'extensions TCL en C.
6
7        Pour une documentation plus appronfondie sur l'architecture interne de ce système de ports, reportez-vous au fichier /base/docs/INTERNALS.
8
9        Notez svp que l'architecture de DarwinPorts est composé de deux parties. "L'infrastructure de DarwinPorts", qui réside dans le sous-répertoire base/ est le seul composant obligatoire du système, et le répertoire "dports" qui contient la description des logiciels supportés. Le dernier composant peut être optionnel et peut être récupéré sur  le net ou une copie locale peut également être utilisée. Reportez-vous à la documentation sur /etc/ports/sources.conf ci-dessous.
10
11INSTALLATION
12
13    Étapes de l'installation :
14        1. make
15                Lancez 'make' pour compiler tout ce qui est nécessaire.
16
17        2. sudo make install
18                Lancez 'sudo make install' pour installer les ports darwin
19                sur votre système.
20
21        3. [optionnel] éditez /etc/ports/ports.conf
22                le fichier de conf "/etc/ports/ports.conf"
23                définit la majeure partie des options de configuration de
24                l'infrastructure de DarwinPorts si vous desirez changer les
25                chemins et emplacements ou sonts stockés les données,
26                changez les options suivantes:
27
28                portdbpath - Spécifie la base où stocker les données
29                spécifiques au système de ports.
30
31                prefix - Indique la base dans laquelle installer les ports
32
33        3. éditez /etc/ports/sources.conf
34                Le fichier /etc/ports/sources.conf liste l'emplacement des
35                hiérarchies des ports locale et distante. Assurez-vous bien
36                d'ajouter une entrée pour votre hiérarchie locale des ports
37                (normalement le répertoire darwinports/dports)
38
39    Tout le code TCL nécessaire sera compilé et installé comme indiqué ci-
40    dessous:
41        [Mac OS X] /System/Library/Tcl/8.3/darwinports1.0
42        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
43                - Librairie TCL permettant d'interagir avec le système de
44                DarwinPorts
45
46        PREFIX est situé par défaut à /opt/local mais ce choix peut être
47        outrepassé via la commande make.
48        Ligne affectant l'installant les composants suivants :
49
50        $PREFIX/bin/port
51                - Utilitaire cli pour la compilation de port
52        $PREFIX/share/darwinports/
53                - Librairies TCL internes du système de ports
54
55        Les fichiers suivants sont fournis en vue de la personnalisation du
56        système :
57
58        /etc/defaults/ports.conf
59            - Réglages par défaut des ports pour tout le système
60        /etc/ports/ports.conf
61            - Réglages personnels des ports pour l'utilisateur
62        /etc/ports/sources.conf
63            - Liste des sources pour les ports (endroit où récupérer les
64              données des ports)
65
66
67UTILISATION DE LA COMMANDE 'PORT'
68
69    Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable path (ou $PREFIX/bin si vous avez choisi d'installer DarwinPorts dans un autre emplacement). Si vous ne savez pas comment faire, ajoutez la ligne suivante dans votre fichier ~/.cshrc.
70
71        set path=($path /opt/local/bin)
72
73    Vos changements dans ~/.cshrc ne seront pris en compte que lorsque vous ouvrirez un nouveau shell.
74
75    La commande suivante construira et installera le port :
76
77        port install <nom_du_port>
78
79    Pour rechercher un port spécifique, essayez d'utiliser "port search" :
80
81        port search vi
82
83    Référez-vous à la page man de "port" pour une documentation plus
84    complète sur cette commande.
85
86    Il est également possible d'effectuer des opérations, comme construire
87    ou récupérer tous les ports du système en utilisant la commande
88    "portall". Elle prend les mêmes arguments essentiels que la commande
89    "port" mais opère de façon interactive sur chaque port dans dports/.
90    Lorsque vous effectuez un "make clean" depuis ce répertoire, par
91    exemple, un "portall clean" est également invoqué pour nettoyer
92    complètement.
93
94CRÉER DE NOUVEAUX PORTS
95
96    Un port consiste en un répertoire contenant un fichier Portfile et ses fichiers associés. Actuellement les seuls fichiers livrés avec un port sont les patchs, et sont au minimum censés être gardés.
97
98    Un fichier Portfile consiste en un code TCL valide, évalué par un interpréteur du système DarwinPorts. Les fichiers Portfiles utilisent une syntaxe très stricte composée de paires de type clé/valeur, permettant d'autoriser à l'auteur l'utilisation complète des fonctionnalités offertes par TCL lorsque cela lui est nécessaire.
99
100    Pour commencer reportez-vous au fichier doc/exampleport et la page man de portfile(7).