Skip to content

Commit

Permalink
Create FAQ reqarding file watcher
Browse files Browse the repository at this point in the history
  • Loading branch information
jmooring committed Feb 13, 2024
1 parent d27e39f commit 53cd36b
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions content/en/troubleshooting/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,16 @@ Yes. See [details](/getting-started/configuration/#configure-with-environme

The most common causes are page collisions (publishing two pages to the same path) and the effects of concurrency. Use the `--printPathWarnings` command line flag to check for page collisions, and create a topic on the [forum] if you suspect concurrency problems.

###### Why isn't Hugo's development server detecting file changes?

In its default configuration, Hugo's file watcher may not be able detect file changes when:

- Running Hugo within Windows Subsystem for Linux (WSL/WSL2) with project files on a Windows partition
- Running Hugo locally with project files on a removable drive
- Running Hugo locally with project files on a storage server accessed via the NFS, SMB, or CIFS protocols

In these cases, instead of monitoring native file system events, use the `--poll` command line flag. For example, to poll the project files every 700 milliseconds ms, use `--poll 700ms`.

###### Which page methods trigger content rendering?

The following methods on a `Page` object trigger content rendering: `Content`, `FuzzyWordCount`, `Len`, `Plain`, `PlainWords`, `ReadingTime`, `Summary`, `Truncated`, and `WordCount`.
Expand Down

0 comments on commit 53cd36b

Please sign in to comment.