Différences entre versions de « Installer Hugo »
De Mi caja de notas
(6 versions intermédiaires par le même utilisateur non affichées) | |||
Ligne 3 : | Ligne 3 : | ||
Traduction en cours. [Seul le lien original fait référence](https://gohugo.io/tutorials/installing-on-mac/ "Permalien vers ") | Traduction en cours. [Seul le lien original fait référence](https://gohugo.io/tutorials/installing-on-mac/ "Permalien vers ") | ||
− | Ce tutoriel vise à être un guide complet pour installer Hugo sur votre ordinateur Mac. | + | Ce tutoriel vise à être un guide complet pour installer [[Hugo]] sur votre ordinateur Mac. |
== Hypothèses == | == Hypothèses == | ||
Ligne 9 : | Ligne 9 : | ||
1. Vous savez comment ouvrir une fenêtre de terminal. | 1. Vous savez comment ouvrir une fenêtre de terminal. | ||
1. Vous utilisez un Mac 64 bits moderne. | 1. Vous utilisez un Mac 64 bits moderne. | ||
− | 1. Vous utiliserez `~ / Sites` comme point de départ de votre site. | + | 1. Vous utiliserez `~/Sites` comme point de départ de votre site. |
== Choisissez votre méthode == | == Choisissez votre méthode == | ||
Ligne 19 : | Ligne 19 : | ||
1. `Brew` est le le moyen le plus simple et celui qui demande le moins de maintenance. Peu d’inconvénients. Le paquet par défaut sera pour la version la plus récente, par conséquent il n'aura pas de correctifs jusqu'à la prochaine version (sauf si vous l'installez avec l'option `--HEAD`). La sortie vers `brew` peut avoir quelques jours de délai parce qu'il doit être coordonné avec une autre équipe. Pourtant, je recommande `brew` si vous voulez travailler à partir d'une source stable, largement utilisé. Il fonctionne bien et reste vraiment facile à mettre à jour. | 1. `Brew` est le le moyen le plus simple et celui qui demande le moins de maintenance. Peu d’inconvénients. Le paquet par défaut sera pour la version la plus récente, par conséquent il n'aura pas de correctifs jusqu'à la prochaine version (sauf si vous l'installez avec l'option `--HEAD`). La sortie vers `brew` peut avoir quelques jours de délai parce qu'il doit être coordonné avec une autre équipe. Pourtant, je recommande `brew` si vous voulez travailler à partir d'une source stable, largement utilisé. Il fonctionne bien et reste vraiment facile à mettre à jour. | ||
− | + | 2. Télécharger le tarball et l'installer à partir de celle-ci est également facile. Vous devez avoir quelques compétences de ligne de commande. Les mises à jour sont faciles, aussi. Vous répétez simplement le processus avec le nouveau binaire. Cela vous donne la flexibilité d'avoir plusieurs versions sur votre ordinateur. Si vous ne voulez pas utiliser `brew`, alors le binaire est un bon choix. | |
− | + | 3. Compiler à partir de la source représente le plus de travail. L'avantage est que vous n'avez pas à attendre une version pour ajouter des fonctionnalités ou des corrections de bugs. L'inconvénient est que vous avez besoin de passer plus de temps à gérer la configuration. Ce n'est pas énorme, mais c'est plus que les deux autres options. | |
Puisque c'est un guide how-to "débutant", je couvrirai les deux premières options en détail et aborderai plus rapidement la troisième. | Puisque c'est un guide how-to "débutant", je couvrirai les deux premières options en détail et aborderai plus rapidement la troisième. | ||
Ligne 76 : | Ligne 76 : | ||
=== Étape 3 : Vous avez terminé === | === Étape 3 : Vous avez terminé === | ||
− | Vous avez installé Hugo. Maintenant vous devez paramétrer votre site. Lisez le [Guide Quickstart en anglais](https://gohugo.io/overview/quickstart/), explorez le reste de la documentation, et si vous avez encore des questions,[demandez simplement !](http://discuss.gohugo.io/) | + | Vous avez installé Hugo. Maintenant vous devez paramétrer votre site. Lisez le [Guide Quickstart en anglais](https://gohugo.io/overview/quickstart/), explorez le reste de la documentation, et si vous avez encore des questions, [demandez simplement !](http://discuss.gohugo.io/) |
== À partir de la Tarball == | == À partir de la Tarball == | ||
Ligne 82 : | Ligne 82 : | ||
=== Étape 1 : Décidez de l’endroit === | === Étape 1 : Décidez de l’endroit === | ||
− | + | Lors de l'installation à partir de l'archive, vous devez décider si vous allez installer le binaire dans `/ usr / local / bin` ou dans votre répertoire personnel. Il y a trois camps à ce sujet : | |
− | + | 1. Installez-le dans `/usr/local/bin 'pour que tous les utilisateurs de votre système y aient accès. C'est une bonne idée parce que c'est un endroit assez standard pour les exécutables. L'inconvénient est que vous pouvez avoir besoin de privilèges élevés pour mettre le logiciel à cet endroit. En outre, s'il ya plusieurs utilisateurs sur votre système, ils exécuteront tous la même version. Parfois, cela peut poser problème si vous voulez essayer une nouvelle version. | |
− | + | 2. Installez-le dans `~/bin` afin que seul vous puissiez l'exécuter. C'est une bonne idée parce que c'est facile à faire, facile à entretenir et ne nécessite pas de privilèges élevés. L'inconvénient est que seul vous pouvez exécuter Hugo. S'il y a d'autres utilisateurs sur votre site, ils doivent conserver leurs propres copies. Cela peut amener les gens à exécuter des versions différentes. Bien sûr, cela vous facilite l'expérimentation de différentes versions. | |
− | + | 3. Installez-le dans votre répertoire `sites`. Ce n'est pas une mauvaise idée si vous avez un seul site que vous construisez. Cela garde chaque chose dans un seul endroit. Si vous voulez essayer de nouvelles versions, vous pouvez simplement faire une copie de l'ensemble du site, mettre à jour l'exécutable Hugo, et l'avoir. | |
− | + | Les trois emplacements fonctionneront pour vous. Je vais documenter la deuxième option, surtout parce que je suis à l'aise avec. | |
− | === Étape 2 : Téléchargez | + | === Étape 2 : Téléchargez l'Archive === |
− | 1. | + | 1. Ouvrez [https://github.com/spf13/hugo/releases](https://github.com/spf13/hugo/releases) dans votre navigateur. |
− | 2. | + | 2. Trouvez la version actuelle en vous déplaçant vers le bas et en recherchant la balise verte qui lit "Latest Release". |
− | 3. | + | 3. Téléchargez l'archive tar actuelle pour le Mac. Le nom sera quelque chose comme `hugo_X.Y_osx-64bit.tgz`, où` X.YY` est le numéro de version. |
− | 4. | + | 4. Par défaut, l'archive est enregistrée dans votre répertoire `~/Downloads`. Si vous choisissez d'utiliser un emplacement différent, vous devez le modifier dans les étapes suivantes. |
=== Étape 3 : Confirmez votre téléchargement === | === Étape 3 : Confirmez votre téléchargement === | ||
− | + | Vérifiez que l'archive n'a pas été endommagée pendant le téléchargement : | |
$ tar tvf ~/Downloads/hugo_X.Y_osx-64bit.tgz | $ tar tvf ~/Downloads/hugo_X.Y_osx-64bit.tgz | ||
Ligne 112 : | Ligne 112 : | ||
− | + | Les fichiers `.md` sont la documentation. L'autre fichier est l'exécutable. | |
=== Étape 4 : Installez à l'intérieur de votre directory bin === | === Étape 4 : Installez à l'intérieur de votre directory bin === | ||
− | $ # | + | $ # crée le répertoire si besoin |
$ mkdir -p ~/bin | $ mkdir -p ~/bin | ||
− | $ # | + | $ # transformation en répertoire de travail |
$ cd ~/bin | $ cd ~/bin | ||
− | $ # | + | $ # extraire l'archive |
$ tar -xvzf ~/Downloads/hugo_X.Y_osx-64bit.tgz | $ tar -xvzf ~/Downloads/hugo_X.Y_osx-64bit.tgz | ||
Archive: hugo_X.Y_osx-64bit.tgz | Archive: hugo_X.Y_osx-64bit.tgz | ||
Ligne 130 : | Ligne 130 : | ||
x ./README.md | x ./README.md | ||
− | $ # | + | $ # vérifie que ça fonctionne |
$ ./hugo version | $ ./hugo version | ||
Hugo Static Site Generator v0.13 BuildDate: 2015-02-22T04:02:30-06:00 | Hugo Static Site Generator v0.13 BuildDate: 2015-02-22T04:02:30-06:00 | ||
− | + | Vous pouvez avoir besoin d'ajouter votre répertoire bin à votre variable `PATH`. La commande `which` le vérifiera pour nous. Si elle peut trouver `hugo`, elle imprimera le chemin complet. Autrement, elle n'imprimera rien. | |
− | $ # | + | $ # vérifie si hugo est dans le chemin |
$ which hugo | $ which hugo | ||
/Users/USERNAME/bin/hugo | /Users/USERNAME/bin/hugo | ||
− | + | Si `hugo` n'est pas dans votre `PATH`, ajoutez-le en mettant à jour votre fichier `~/.bash_profile`. Premièrement, ouvrez un éditeur : | |
$ nano ~/.bash_profile | $ nano ~/.bash_profile | ||
− | + | Ajoutez une ligne pour mettre à jour votre variable `PATH` : | |
export PATH=$PATH:$HOME/bin | export PATH=$PATH:$HOME/bin | ||
− | + | Puis sauvegardez le fichier en pressant Control-X, puis Y pour sauvegarder le fichier et retourner à l'invite de commande. | |
− | + | Fermez le terminal et ouvrez un nouveau terminal pour récupérer les modifications apportées à votre profil. Vérifiez en exécutant à nouveau la commande `which hugo`. | |
=== Étape 5 : Vous avez terminé === | === Étape 5 : Vous avez terminé === | ||
− | + | Vous avez installé Hugo. Désormais vous avez besoin de paramétrer votre site. Lisez le [Guide Quickstart](https://gohugo.io/overview/quickstart/), explorez le reste de la documentation, et si vous avez encore des questions, [demandez simplement !](http://discuss.gohugo.io/) | |
== Construire à partir de la Source == | == Construire à partir de la Source == | ||
− | + | Si vous voulez compiler Hugo vous-même, vous aurez besoin de [Go](http://golang.org/), qui est aussi disponible à partir de Homebrew : `brew install go`. | |
=== Étape 1 : Obtenez la Source === | === Étape 1 : Obtenez la Source === | ||
− | + | Si vous voulez compiler une version spécifique, allez sur [https://github.com/spf13/hugo/releases](https://github.com/spf13/hugo/releases) et téléchargez le code source pour la version de votre choix. Si vous voulez compiler Hugo avec toutes les dernières modifications (qui pourraient avoir des bugs), clonez le référentiel Hugo : | |
git clone https://github.com/spf13/hugo | git clone https://github.com/spf13/hugo | ||
Ligne 173 : | Ligne 173 : | ||
=== Étape 2 : Compiler === | === Étape 2 : Compiler === | ||
− | + | Faites du répertoire contenant la source votre répertoire de travail, puis rapatriez les dépendances d'Hugo : | |
mkdir -p src/github.com/spf13 | mkdir -p src/github.com/spf13 | ||
Ligne 183 : | Ligne 183 : | ||
go get | go get | ||
+ | Cela va chercher la dernière version absolue des dépendances, par conséquent si Hugo ne parvient pas à construire, ce peut être parce que l'auteur d'une dépendance a introduit un changement de rupture. | ||
− | + | Ensuite, compilez: | |
− | |||
− | |||
go build -o hugo main.go | go build -o hugo main.go | ||
− | + | Puis placez l'exécutable `hugo` quelque part dans votre `$PATH`. | |
=== Étape 3 : Vous avez terminé === | === Étape 3 : Vous avez terminé === | ||
− | + | Vous savez probablement où aller à partir d'ici. |
Version actuelle datée du 9 mars 2017 à 03:30
Cet article est une débauche. Vous pouvez m’aider à l'améliorer.
Traduction en cours. [Seul le lien original fait référence](https://gohugo.io/tutorials/installing-on-mac/ "Permalien vers ")
Ce tutoriel vise à être un guide complet pour installer Hugo sur votre ordinateur Mac.
Hypothèses
1. Vous savez comment ouvrir une fenêtre de terminal. 1. Vous utilisez un Mac 64 bits moderne. 1. Vous utiliserez `~/Sites` comme point de départ de votre site.
Choisissez votre méthode
Il existe trois façons d'installer Hugo sur votre ordinateur Mac : l'utilitaire `brew`, provenant de la distribution ou de la source. Il n'y a pas de "meilleur" moyen de le faire. Vous devez utiliser la méthode qui convient le mieux à votre cas d'utilisation.
Il y a des avantages et des inconvénients pour chacun.
1. `Brew` est le le moyen le plus simple et celui qui demande le moins de maintenance. Peu d’inconvénients. Le paquet par défaut sera pour la version la plus récente, par conséquent il n'aura pas de correctifs jusqu'à la prochaine version (sauf si vous l'installez avec l'option `--HEAD`). La sortie vers `brew` peut avoir quelques jours de délai parce qu'il doit être coordonné avec une autre équipe. Pourtant, je recommande `brew` si vous voulez travailler à partir d'une source stable, largement utilisé. Il fonctionne bien et reste vraiment facile à mettre à jour.
2. Télécharger le tarball et l'installer à partir de celle-ci est également facile. Vous devez avoir quelques compétences de ligne de commande. Les mises à jour sont faciles, aussi. Vous répétez simplement le processus avec le nouveau binaire. Cela vous donne la flexibilité d'avoir plusieurs versions sur votre ordinateur. Si vous ne voulez pas utiliser `brew`, alors le binaire est un bon choix.
3. Compiler à partir de la source représente le plus de travail. L'avantage est que vous n'avez pas à attendre une version pour ajouter des fonctionnalités ou des corrections de bugs. L'inconvénient est que vous avez besoin de passer plus de temps à gérer la configuration. Ce n'est pas énorme, mais c'est plus que les deux autres options.
Puisque c'est un guide how-to "débutant", je couvrirai les deux premières options en détail et aborderai plus rapidement la troisième.
Brew
Étape 1 : Installez `brew` si ce n’est déjà fait
Allez sur le site web de `brew`, [1](http://brew.sh/), et suivez les directions. Copiez et collez dans la fenêtre de votre terminal :
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Le script explique ce qu’il va faire, puis m’a fait une pause avant de l’exécuter pour afficher un message « Installation successful! »
Étape 2 : Lancez la commande `brew` pour installer `hugo`
Premièrement, mettez à jour les formules et Homebrew lui-même en lançant la commande :
$ brew update
Puis installez Hugo en lançant :
$ brew install hugo ==> Downloading https://homebrew.bintray.com/bottles/hugo-0.19.sierra.bottle.tar ######################################################################## 100,0% ==> Pouring hugo-0.19.sierra.bottle.tar.gz ==> Caveats Bash completion has been installed to: /usr/local/etc/bash_completion.d ==> Summary 🍺 /usr/local/Cellar/hugo/0.19: 32 files, 16.4MB
(Note : Remplacez `brew install hugo` par `brew install hugo --HEAD` si vous voulez la dernière version en développement, mais attention, il pourrait y avoir des bugs !)
`Brew` devrait avoir mis à jour votre chemin pour inclure Hugo. Confirmer en ouvrant une nouvelle fenêtre de terminal et en lançant quelques commandes :
$ # montre l’endroit de l’executable hugo $ which hugo /usr/local/bin/hugo $ # présente la version installée $ ls -l $( which hugo ) lrwxr-xr-x 1 xtof admin 28 8 mar 09:14 /usr/local/bin/hugo -> ../Cellar/hugo/0.19/bin/hugo $ # vérifie que hugo fonctionne correctement $ hugo version Hugo Static Site Generator v0.19 darwin/amd64 BuildDate: 2017-02-27T11:21:29+01:00
Étape 3 : Vous avez terminé
Vous avez installé Hugo. Maintenant vous devez paramétrer votre site. Lisez le [Guide Quickstart en anglais](https://gohugo.io/overview/quickstart/), explorez le reste de la documentation, et si vous avez encore des questions, [demandez simplement !](http://discuss.gohugo.io/)
À partir de la Tarball
Étape 1 : Décidez de l’endroit
Lors de l'installation à partir de l'archive, vous devez décider si vous allez installer le binaire dans `/ usr / local / bin` ou dans votre répertoire personnel. Il y a trois camps à ce sujet :
1. Installez-le dans `/usr/local/bin 'pour que tous les utilisateurs de votre système y aient accès. C'est une bonne idée parce que c'est un endroit assez standard pour les exécutables. L'inconvénient est que vous pouvez avoir besoin de privilèges élevés pour mettre le logiciel à cet endroit. En outre, s'il ya plusieurs utilisateurs sur votre système, ils exécuteront tous la même version. Parfois, cela peut poser problème si vous voulez essayer une nouvelle version.
2. Installez-le dans `~/bin` afin que seul vous puissiez l'exécuter. C'est une bonne idée parce que c'est facile à faire, facile à entretenir et ne nécessite pas de privilèges élevés. L'inconvénient est que seul vous pouvez exécuter Hugo. S'il y a d'autres utilisateurs sur votre site, ils doivent conserver leurs propres copies. Cela peut amener les gens à exécuter des versions différentes. Bien sûr, cela vous facilite l'expérimentation de différentes versions.
3. Installez-le dans votre répertoire `sites`. Ce n'est pas une mauvaise idée si vous avez un seul site que vous construisez. Cela garde chaque chose dans un seul endroit. Si vous voulez essayer de nouvelles versions, vous pouvez simplement faire une copie de l'ensemble du site, mettre à jour l'exécutable Hugo, et l'avoir.
Les trois emplacements fonctionneront pour vous. Je vais documenter la deuxième option, surtout parce que je suis à l'aise avec.
Étape 2 : Téléchargez l'Archive
1. Ouvrez [2](https://github.com/spf13/hugo/releases) dans votre navigateur.
2. Trouvez la version actuelle en vous déplaçant vers le bas et en recherchant la balise verte qui lit "Latest Release".
3. Téléchargez l'archive tar actuelle pour le Mac. Le nom sera quelque chose comme `hugo_X.Y_osx-64bit.tgz`, où` X.YY` est le numéro de version.
4. Par défaut, l'archive est enregistrée dans votre répertoire `~/Downloads`. Si vous choisissez d'utiliser un emplacement différent, vous devez le modifier dans les étapes suivantes.
Étape 3 : Confirmez votre téléchargement
Vérifiez que l'archive n'a pas été endommagée pendant le téléchargement :
$ tar tvf ~/Downloads/hugo_X.Y_osx-64bit.tgz -rwxrwxrwx 0 0 0 0 Feb 22 04:02 hugo_X.Y_osx-64bit/hugo_X.Y_osx-64bit.tgz -rwxrwxrwx 0 0 0 0 Feb 22 03:24 hugo_X.Y_osx-64bit/README.md -rwxrwxrwx 0 0 0 0 Jan 30 18:48 hugo_X.Y_osx-64bit/LICENSE.md
Les fichiers `.md` sont la documentation. L'autre fichier est l'exécutable.
Étape 4 : Installez à l'intérieur de votre directory bin
$ # crée le répertoire si besoin $ mkdir -p ~/bin $ # transformation en répertoire de travail $ cd ~/bin $ # extraire l'archive $ tar -xvzf ~/Downloads/hugo_X.Y_osx-64bit.tgz Archive: hugo_X.Y_osx-64bit.tgz x ./ x ./hugo x ./LICENSE.md x ./README.md $ # vérifie que ça fonctionne $ ./hugo version Hugo Static Site Generator v0.13 BuildDate: 2015-02-22T04:02:30-06:00
Vous pouvez avoir besoin d'ajouter votre répertoire bin à votre variable `PATH`. La commande `which` le vérifiera pour nous. Si elle peut trouver `hugo`, elle imprimera le chemin complet. Autrement, elle n'imprimera rien.
$ # vérifie si hugo est dans le chemin $ which hugo /Users/USERNAME/bin/hugo
Si `hugo` n'est pas dans votre `PATH`, ajoutez-le en mettant à jour votre fichier `~/.bash_profile`. Premièrement, ouvrez un éditeur :
$ nano ~/.bash_profile
Ajoutez une ligne pour mettre à jour votre variable `PATH` :
export PATH=$PATH:$HOME/bin
Puis sauvegardez le fichier en pressant Control-X, puis Y pour sauvegarder le fichier et retourner à l'invite de commande.
Fermez le terminal et ouvrez un nouveau terminal pour récupérer les modifications apportées à votre profil. Vérifiez en exécutant à nouveau la commande `which hugo`.
Étape 5 : Vous avez terminé
Vous avez installé Hugo. Désormais vous avez besoin de paramétrer votre site. Lisez le [Guide Quickstart](https://gohugo.io/overview/quickstart/), explorez le reste de la documentation, et si vous avez encore des questions, [demandez simplement !](http://discuss.gohugo.io/)
Construire à partir de la Source
Si vous voulez compiler Hugo vous-même, vous aurez besoin de [Go](http://golang.org/), qui est aussi disponible à partir de Homebrew : `brew install go`.
Étape 1 : Obtenez la Source
Si vous voulez compiler une version spécifique, allez sur [3](https://github.com/spf13/hugo/releases) et téléchargez le code source pour la version de votre choix. Si vous voulez compiler Hugo avec toutes les dernières modifications (qui pourraient avoir des bugs), clonez le référentiel Hugo :
git clone https://github.com/spf13/hugo
Étape 2 : Compiler
Faites du répertoire contenant la source votre répertoire de travail, puis rapatriez les dépendances d'Hugo :
mkdir -p src/github.com/spf13 ln -sf $(pwd) src/github.com/spf13/hugo # set the build path for Go export GOPATH=$(pwd) go get
Cela va chercher la dernière version absolue des dépendances, par conséquent si Hugo ne parvient pas à construire, ce peut être parce que l'auteur d'une dépendance a introduit un changement de rupture.
Ensuite, compilez:
go build -o hugo main.go
Puis placez l'exécutable `hugo` quelque part dans votre `$PATH`.
Étape 3 : Vous avez terminé
Vous savez probablement où aller à partir d'ici.