# Step-by-Step

*Hugo is a popular static site generator known for its speed and flexibility. This guide will help you get your site up and running in no time.*

---

## Step 1: Create Your Hugo Site Directory

To begin, you'll need to create the directory structure for your new Hugo site. Open your terminal and run the following command:

```bash
hugo new site site_directory
```

This command generates a new Hugo site in a directory named `site_directory`. You can replace `site_directory` with your preferred directory name.

## Step 2: Navigate to the New Site Directory

Once the site structure is created, navigate to the newly created directory:

```bash
cd site_directory
```

This will be your working directory for the rest of the setup process.

## Step 3: Choose and Install a Theme

Hugo relies on themes to style and structure your site. Browse the available themes on the [Hugo Themes website](https://themes.gohugo.io/) and choose one that suits your needs.

After selecting a theme, download it into the `themes/` folder within your Hugo site directory. You can do this manually or by following the theme's installation instructions, typically found on its page.

## Step 4: Configure Hugo to Use the Theme

To tell Hugo which theme to use, run the following command:

```bash
echo "theme = 'gallery'" >> hugo.toml
```

Replace `'gallery'` with the name of the theme you’ve chosen. This command appends the theme setting to your `hugo.toml` configuration file, making the theme active.

## Step 5: Start the Development Server

With your theme in place, you can start the Hugo development server to see your site in action:

```bash
hugo server
```

Hugo will compile your site and start a local server. You can view your site in a browser at `http://localhost:1313`.

## Step 6: Add a New Page

To add content to your site, create a new page by running:

```bash
hugo new content/about.md
```

This command creates a new Markdown file named `about.md` in the `content/` directory. You can edit this file to add text, images, and other content to your site.

## Step 7: Edit the Site Configuration

Most themes come with specific configuration recommendations. Open your `hugo.toml` file and adjust the settings according to the theme author's guidelines. This might include setting up menus, configuring parameters, or adding social media links.

## Step 8: Publish Your Site

Once you're satisfied with your site's content and configuration, you can build and publish your site. Run the following command:

```bash
hugo
```

This command compiles your site and generates static files in the `public/` directory. These files can be uploaded to any web server to make your site live.

---

## Conclusion

By following these steps, you’ve successfully created a new Hugo site, chosen a theme, added content, and published your site. Hugo's simplicity and speed make it an excellent choice for building modern websites. Now that your site is live, you can continue to customize and expand it as needed.

Happy me! 🌱