Quick Reference - Hugo Site Development

# Download dependencies (first time only)
hugo mod get -u

# Start development server
hugo server -D

# Open browser
# http://localhost:1313/my-documents/

hugo new docs/bash-scripts/my-page.md

---
title: My New Page
description: Brief description for SEO
weight: 10
categories: [Bash]
tags: [bash, example]
---

Your content here...

mkdir -p content/en/docs/new-section
touch content/en/docs/new-section/_index.md

---
title: Page Title              # Required, shown as H1
description: SEO description   # Required, used in meta tags
weight: 10                      # Optional, controls ordering (lower = earlier)
categories: [category-name]    # Optional, for content organization
tags: [tag1, tag2]             # Optional, for tagging
---

content/en/docs/
├── bash-scripts/          # Weight: 10 (first)
├── howtos/               # Weight: 20
│   └── howto-write-jenkinsfile/  # Subsection
├── lists/                # Weight: 30
└── other-projects/       # Weight: 40 (last)

static/
├── howto-write-dockerfile/    # For Dockerfile guide images
├── howto-write-jenkinsfile/   # For Jenkins guide images
└── your-section/              # Create as needed

![Alt text](/howto-write-dockerfile/image-name.png)

<div class="pageinfo pageinfo-primary">

This is an informational box.

</div>

<div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Warning</div>


This is a warning message.
</div>

<ul class="nav nav-tabs" id="tabs-2" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-02-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-00" role="tab"
          aria-controls="tabs-02-00" aria-selected="true">
        Tab 1
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-01" role="tab"
          aria-controls="tabs-02-01" aria-selected="false">
        Tab 2
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-2-content">
    <div class="tab-pane fade show active"
        id="tabs-02-00" role="tabpanel" aria-labelled-by="tabs-02-00-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">&lt;p&gt;Content for tab 1&lt;/p&gt;</span></span></code></pre></div>
    </div>
    <div class="tab-pane fade"
        id="tabs-02-01" role="tabpanel" aria-labelled-by="tabs-02-01-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">&lt;p&gt;Content for tab 2&lt;/p&gt;</span></span></code></pre></div>
    </div>
</div>

```bash
#!/bin/bash
echo "Hello World"
```

```yaml
key: value
nested:
  item: value
```

```python
def hello():
    print("Hello World")
```

[Link text](/docs/bash-scripts/page-name/)
[Link text](/docs/section/_index/)

# Build minified site
hugo --minify

# Output goes to public/ directory
# GitHub Actions handles deployment automatically

echo "newWord" >>.cspell/bash.txt
pre-commit run file-contents-sorter # auto-sorts

git add .
git commit -m "Add new documentation on topic"
git push origin master

rm go.sum
hugo mod clean
hugo mod get -u
hugo server -D

hugo version # Check it says "extended"
hugo mod get -u

rm -rf resources/ public/
hugo --minify

hugo server -D              # Run dev server
hugo --minify               # Build for production
hugo --printI18nWarnings    # Check for i18n issues
hugo --printPathWarnings    # Check path warnings
hugo --printUnusedTemplates # Check unused templates
pre-commit run -a           # Run all linters