Skip to content

Commit

Permalink
Update troubleshooting pages
Browse files Browse the repository at this point in the history
  • Loading branch information
razonyang committed Nov 14, 2023
1 parent 3c44808 commit 0a289d5
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 0 deletions.
12 changes: 12 additions & 0 deletions content/docs/troubleshooting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,15 @@ It happens on the case of using Hugo server on production mode without the `--re
{{% code-snippet postcss-purgecss-error %}}

{{% code-snippet postcss-purgecss-solution %}}

## Extremely Inefficient Build Performance

There are a number of factors that slow down site builds, here's a list of some common ones.

1. Inefficient disk IO performance, e.g external disks.
1. Windows Defender or others antivirus software's real-time protection.
1. The publish folder are being watching by sync softwares, such as OneDrive, NutStore.

We recommend building your sites on high performance disk, such as SSD. Building on Linux system is also recommended if possible, since it's typically faster than other OSs like Windows.

> WSL2 is a good choice for Windows users.
12 changes: 12 additions & 0 deletions content/docs/troubleshooting/index.zh-hans.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,15 @@ It happens on the case of using Hugo server on production mode without the `--re
{{% code-snippet postcss-purgecss-error %}}

{{% code-snippet postcss-purgecss-solution %}}

## 效率极低的构建性能

导致网站构建速度减慢的因素有很多,下面列出了一些常见的因素。

1. 低效的磁盘 IO 性能,如外部磁盘。
1. Windows Defender 或其他杀毒软件的实时保护。
1. 同步软件(如 OneDrive、NutStore)正在监视发布文件夹。

我们建议在固态硬盘等高性能磁盘上构建网站。如果可能,还建议在 Linux 系统上构建,因为它通常比 Windows 等其他操作系统更快。

> 对于 Windows 用户来说,WSL2 是一个不错的选择。
12 changes: 12 additions & 0 deletions content/docs/troubleshooting/index.zh-hant.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,15 @@ It happens on the case of using Hugo server on production mode without the `--re
{{% code-snippet postcss-purgecss-error %}}

{{% code-snippet postcss-purgecss-solution %}}

## 效率極低的構建性能

導致網站構建速度減慢的因素有很多,下面列出了一些常見的因素。

1. 低效的磁盤 IO 性能,如外部磁盤。
1. Windows Defender 或其他殺毒軟件的實時保護。
1. 同步軟件(如 OneDrive、NutStore)正在監視發佈文件夾。

我們建議在固態硬盤等高性能磁盤上構建網站。如果可能,還建議在 Linux 系統上構建,因為它通常比 Windows 等其他操作系統更快。

> 對於 Windows 用戶來說,WSL2 是一個不錯的選擇。

0 comments on commit 0a289d5

Please sign in to comment.