From 8a4ca68ea01fad27f92f7f861ba5aaf27b1b9f34 Mon Sep 17 00:00:00 2001 From: dillontkh <> Date: Thu, 6 Mar 2025 22:11:17 +0800 Subject: [PATCH] Add some troubleshooting steps for building --- .../building/ignored-builds-warning.png | Bin 0 -> 7507 bytes content/building.md | 45 +++++++++++++++++- quartz/styles/custom.scss | 4 ++ 3 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 content/assets/building/ignored-builds-warning.png diff --git a/content/assets/building/ignored-builds-warning.png b/content/assets/building/ignored-builds-warning.png new file mode 100644 index 0000000000000000000000000000000000000000..cb16efc3647acd092c4cbc1f841f2e42c87ca956 GIT binary patch literal 7507 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 + + + +Run `pnpm approve-builds` and approve them. + ## Step 3: Download and Bootstrap the Browser To set up the browser, you need to download additional files and prepare the environment: @@ -68,3 +76,38 @@ pnpm start ``` This command launches the browser, allowing you to see your changes in action. + +# Troubleshooting + +
+[Windows] Error: ccache not found + +Add `C:\Users\\.mozbuild\sccache` to your PATH. + +
+ +
+[Windows] Error: 7z not found + +Download 7-zip and add it to your PATH. + +
+ +
+[All OS] My code changes are not being reflected even after building + +If you are changing files in the `src/` directory: + +```bash +pnpm run import +pnpm run build:ui +``` + +
+ +
+[All OS] Something went wrong installing the "sharp" module + +You likely did not approve builds in [Step 2](#step-2-install-dependencies). + +
diff --git a/quartz/styles/custom.scss b/quartz/styles/custom.scss index b0c09dc..d57e566 100644 --- a/quartz/styles/custom.scss +++ b/quartz/styles/custom.scss @@ -1,3 +1,7 @@ @use "./base.scss"; // put your custom CSS here! + +summary { + cursor: pointer; + } \ No newline at end of file