hugo/content/en/troubleshooting/faq.md
Bjørn Erik Pedersen 9aec42c545 Squashed 'docs/' changes from 686c7b6eb..7ef2dbce4
7ef2dbce4 Cleanup RSS templates page
0e23d5e1a Fix multilingual permalinks example
b3c342b07 Update faq.md
f73109ae2 Regen CLI docs
ac6ee2027 Fix minor nitpicks (#2233)
f24fcffe1 Mention the Giscus comments system (#2234)
418fa981e Remove reference to Ghost migration tool
94a76df29 Adjust table layout
e263ad6b9 content: Fix typos
fd1eb26b5 Update featured image in digital.gov showcase
d3d946555 Correct directory description
bbe1dff56 Use sentence case for heading
acfa0be54 Add hosting provider fetch depth to GitInfo variables page
d78c427e6 Fix typo
751517fea Fix spelling mistake
cdd77aa9a Update content for v0.118.0
c77d09b1c Format netlify.toml
d5a6c4f51 netlify: Hugo 0.118.1
8c717301a Revert "netlify: Hugo 0.118.0"
a9b2ef5c2 netlify: Hugo 0.118.0
61959591c Merge commit '77b976dd92b4f66657d83d875aef0c617df492d9'
95f2029a1 docs: Regen docs helper
fd57ba960 markup/goldmark: Add CJK extension
2bfb3bf4c docshelper: Improve template lookup order descriptions
b0baa890e cache: Hide IsResourceDir from the exported config
b4b071ea0 docs: Replace docs.json with docs.yaml

git-subtree-dir: docs
git-subtree-split: 7ef2dbce4ad728d32c218761c6cfbe2f58f8da16
2023-09-24 11:54:45 +02:00

3.3 KiB

title linkTitle description categories menu weight keywords toc aliases
Frequently asked questions Frequently asked questions Solutions to some common Hugo problems.
troubleshooting
docs
parent weight
troubleshooting 20
20
faqs
true
/faq/

{{% note %}} Note: The answers/solutions presented below are short, and may not be enough to solve your problem. Visit Hugo Discourse and use the search. It that does not help, start a new topic and ask your questions. {{% /note %}}

I can't see my content!

Is your Markdown file in draft mode? When testing, run hugo server with the -D or --buildDrafts switch.

Is your Markdown file part of a leaf bundle? If there is an index.md file in the same or any parent directory then other Markdown files will not be rendered as individual pages.

Can I set configuration variables via OS environment?

Yes you can! See Configure with Environment Variables.

How do I schedule posts?

  1. Set publishDate in the page front matter to a datetime in the future. If you want the creation and publication datetime to be the same, it's also sufficient to only set date1.
  2. Build and publish at intervals.

How to automate the "publish at intervals" part depends on your situation:

  • If you deploy from your own PC/server, you can automate with Cron or similar.
  • If your site is hosted on a service similar to Netlify you can:
    • Use a service such as ifttt to schedule the updates; or
    • Set up a deploy hook which you can run with a cron service to deploy your site at intervals, such as cron-job.org (both Netlify and Cloudflare Pages support deploy hooks)

Also see this Twitter thread:

{{< tweet user="ChrisShort" id="962380712027590657" >}}

Can I use the latest Hugo version on Netlify?

Yes you can!.

I get "... this feature is not available in your current Hugo version"

If you process SCSS or Sass to CSS in your Hugo project with libsass as the transpiler or if you convert images to the webp format, you need the Hugo extended version, or else you may see an error message similar to the below:

error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): this feature is not available in your current Hugo version

We release two set of binaries for technical reasons. The extended version is not what you get by default for some installation methods. On the release page, look for archives with extended in the name. To build hugo-extended, use go install --tags extended

To confirm, run hugo version and look for the word extended.


  1. See Configure Dates for the order in which the different date variables are complemented by each other when not explicitly set. ↩︎