Installer Hugo

De Mi caja de notas

Révision datée du 9 mars 2017 à 03:30 par Xtof (discussion | contributions) (→‎Étape 1 : Décidez de l’endroit)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)


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.