1--- 2title: Installation 3weight: 15 4--- 5 6Les étapes suivantes sont là pour vous aider à initialiser votre site. Si vous ne connaissez pas du tout Hugo, il est fortement conseillé de vous entrainer en suivant ce [super tuto pour débutants](https://gohugo.io/overview/quickstart/). 7 8## Créer votre projet 9 10Hugo fournit une commande `new` pour créer un nouveau site. 11 12``` 13hugo new site <new_project> 14``` 15 16## Installer le thème 17 18Installer le thème **Hugo-theme-learn** en suivant [cette documentation](https://gohugo.io/themes/installing/) 19 20Le repo du thème est : https://github.com/matcornic/hugo-theme-learn.git 21 22Sinon, vous pouvez [télécharger le thème sous forme d'un fichier .zip](https://github.com/matcornic/hugo-theme-learn/archive/master.zip) et extrayez le dans votre dossier de thèmes. 23 24## Configuration simple 25 26Lorsque vous générez votre site, vous pouvez définir un thème en utilisant l'option `--theme`. Il est conseillé de modifier votre fichier de configuration `config.toml` and définir votre thème par défaut. En passant, ajoutez les prérequis à l'utilisation de la fonctionnalité de recherche. 27 28```toml 29# Modifiez le thème pour qu'il soit utilisé par défaut à chaque génération de site. 30theme = "hugo-theme-learn" 31 32# Pour la fonctionnalité de recherche 33[outputs] 34home = [ "HTML", "RSS", "JSON"] 35``` 36 37## Créer votre première page chapitre 38 39Les *chapitres* sont des pages contenant d'autre pages filles. Elles ont un affichage spécial et contiennent habituellement juste un _nom_ de chapitre, le _titre_ et un _résumé_ de la section. 40 41``` 42### Chapitre 1 43 44# Démarrage 45 46Découvrez comment utiliser ce thème Hugo et apprenez en les concepts 47``` 48 49s'affiche comme 50 51![Un chapitre](/basics/installation/images/chapter.png?classes=shadow&width=60%) 52 53**Hugo-theme-learn** fournit des archétypes pour créer des squelettes pour votre site. Commencez par créer votre premier chapitre avec la commande suivante: 54 55``` 56hugo new --kind chapter basics/_index.md 57``` 58 59En ouvrant le fichier généré, vous devriez voir la propriété `chapter=true` en haut, paramètre quit définit que le page est un _chapitre_. 60 61## Créer votre première page 62 63Puis, créez votre premier page dans le chapitre précédent. Pour ce faire, il existe deux possibilités : 64 65``` 66hugo new basics/first-content.md 67hugo new basics/second-content/_index.md 68``` 69 70N'hésitez pas à éditer ces fichiers en ajoutant des exemple de contenu et en remplaçant le paramètre `title` au début du fichier. 71 72## Lancer le site localement 73 74Lancez la commande suivante : 75 76``` 77hugo serve 78``` 79 80Se rendre sur `http://localhost:1313` 81 82Vous devriez voir trois choses: 83 841. Vous avez un menu **Basics** à gauche, qui contient deux sous-menu avec des noms égal au paramètre `title` des fichiers précédemment générés. 852. La page d'accueil vous explique comment la modifier. Suivez les instructions. 863. Avec la commande `hugo serve`, la page se rafraichit automatiquement à chaque fois que vous sauvegardez. Super ! 87 88## Générez le site 89 90Quand votre site est prêt à être déployé, lancez la commande suivante: 91 92``` 93hugo 94``` 95 96Un dossier `public` a été généré. Il contient tout le contenu statique et les ressources nécessaires pour votre site. Votre site peut maintenant être déployé en utilisant n'importe quel serveur ! 97 98{{% notice note %}} 99Ce site peut être automatiquement publié et hébergé avec [Netlify](https://www.netlify.com/) ([Plus d'infos](https://www.netlify.com/blog/2015/07/30/hosting-hugo-on-netlifyinsanely-fast-deploys/)). Sinon, vous pouvez utiliser les [Github pages](https://gohugo.io/hosting-and-deployment/hosting-on-github/) 100{{% /notice %}}