Skip to content

Commit da643d5

Browse files
humboldtuxhumboldtux
committed
Start French translation
1 parent cd7470c commit da643d5

30 files changed

+995
-0
lines changed

‎fr/01.0.md

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# 1 Configuration de votre environnement de développement Go
2+
3+
Bienvenue dans le monde de Go, commençons notre exploration!
4+
5+
Go est un langage de progammation système concurrent à la compilation rapide et disposant d'un rammasse-miettes.
6+
Il a les avantages suivants:
7+
8+
- Compilation d'un large projet en quelques secondes.
9+
- Fournit un modèle de développement facile à gérer, évitant la plupart des problèmes liés aux fichiers d'en-tête C.
10+
- C'est un langage statique avec un système de types de données simple, afin que les utilisateurs n'aient pas à perdre du temps à gérer
11+
les relations entre types. Il peut-être vu comme un langage orienté-objet simplifié.
12+
- Il possède un ramasse-miettes. Il fournit un support de base pour la concurrence et de la communication.
13+
- Conçu pour les ordinateurs multi-core.
14+
15+
Go est un langage compilé. Il combine l'efficacité de développement des langages interprétés ou dynamiques avec la sécurité de langues statiques.
16+
Il va être la langue de choix pour les ordinateurs modernes multi-core inter-connectés. À ces fins, il ya quelques problèmes qui
17+
doivent fondamentalement être résolu au niveau de ce langage, comme un système de types très expressif et léger, un modèle de concurrence natif,
18+
et un ramasse-miettes géré strictement. Durant longtemps, aucun paquet ou outil n'est apparu qui avait pour but de résoudre tous ces problèmes
19+
de façon pragmatique; ainsi naquit la motivation pour du langage Go.
20+
21+
Dans ce chapitre, je vais vous montrer comment installer et configurer votre propre environnement de développement Go.
22+
23+
## Table des matières
24+
25+
![](images/navi1.png?raw=true)
26+
27+
## Navigation
28+
29+
- [Table des matières](preface.md)
30+
- Section suivante: [Installation](01.1.md)

‎fr/01.1.md

