Custom file extension for HTML output

support
1

Hi all,
I have problem with configuration here. I tried to use Media types for change default html extension to .htm, I put this in the config.toml

[mediaTypes]
  [mediaTypes."text/html"]
  suffix = "htm"

But I still get the .html out, with my understanding, the output type for .md files in content directory should be HTML by default. Do I need to config other places?

Many thanks!!!

2

Did you look at https://gohugo.io/templates/output-formats/#output-formats-for-pages? Seems to fit for your needs, if you want to output in .htm instead of .html.

3

I will update the docs with this, as this seems to be a common use case.

4

I have updated the docs to reflect the way it is now. I have, however, discovered some issues that tells me that I may reconsider and simplify this.

1 Like
5

Thank you vary much, I will follow the issue.

6

I would suggest you start by following the updated documentation.

7

Hugo version v0.30.2

with updated document in confilg.toml I added

[mediaTypes]
[mediaTypes."text/html"]
suffix = "htm"

# Redefine HTML to update its media type.
[outputFormats.HTML]
mediaType = "text/html"

this time, it not have any content exported except xml files. I also added…

disableKinds = ["home"]
[outputs]
  page = ["HTML"]

now only one sitemap.xml came out.

This is my directory tree:

├── archetypes
│   └── default.md
├── config.toml
├── content
│   └── about.md
├── data
├── layouts
│   └── _default
│       └── single.html
├── static
└── themes
8

I suspect you have some invalid TOML, but it is impossible for me to see without the full source.

9

this is all in my config file just only minimum setting…

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
disableKinds = ["home"]

[mediaTypes]
[mediaTypes."text/html"]
suffix = "htm"

# Redefine HTML to update its media type.
[outputFormats.HTML]
mediaType = "text/html"

[outputs]
  page = ["HTML"]
10

I have updated the docs. I was a little bit fast in my “copy-paste” from my test.

11

I may doing something wrong, it still not working.
I have go back to start from the beginning by these steps.

# Hugo Static Site Generator v0.30.2
$ hugo new site ext-test
$ cd ext-test
$ hugo new about.md

add a bit content to ./content/about.md then create file ./layout/_default/single.html with this simple html code

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Document</title>
</head>
<body>
  {{ .Content }}
</body>
</html>

this is the config.toml file

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
[mediaTypes]
  [mediaTypes."text/html"]
  suffix = "htm"

# Redefine HTML to update its media type.
[outputFormats]
  [outputFormats.HTML]
  mediaType = "text/html"

finally hugo -D and this is the final output:

├── archetypes
│   └── default.md
├── config.toml
├── content
│   └── about.md
├── data
├── layouts
│   └── _default
│       └── single.html
├── public
│   ├── categories
│   │   └── index.xml
│   ├── index.xml
│   ├── sitemap.xml
│   └── tags
│       └── index.xml
├── static
└── themes

it is not has ./public/about/index.htm file

12

If you can share a link to the full source, I can have a look at it. Looking at small snippets isn’t helping, obviously.

14

I have created a github repo for full source code here…

Thanks for your time.

15

I notice you have draft = “false” in your about.md contact page, I think this must be a typo. :slight_smile:

16

oh that my bad, fixed, thank you :slight_smile:

With this current setup it’s still not export .htm file…

17

I tried this. But I don’t get it. Do you need to make both config files? I did. And that still didn’t function how explained. Can you explain more simple what is required to make the custom extensions function? Thanks!