Ticket #285: README-FR

File README-FR, 5.2 KB (added by ports@…, 22 years ago)

Darwinports's README-FR file

Line 
1QU'EST-CE QUE LES PORTS DARWIN
2
3        Les ports Darwin est une infrastructure permettant de compiler, d'installer et d'empacter un logiciel, similaire en termes de fonctionnalités que l'architecture des ports FreeBSD afin de maintenir l'extensibilité future.
4
5        Les ports Darwin fonctionnent et permettent 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'architectture interne de ce système de ports, reportez-vous au fichier /base/docs/INTERNALS.
8
9        Notez svp que l'architecture des ports darwin est composé de deux parties. "L'infrastructure des ports darwin", qui réside dans le sous-répertoire base/ qui 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 demande par la biais du 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 sur votre système.
19
20        3. [optionnel] éditez /etc/ports/ports.conf
21                Le fichier de configuration /etc.ports/ports.conf utilise
22                les mêmes directives qu'un fichier Portfile, et peut être
23                utilisé pour outrepasser toutes les options par défaut des
24                ports. Vous pouvez si vous le souhaitez activer les options
25                de "verbosité" et de déboguage dans ce fichier, la liste
26                des options disponibles est la suivante :
27
28                portdbpath - Spécifie l'emplacement où stocker les données spécifiques au système de ports.
29
30                ports_debug - Accepte "yes"[oui] ou "non"[non] comme valeur.
31                            Si utilisée, les messages de déboguage seront affichés.
32
33                port_verbose - Accepte "yes"[oui] ou "non"[non] comme valeur.
34                             Si utilisée, les messages d'informations seront affichés.
35
36        3. [optionnel] éditez /etc/ports/sources.conf
37                Le fichier /etc/ports/sources.conf liste l'emplacement des
38                hiérarchies des ports locale et distante. Par défaut, la
39                recherche s'effectuera dans votre répertoire relatif actuel
40                donc assurez-vous que vous êtes au premier niveau du
41                répertoire (darwinports) ou bien assurez-vous d'ajouter une
42                entrée pour votre hiérarchie locale des ports (normalement
43                le répertoire darwinports/dports)
44
45    Tout le code TCL nécessaire sera compilé et installé comme indiqué ci-
46    dessous:
47        [Mac OS X] /System/Library/Tcl/8.3/darwinports1.0
48        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
49             - Librairie TCL permettant d'interagir avec le Système de                 Ports Darwin
50
51        PREFIX est situé par défaut à /opt/local mais ce choix peut être outrepassé via la commande make
52        Ligne affectant l'installant les composants suivants :
53
54        $PREFIX/bin/port
55                - Utilitaire cli pour la construction du port
56        $PREFIX/share/darwinports/
57                - Librairies TCL internes du système de ports
58
59        Les fichiers suivants sont fournis en vue de la personnalisation du
60        système:
61
62        /etc/defaults/ports.conf
63            - Réglages par défaut des ports pour tout le système
64        /etc/ports/ports.conf
65            - Réglages personnels des ports pour l'utilisateur
66        /etc/ports/sources.conf
67            - Liste des sources pour les ports (endroit où récupérer les
68              données des ports)
69
70
71UTILISATION DE LA COMMANDE PORT
72
73    Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable path (ou $PREFIX/bin si vous avez choisi d'installer les ports darwin autre-part). Si vous ne savez pas comment faire, ajoutez la ligne suivante dans votre fichier ~/.cshrc.
74
75        set path=($path /opt/local/bin)
76
77    Vos changements dans ~/cshrc ne seront pris en compte que lorsque vous ouvrirez un nouveau shell.
78
79    Pour mettre à jour vos index locaux, lancez la commande :
80
81        port sync
82
83    La commande suivante construira et installera le port :
84
85        port install <nom_du_port>
86
87    Pour rechercher un port spécifique, essayez d'utiliser "port search" :
88
89        port search vi
90
91    Réferrez-vous à la page man de "port" pour une documentation plus
92    complète sur cette commande.
93
94    Il est également possible d'effectuer des opérations, comme construire
95    ou récupérer, tous les ports du système en utilisant la commande
96    "portall". Elle prend les mêmes arguments essentiels que la commande
97    port mais opère de façon interactive sur chaque port dans dports/.
98    Lorsque vous effectuez un "make clean" depuis ce répertoire, par
99    exemple, un "portall clean" est également invoqué pour nettoyer
100    complètement.
101
102CRÉER DE NOUVEAUX PORTS
103
104    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.
105
106    Un fichier Portfile consiste en un code TCL valide, évalué par un interpréteur du Système de Ports Darwin. Les fichiers Portfiles utilisent une syntaxe très stricte composée de paire de type clé/valeur, permettant d'autoriser l'auteur d'utiliser à fond les fonctionnalités offertes par TCL lorsque cela lui est nécessaire.
107
108    Pour commencer reportez-vous au fichier doc/exampleport et la page man de portfile(7).