Ever since I started using hugo-flex several months ago, I noticed that any */index.xml yield a blank page or bare HTML code unprocessed.
It looks like maybe the code generating index.xml is not working as intended.
This becomes a real issue because search engines index and return high ranking results for these index.xml pages, which to users are blank or garbled.
My solution was to overload rss.xml that gave only the plain xml for machine use, which search engines recognize not to put into human search results.

This patch fixes index.xml not working correctly on Hugo 0.57

diff --git a/layouts/_default/rss.xml b/layouts/_default/rss.xml
index 1e93baa..4f28dac 100644
--- a/layouts/_default/rss.xml
+++ b/layouts/_default/rss.xml
@@ -10,7 +10,7 @@
     <webMaster>{{ . }}{{ with site.Author.name }} ({{ . }}){{ end }}</webMaster>{{ end }}{{ with site.Copyright }}
     <copyright>{{ . }}</copyright>{{ end }}{{ with .Date | default nil }}
     <lastBuildDate>{{ .Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}{{ with .OutputFormats.Get "RSS" }}
-    {{ printf `<atom:link href=%q rel="self" type=%q />` .Permalink .MediaType | safeHTML }}{{ end }}{{ range where .Pages "Type" "in" site.Params.mainSections }}
+    {{ printf `<atom:link href=%q rel="self" type=%q />` .Permalink .MediaType | safeHTML }}{{ end }}{{ range where site.RegularPages "Type" "in" site.Params.mainSections }}
     <item>
       <title>{{ .Title }}</title>
       <link>{{ .Permalink }}</link>

This is caused by Chrome for Android's Font Boosting and can be disabled by setting the CSS max-height: 1000000px on the footer element.

This hugo-flex template has worked well for several Hugo 0.5x and through 0.64 very fast.

Upon using Hugo 0.65.x, my ~2000 page scivision.dev site builds 4x slower. Through 0.64.x, my site built in about 6 seconds. Using Hugo 0.65.x my site builds in 26 seconds.

This could possibly have to do with the new approaches to taxonomies etc. in 0.65 https://github.com/gohugoio/hugo/releases/tag/v0.65.0

Hugo is still vastly faster than Jekyll, but just something to think about, if it's something in Hugo vs. hugo-flex causing this apparent slowdown.

Hugo 0.120 just released made a couple deprecations that are a trivial find and replace to upgrade.
Specifically, site.author.email and site.author.name. They still work in Hugo 0.120 but are now deprecated.

https://github.com/gohugoio/hugo/releases/tag/v0.120.0

It seems that 'Hugo Flex' is excellent for my purposes.

If I view the demo on a smartphone I get this (1920x1080):

... and on a tablet (or desktop) that (2560x1600):

Question: How is it possible to avoid the empty margins on a tablet or desktop?

Or in other words: How can the full width of the screen be used for content?

How exactly do i embed a soundcloud track to my hugo site?

I tried using the shortcode as suggested {{< soundcloud 123456789 >}} into the content of the markdown, but nothing shows up.

Do i have to modify the soundcloud.html file at all or leave it as is?

I have seen a number of hugo shortcodes for soundcloud, but nobody has given an actual practical example. Its all theoretical.

I am interested in creating a site, but there is no "Example Site" in your theme. Do you have a sample? I can build one up but thought I'd ask first.

A "<div>" element is used for the button that loads the SoundCloud player in the SoundCloud shortcode. A "<button>" element would be more appropriate.

Use url to configure external links and pageRef to configure internal links in the menu. I saw you using the former.

I have added a post and an About page. However the Tags and Categories pages are not generated. How do I get them to be generated?

for some reason, the $.Type variable is empty in comments.html.
if i move the whole condition ( {{ if in site.Params.mainSections $.Type | and site.Params.utterances.enable }} ) from comments.html to single.html, it works.

also, "enable" should be "enabled" to match with the readme.

Would you be interested in adding a dark mode version of your theme?

There are some tips here for example. To keep hugo-flex simple, I would not apply tip 7 (I guess a toggle or a let the system decide would require some js?) and just set the theme -light or dark- with a dedicated entry in the Hugo config file.

Hello!

thanks for providing this nice template I am relly liking it!
Unfortunately this template has CSS inline in the HTML, which conflicts with usual CSP configuration .

A temporary workaround is to put the CSP header with

style-src 'self' 'unsafe-inline'

however, as the name suggest this is unsafe as it might open the website to attacks if later someone has a sub directory where users can write something. To avoid this it would be awesome if you could provide the css through a file instead of loading it inline; do you think this is possible ?

It seems that it’s currently not possible to mix Markdown and inline math in the same paragraph:

• {{<math>}}Here is [a link](https://github.com/ldeso/hugo-flex). By the way, $1 + 1 = 2$.{{</math>}}
  

  would cause the link not to be rendered.

  (Replacing this line:

  hugo-flex/layouts/shortcodes/math.html

  Line 19 in 16a8dac

  {{ .Inner }}

  with {{ .Inner | markdownify }} would solve this, and would let one just wrap an entire article in {{<math>}}.)

• Here is [a link](https://github.com/ldeso/hugo-flex). By the way, {{<math>}}$1 + 1 = 2${{</math>}}.
  

  renders the link and the math but the math is displayed in its own block since it gets put in a <div>. (And having to intersperse an entire article with these would not be ideal.)

Or perhaps I am missing something?

Thanks.

In your baseof.html

<html{{ with site.LanguageCode | default site.Language.Lang }} lang="{{ . }}"{{ end }}>

Could work better if replaced with this instead

<html lang="{{ or site.LanguageCode site.Language.Lang }}">

which is the standard way to define the language code in Hugo.

FYI

I referenced your theme as I thought it is a great work

https://discourse.gohugo.io/t/best-hugo-themes/14004/7

I am sorry for creating a fake issue, but it seems to be the only way to communicate back on stackoverflow.

This patch does two things:

1. puts canonical link in the header. this is useful for sites that do redirects so that they don't get penalized by search engines for duplicated content.
2. adds auto-generated metadata to header from Hugo internals: https://github.com/gohugoio/hugo/tree/master/tpl/tplimpl/embedded/templates

--- layouts/_default/baseof.html       2019-08-16 01:01:55.636909100 -0400
+++ layouts/_default/baseof.html        2019-08-16 01:31:07.890929500 -0400
@@ -6,6 +6,12 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <link rel="canonical" href="{{ .Site.BaseURL }}{{ .RelPermalink }}">
+
+  {{ template "_internal/schema.html" . }}
+  {{ template "_internal/opengraph.html" . }}
+  {{ template "_internal/twitter_cards.html" . }}
+
   <title>
     {{ if eq .Title site.Title }}
     {{ site.Title }}

Homepage shows the latest post by default, or set to summaries.
How to show specific md file on homepage?
I put _index.md into content but it does not work.

I like to list category as well as tag for each page. Does this seem like a reasonable options? Here's how I've been overloading this functionality:

I insert into my layouts/_default/single.html and layouts/index.html the line

{{ partial "categories.html" . }}

referring to layouts/partials/categories.html containing

{{ with .Params.categories }}
<footer>
  <ul class="Tags">
    {{ range . }}
    {{ $name := . }}
    {{ with $name | urlize | printf "/categories/%s" | site.GetPage }}
    <li class="Tags-item u-background">
      <a class="Tags-link u-clickable" href="{{ .Permalink }}" rel="category">{{ $name }}</a>
    </li>
    {{ end }}
    {{ end }}
  </ul>
</footer>
{{ end }}

Hello,

Do you think it would be nice to add a netlify: hash for the theme configuration, inside which there could be booleans to flip the reCAPTCHA/honeypot fields on/off in the netlify partial template?

See also:
https://docs.netlify.com/forms/spam-filters/#extra-spam-prevention

When viewing the site with a recent mobile browser that has a retractable navigation bar, the minimum page height is too large and requires scrolling. This is because recent mobile browsers compute the CSS length 100vh as if their navigation bar would be hidden even though the bar is visible by default. This can be fixed by using a relative length unit based on viewport such as 100svh.

Hi, first of all, thanks for providing this theme!
I tried customizing my page a bit with an external css file like shown in the README, but I can't get it to load.

I created a style file static/css/foo.css, containing some syle instructions.
In config.yaml, I added

css:
  - css/foo.css

When building the page, the foo.css file shows up in the correct place in the public folder. But there is no reference to it anywhere. Am I doing something wrong in my config file or is this a bug in the theme?