github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-14 20:37:55 -05:00
Code Issues Projects Releases Packages Wiki Activity
hugo/content/en/troubleshooting/faq.md
Bjørn Erik Pedersen 475f87f685 Squashed 'docs/' changes from 96fdc246c..30f32a624 
30f32a624 Update scss-sass.md
503130186 Update scss-sass.md
cbfaa6704 Remove references to outdated Blackfriday markdown processor (#1748)
e43948d26 netlify: Hugo 0.100.2
aaabe0ee9 Merge branch 'tempv0.100.2'
bc615f257 tpl/path: Add path.BaseName function
5dddbf95e Add Chinese translation for _documentation and _index.md
b1e4f3200 Add translation for search tools
23281633a Update introduction.md
3abb5fb5d netlify: Hugo 0.100.1
644ed3b01 Update faq.md
54f377051 Add some lines about resources.Copy
82cf08355 Remove most Blackfriday references
bfbe5aaf3 netlify: Update to Hugo 0.100.0
8b6f8577f docs: Regen CLI docs
858a5d39c docs: Regen docs helper
5037d504f Merge commit 'e4bfe59c4e043c92d3992587d8c64d264b262a22'
03ca7be5b Fix indentation in highlight shortcode

git-subtree-dir: docs
git-subtree-split: 30f32a62433a6d62b680a2dd874c72bb8fb0b728
2022-06-16 07:22:11 +02:00

3.5 KiB
Raw Blame History

title linktitle description date categories menu keywords weight toc aliases
Frequently Asked Questions FAQ Solutions to some common Hugo problems. 2018-02-10
troubleshooting
docs
parent
troubleshooting
faqs
2 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.

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.

Also see this Twitter thread:

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

Can I use the latest Hugo version on Netlify?

Yes you can! Read this.

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.

Do I need to install Git to create, deploy, and maintain a website with Hugo?

Technically, no.

Practically, yes.

  • The primary installation method documented by most (perhaps all) themes is via Git or the Hugo Modules feature.
  • The Hugo Modules feature requires Go, and Go “gets” with Git.
  • A Git repository is required by CI/CD hosting (Bitbucket, Cloudflare, GitHub Pages, GitLab Pages, Netlify, et. al.).
  • The canonical “last modified” date for content is its Git committer date; using anything else is error-prone.

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