Common Problems

1 minute read

1. During site building:

Error: Error building site: POSTCSS: failed to transform "scss/main.css" (text/css):resource "scss/scss/main.scss_4853eb546e7a6c0898ed71feae7357c0" not found in file cache.

cd YOUR_REPO
npm audit fix

More information

2. During site building:

Error: Error building site: "~/content/en/_index.html:6:1": failed to extract shortcode: template for shortcode "blocks/cover" not found.

cd YOUR_REPO
git submodule update --init --recursive

3. During site building:

Error: Error building site: POSTCSS: failed to transform "scss/main.css" (text/css): internal/modules/cjs/loader.js:883

sudo npm i fsevents@latest -f --save-optional
sudo npm i postcss@latest -f

4. Rmarkdown rendering

The extension tex_math_dollars is not supported for gfm
Error: pandoc document conversion failed with error 23
Execution halted
Error : Failed to render content/en/docs/test.Rmarkdown

Update pandoc >= 2.12 solves the problem. Use rmarkdown::pandoc_version() to check version.

If you use Rstudio, simply update Rstudio to the latest version which comes with pandoc >= 2.12 and rmarkdown will use it automatically. Otherwise, you need to update pandoc by yourself.