+148
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
# 1.1 Installation
2+
3+
## 3 méthodes d'installation
4+
5+
Il y a plusieurs façons de configurer votre environnement de développement Go sur votre ordinateur,
6+
vous pouvez choisir celle qui vous convient le mieux. Les trois façons les plus courantes sont les suivantes.
7+
8+
- Paquets d'installation officiels:
9+
- L'équipe de Go propose des paquets d'installation pour Windows, Linux, Mac et encore d'autres systèmes d'exploitation.
10+
C'est propablement la méthode la plus simple pour commencer.
11+
- Installation manuelle via les sources
12+
- Populaire chez les développeurs habitués aux environnements type Unix.
13+
- Utilisation d'outils tiers.
14+
- Il y a plusieurs outils tiers et gestionnaires pour installer Go, comme apt-get pour Ubuntu et homebrew pour Mac.
15+
16+
Dans le cas où vous voudriez installer plus d'une version de Go sur votre machine, vous devriez jeter un oeil à l'outil [GVM](https://github.com/moovweb/gvm).
17+
C'est le meilleur outil pour accomplir cette tâche, sinon vous devrez le faire vous-même.
18+
19+
##Installation à partir des sources
20+
21+
Parce-que certaines parties de Go sont écrits en C Plan 9 et en assembleur AT&T, vous devez installer un compilateur C avant de continuer.
22+
23+
Sous Mac, si vous avez Xcode d'installé, vous disposé déjà d'un compilateur.
24+
25+
Sur un système type Unix, vous devez installer gcc ou un compilateur équivalent. Par exemple, en utilisant le gestionnaire de paquets apt-get(livré avec Ubuntu),
26+
vous pouvez installer les compilateurs requis comme suit:
27+
28+
`sudo apt-get install gcc libc6-dev`
29+
30+
Sous Windows, vous devez installer MinGW pour installer gcc. N'oubliez pas de configurer vos varaibles d'environnement après avoir finalisé l'installation.
31+
32+
L'équipe Go utilise [Mercurial](http://mercurial.selenic.com/downloads/) pour gérer le code source, vous devez commencer par installer celui-ci pour
33+
télécharger le code source de Go.
34+
35+
Une fois Mercurial installé, exécutez les commandes suivantes pour cloner le code source de Go et le compiler:
36+
37+
hg clone -u release https://code.google.com/p/go
38+
cd go/src
39+
./all.bash
40+
41+
Une installation réussie finira en affichant le message "ALL TESTS PASSED."
42+
43+
Sous Windows, vous pouvez arriver à faire la même chose en lançant `all.bat`.
44+
45+
Si vous utilisez Windows, le paquet d'installation va mettre à jour automatiquement vos variables d'environnement.
46+
Sous Unix, vous devez configurer celles-ci manuellement comme suit:
47+
48+
export GOROOT=$HOME/go
49+
export GOBIN=$GOROOT/bin
50+
export PATH=$PATH:$GOROOT/bin
51+
52+
Si vous voyez l'affichage suivant sur votre écran, l'installation s'est terminée avec succès.
53+
54+
![](images/1.1.mac.png?raw=true)
55+
56+
Figure 1.1 Information après installation
57+
58+
Lorsque vous voyez les informations d'utilisation de Go, cela signifie que vous avez installé Go avec succès sur votre ordinateur.
59+
Si votre système affiche 'aucune commande Go', vérifiez que votre variable d'environnement $PATH contient bien le chemin d'installation de Go.
60+
61+
## Utilisation des paquets standards d'installation
62+
63+
Go a des paquets d'installation rapides pour chaque système d'exploitation supporté.
64+
Ces paquets installent Go dans `/usr/local/go` (`c:\Go` sous Windows) par défaut. Bien sûr, cela est configurable, mais vous aurez également à changer manuellement
65+
les variables d'environnement comme décrit précédemment.
66+
67+
### Comme savoir si votre système est 32 ou 64 bits?
68+
69+
L'étape suivante dépend du type d'architecture de votre système, nous devons donc le vérifier avant de télécharger les paquets d'installation.
70+
71+
Si vous utilisez Windows , tapez `Win+R` et lancez l'outil de commandes `cmd`.
72+
Lancez la commande `systeminfo` qui va vous afficher des informations très utiles sur votre système.
73+
Trouvez la ligne indiquant "type du système" - si vous voyez "x64-based PC" cela signifie que votre système est 64-bit, sinon il est 32-bit.
74+
75+
Je vous recommande fortement de télécharger le paquet 64-bit si vous êtes sous Mac, comme Go ne supporte plus les processeurs 32-bit sous Mac OSX.
76+
77+
Les utilisateurs Linux peuvent exécuter `uname -a` dans un terminal pour afficher les informations système.
78+
Un système d'exploitation 64-bit affichera les informations suivantes:
79+
80+
<descriptions diverses> x86_64 x86_64 x86_64 GNU/Linux
81+
82+
Certaines machines comme Ubuntu 10.04 afficheront simplement:
83+
84+
x86_64 GNU/Linux
85+
86+
Les systèmes 32-bit afficheront quant à eux:
87+
88+
<descriptions diverses> i686 i686 i386 GNU/Linux
89+
90+
### Mac
91+
92+
Aller sur la [page de téléchargement][downlink], choisir `go1.4.darwin-386.pkg` pour le systèmes 32-bit
93+
et `go1.4.darwin-amd64.pkg` pour les 64-bit. Cliquez "next" jusqu'à la fin du processus, `~/go/bin` sera ajouté au $PATH du système à la fin de l'installation.
94+
Maintenant ouvrez un terminal et tapez `go`. Vous devriez avoir la même sortie qu'en figure 1.1.
95+
96+
### Linux
97+
98+
Aller à la [page de téléchargement][downlink], choisir `go1.4.linux-386.tar.gz` pour les systèmes 32-bit et
99+
`go1.4.linux-amd64.tar.gz` en 64-bit. Supposons que vous voulez installer Go dans `$GO_INSTALL_DIR` path.
100+
Décompressez l'archive `tar.gz` dans le dossier désiré de destination en utilisant la commande `tar zxvf go1.4.linux-amd64.tar.gz -C $GO_INSTALL_DIR`.
101+
Ensuite définissez votre $PATH avec: `export PATH=$PATH:$GO_INSTALL_DIR/go/bin`.
102+
Vous pouvez maintenant ouvrir un terminal et tapez `go`. Vous devriez avoir la même sortie qu'en figure 1.1.
103+
104+
### Windows
105+
106+
Allez à la [page de téléchargement][downlink], choisissez `go1.4.windows-386.msi` pour les systèmes 32-bit et
107+
`go1.4.windows-amd64.msi` pour le ssystèmes 64-bit. Cliquez "next" jusqu'à la fin du processus, `c:/go/bin` sera ajhouté à `path`.
108+
Vous pouvez maintenant ouvrir un terminal et tapez `go`. Vous devriez avoir la même sortie qu'en figure 1.1.
109+
110+
## Utilisez des outils tiers
111+
112+
### GVM
113+
114+
GVM est un outil de gestion de versions multiples développé par un tiers, comme rvm pour ruby.
115+
Il est simple d'utilisation. Installez GVM avec les commandes suivantes dans votre terminal:
116+
117+
bash < <(curl -s https://raw.github.com/moovweb/gvm/master/binscripts/gvm-installer)
118+
119+
Ensuite nous installons Go avec les commandes suivantes:
120+
121+
gvm install go1.4
122+
gvm use go1.4
123+
124+
À la fin du processus, Go est installé.
125+
126+
### apt-get
127+
128+
Ubuntu est la version bureau la plus utilisée de Linux. Elle utilise `apt-get` comme gestionnaire de paquets.
129+
On peut installer Go avec les commandes suivantes:
130+
131+
sudo add-apt-repository ppa:gophers/go
132+
sudo apt-get update
133+
sudo apt-get install golang-stable
134+
135+
### Homebrew
136+
137+
Homebrew est un outil de gestion de logiciels communément utilisé sous Mac pour gérer les paquets.
138+
On peut installer Go avec les commandes suivantes:
139+
140+
brew install go
141+
142+
## Navigation
143+
144+
- [Tables des matières](preface.md)
145+
- Section précédente: [Configuration de votre environnement Go](01.0.md)
146+
- Section suivante: [$GOPATH et workspace](01.2.md)
147+
148+
[downlink]: http://golang.org/dl/ "Téléchargement de Go"

‎fr/01.2.md

+181
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,181 @@
1+
#1.2 $GOPATH et workspace
2+
3+
## $GOPATH
4+
5+
Les commandes Go reposent sur une variable d'environnement nommée $GOPATH<sup>1</sup>. Notez que ce n'est pas la variable $GOROOT où Go est installé.
6+
Cette variable pointe vers votre espace de travail(workspace) Go de votre ordinateur (J'utilise ce chemin sur mon ordinateur; si vous n'utilisez pas
7+
la même structure de dossiers, veillez à le faire correspondre par vous-même).
8+
9+
Dans un système de type Unix, la variable peut-être configurée comme suit:
10+
11+
export GOPATH=/home/apple/mygo
12+
13+
Pour plus de commodité, vous devriez ajouter une ligne à votre .bashrc ou .zshrc, ou tout autre fichier de configuration de configuration du shell approprié.
14+
15+
Sous Windows, vous devez créer une variable d'environnement nommée GOPATH, et définir sa valeur à `c:\mygo`:
16+
17+
GOPATH=c:\mygo
18+
19+
Il est possible d'avoir plusieurs répertoires dans votre $GOPATH, à séparer par un `:` sous Unix, et `;` sous Windows
20+
21+
Dans votre $GOPATH vous devez avoir trois sous-répertoires:
22+
23+
* `src` pour héberger le code source (par exemple: .go .c .h .s, etc.)
24+
* `pkg` pour les fichiers compilés (par exemple: .a)
25+
* `bin` pour les fichiers exécutable compilés
26+
27+
Dans le reste de ce livre, j'utilise le dossier `Mygo` comme répertoire de mon $GOPATH.
28+
29+
## Dossier de paquets
30+
31+
Créez les fichiers et dossiers d'un paquet source comme `$GOPATH/src/mymath/sqrt.go` (`mymath` est le nom du paquet)
32+
33+
Chaque fois que vous créez un paquet, vous devriez créer un nouveau dossier dans le répertoire `src`.
34+
Les noms de dossiers correspondent généralement à celui du paquet que vous souhaitez utiliser.
35+
Vous pouvez avoir plusieurs niveaux de dossiers si vous le désirez.
36+
Par exemple si vous créez le dossier `$GOPATH/src/github.com/astaxie/beedb`, alors le chemin du paquet sera `github.com/astaxie/beedb`.
37+
Le nom du paquet sera celui du dernier dossier de votre chemin, qui est `beedb` dans notre exemple.
38+
39+
Exécutez les commandes suivantes:
40+
41+
cd $GOPATH/src
42+
mkdir mymath
43+
44+
Créez un nouveau fichier `sqrt.go`, ajoutez le contenu suivant à celui-ci:
45+
46+
// Code source de $GOPATH/src/mymath/sqrt.go
47+
package mymath
48+
49+
func Sqrt(x float64) float64 {
50+
z := 0.0
51+
for i := 0; i < 1000; i++ {
52+
z -= (z*z - x) / (2 * x)
53+
}
54+
return z
55+
}
56+
57+
Maintenant le dossier de mon paquet a été créé et son code écrit. Je vous recommande d'utiliser le même nom pour vos paquets et leurs dossiers,
58+
et que les dossiers contiennent tous les fichiers sources du paquet.
59+
60+
## Compilation des paquets
61+
62+
Nous avons créé notre paquet précédemment, mais comment le compiler pour un usage concret? Il y a deux méthodes différentes.
63+
64+
1. Placez-vous dans le dossier contenant votre paquet, puis exécutez la commande `go install`.
65+
2. Exécutez la commande précédente mais en passant un nom de fichier en paramètre, comme `go install mymath`.
66+
67+
Après compilation, on peut ouvrir le dossier suivant:
68+
69+
cd $GOPATH/pkg/${GOOS}_${GOARCH}
70+
// On peut y trouver le fichier compilé
71+
mymath.a
72+
73+
Le fichier dont le suffixe est `.a` est le fichier binaire de notre paquet. Comment l'utiliser?
74+
75+
Assurément, nous devons créer une application pour l'utiliser.
76+
77+
Créez un nouveau paquet appelé `mathapp`.
78+
79+
cd $GOPATH/src
80+
mkdir mathapp
81+
cd mathapp
82+
vim main.go
83+
84+
Le code de `main.go`
85+
86+
//code source de $GOPATH/src/mathapp/main.go.
87+
package main
88+
89+
import (
90+
"mymath"
91+
"fmt"
92+
)
93+
94+
func main() {
95+
fmt.Printf("Hello, world. Sqrt(2) = %v\n", mymath.Sqrt(2))
96+
}
97+
98+
Pour compiler cette application, vous devez vous placer dans le dossier du paquet
99+
100+
cd $GOPATH/src/mathapp
101+
102+
puis exécutez
103+
104+
go install
105+
106+
Vous devriez désormais voir un fichier exécutable `mathapp` généré dans le dossier `$GOPATH/bin/`.
107+
Pour lancer ce programme, utilisez la commande
108+
109+
./mathapp
110+
111+
Vous devriez voir le contenu suivant dans votre temrinal:
112+
113+
Hello world. Sqrt(2) = 1.414213562373095
114+
115+
## Installer des paquets distants
116+
117+
Go a un outil pour installer des paquets distants, qui est l'outil `go get`.Il supporte la majorité des communautés libres, comme
118+
Github, Google Code, BitBucket, et Launchpad.
119+
120+
go get github.com/astaxie/beedb
121+
122+
>Vous pouvez utiliser `go get -u` pour mettre à jour vos paquets distants, cela mettra aussi à jour les dépendances.
123+
124+
Vous obtiendrez le code source des paquets désirés grâce à cette commande, depuis différentes plate-formes, utilisant chacune leur système de gestion de version.
125+
Par exemple, `git` pour Github et `hg` pour Google Code. Ainsi vous devrez au préalable installer le client du système de gestion de version approprié
126+
avant d'utiliser`go get`.
127+
128+
Après avoir utilisé les commandes précédentes, votre structure de dossier devrait ressembler à celle-ci:
129+
130+
$GOPATH
131+
src
132+
|-github.com
133+
|-astaxie
134+
|-beedb
135+
pkg
136+
|--${GOOS}_${GOARCH}
137+
|-github.com
138+
|-astaxie
139+
|-beedb.a
140+
141+
En fait, `go get` clone le source code dans le dossier $GOPATH/src en local, puis exécute `go install`.
142+
143+
Vous pouvez utiliser des paquets distants de manière similaire aux paquets locaux.
144+
145+
import "github.com/astaxie/beedb"
146+
147+
## Arborescence complète de dossier
148+
149+
Si vous avez suivi toutes les étapes précédentes, la structure de votre dossier ressemble désormais à ceci:
150+
151+
bin/
152+
mathapp
153+
pkg/
154+
${GOOS}_${GOARCH}, such as darwin_amd64, linux_amd64
155+
mymath.a
156+
github.com/
157+
astaxie/
158+
beedb.a
159+
src/
160+
mathapp
161+
main.go
162+
mymath/
163+
sqrt.go
164+
github.com/
165+
astaxie/
166+
beedb/
167+
beedb.go
168+
util.go
169+
170+
Vous pouvez désormais vous rendre compte de manière plus claire de l'arborescence; `bin` contient les exécutables, `pkg` les fichiers compilés et
171+
`src` les paquets sources.
172+
173+
- - -
174+
[1] Le format des variables d'environnement sous Windows est `%GOPATH%`, pourtant ce livre suit principalement la norme Unix,
175+
les utilisateurs Windows devront faire les modifications appropriées.
176+
177+
## Navigation
178+
179+
- [Table des matières](preface.md)
180+
- Section précédente: [Installation](01.1.md)
181+
- Section suivante: [Go commands](01.3.md)

0 commit comments

Comments
 (0)