# 🇬🇧 Quick Start

## Step 1: Install Hugo  <a href="#step-1-install-hugo" id="step-1-install-hugo"></a>

```
brew install hugo
# or
port install hugo
```

To verify your new install:

## Step 2: Create a New Site  <a href="#step-2-create-a-new-site" id="step-2-create-a-new-site"></a>

The above will create a new Hugo site in a folder named `quickstart`.

## Step 3: Add a Theme  <a href="#step-3-add-a-theme" id="step-3-add-a-theme"></a>

See [themes.gohugo.io](https://themes.gohugo.io/) for a list of themes to consider. This quickstart uses the beautiful [Ananke theme](https://themes.gohugo.io/gohugo-theme-ananke/).

First, download the theme from GitHub and add it to your site’s `themes` directory:

```
cd quickstart
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
```

*Note for non-git users:*

* If you do not have git installed, you can download the archive of the latest version of this theme from: <https://github.com/budparr/gohugo-theme-ananke/archive/master.zip>
* Extract that .zip file to get a “gohugo-theme-ananke-master” directory.
* Rename that directory to “ananke”, and move it into the “themes/” directory.

Then, add the theme to the site configuration:

```
echo 'theme = "ananke"' >> config.toml
```

## Step 4: Add Some Content  <a href="#step-4-add-some-content" id="step-4-add-some-content"></a>

You can manually create content files (for example as `content//.`) and provide metadata in them, however you can use the `new` command to do a few things for you (like add title and date):

```
hugo new posts/my-first-post.md
```

Edit the newly created content file if you want, it will start with something like this:

```
---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true
---

```

## Step 5: Start the Hugo server  <a href="#step-5-start-the-hugo-server" id="step-5-start-the-hugo-server"></a>

Now, start the Hugo server with [drafts](https://gohugo.io/getting-started/usage/#draft-future-and-expired-content) enabled:

```
▶ hugo server -D

                   | EN
+------------------+----+
  Pages            | 10
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  3
  Processed images |  0
  Aliases          |  1
  Sitemaps         |  1
  Cleaned          |  0

Total in 11 ms
Watching for changes in /Users/bep/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /Users/bep/quickstart/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
```

**Navigate to your new site at** [**http://localhost:1313/**](http://localhost:1313/)**.**

Feel free to edit or add new content and simply refresh in browser to see changes quickly (You might need to force refresh in webbrowser, something like Ctrl-R usually works).

## Step 6: Customize the Theme  <a href="#step-6-customize-the-theme" id="step-6-customize-the-theme"></a>

Your new site already looks great, but you will want to tweak it a little before you release it to the public.

### Site Configuration  <a href="#site-configuration" id="site-configuration"></a>

Open up `config.toml` in a text editor:

```
baseURL = "https://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "ananke"
```

Replace the `title` above with something more personal. Also, if you already have a domain ready, set the `baseURL`. Note that this value is not needed when running the local development server.

For theme specific configuration options, see the [theme site](https://github.com/budparr/gohugo-theme-ananke).

**For further theme customization, see** [**Customize a Theme**](https://gohugo.io/themes/customizing/)**.**

### Step 7: Build static pages  <a href="#step-7-build-static-pages" id="step-7-build-static-pages"></a>

It is simple. Just call:

```
hugo -D
```

Output will be in `./public/` directory by default (`-d`/`--destination` flag to change it, or set `publishdir` in the config file).<br>

## Résumé des commandes sous linux

(commandes et test par @Léolios)

```bash
# installation du binaire écrit en Go
snap install hugo --channel=extended
sudo apt-get install hugo

# création d'un nouveau site
hugo new site bluekeys

# initialisation de git et ajout d'un sous module
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

# configuration du thème par rapport au sous module ajouté
echo 'theme = "ananke"' >> config.toml

# création d'un nouvelle article
hugo new posts/my-first-post.md

# exécution en local du site pour tester
hugo server -D

# génération du site statique
# Ou tu génére et tu vas dans le dossier public 
hugo -D
```

Thème dispo : [https://themes.gohugo.io/theme](https://themes.gohugo.io/theme/hugo-theme-introduction/)

### See Also

* [External Learning Resources](https://gohugo.io/getting-started/external-learning-resources/)
* [Use Hugo Modules](https://gohugo.io/hugo-modules/use-modules/)
* [Basic Usage](https://gohugo.io/getting-started/usage/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluekeys.org/guide/couche-haute/hugo/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.