Use Hugo for a custom static page

support
1

If I want to use Hugo to create a custom html page is it required that I use a theme for that purpose?

If I don’t have to use a theme, how would I create that? Is there a specific generic hugo.toml for that purpose?

2

No, you do not have to use a theme. You can work directly in the root and skip building a theme.

I would suggest you start there.

3

No you don’t need a theme.

to generate a basic (starter) site with a minimal example config and some layouts and content that can be viewed directly.

hugo new theme --themesDir . my-new-site
cd my-new-site
hugo server
Site structure 
my-new-site
│   hugo.toml
│
├───archetypes
│       default.md
│
├───assets
│   ├───css
│   │   │   main.css
│   │   │
│   │   └───components
│   │           footer.css
│   │           header.css
│   │
│   └───js
│           main.js
│
├───content
│   │   _index.md
│   │
│   └───posts
│       │   post-1.md
│       │   post-2.md
│       │   _index.md
│       │
│       └───post-3
│               bryce-canyon.jpg
│               index.md
│
├───data
├───i18n
├───layouts
│   │   baseof.html
│   │   home.html
│   │   page.html
│   │   section.html
│   │   taxonomy.html
│   │   term.html
│   │
│   └───_partials
│       │   footer.html
│       │   head.html
│       │   header.html
│       │   menu.html
│       │   terms.html
│       │
│       └───head
│               css.html
│               js.html
│
└───static
        favicon.ico

you will find a lot of guides around describing how to set up a Hugo site from scratch

4

Thanks for the response

5

So, working through the steps now and seeing the structure, since I don’t want a blog site and just a static site that may, or may not, have just one static page, I can make the changes in the hugo.toml to reflect that?

6

Out of curiosity. If you just want to make a single static page. Why not just skip all tools and make it plain html and css?

7

there is nothing in the config that tells “this is a blog”

it’s all about Content organization.

a singe page: only index.md in your content folder

a site with multiple pages: _index.md and more md files lalso in subdirectories name the folders to your need.

8

@willduncanphoto

Funny you should mentioned it. A bit after my last post, that occurred to me. I was overthinking it. I bypassed Hugo and just went the basic route.