# Hugo quick start

Hugo is a powerful tool, with some difficulties on start, but when your project is bigger than a blog I recommend you to go this way. You will find some useful hints when you look into `vendor/Andygrond/hugonette/doc/hugo` in your Hugonette project folder.

Install Hugo using one of methods described on [Hugo doc](https://gohugo.io/getting-started/installing/). First steps after installation:

```
hugo new site myblog
cd myblog
```

### Theme

You will need a theme to begin quickly. You can pick one from ready [themes library](https://themes.gohugo.io/) now and copy to `themes` folder. It will be probably not what you want, but don't worry. It's only a starter for you. Add your theme to the `config.toml` file and play with it.

```
theme = "theme-name"
```

In a real project you will prefer to build your own themes. It's easy. Use any free html template, or buy one. Create a fresh theme structure, similar to the structure of the Hugo project:

```
hugo new theme my-theme
```

You can also go ahead without any theme. But it's better to place all your original partials in theme, and then adapt it to your project in the project folders.

### Partials

Divide your page into partials and join them together in `layouts/_default/baseof.html` It will be your default page base. Enter blocks where variable parts will be.

```
{{ block "main" . }}
  Default main block content
{{ end }}
```

Create a layout in the `layouts/_default/index.html` file, and define all needed blocks.

```
{{ define "main" }}
  {{ .Content }}
{{ end }}
```

### Page

Then create a home page file `content/_index.md`

```
---
title: Homepage
---
Hello world!
```

Start a Web Server: `hugo server` and watch your changes at `http://localhost:1313/` 

At the end of the design process, issue `hugo` command, and after a while your static site will be ready to publish in the `public` folder. Place it inside the `static` folder and rename it to `myblog`. That's all.


---

# 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://andygrond.gitbook.io/hugonette/hugo/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.