sqzass.git

sqzass

~ static site generator in Rust
git clone https://github.com/debuman/sqzass.git
commit ca12501e85e8c608f234aad0f7ff78344c7725d6
parent 79c742bd888c498e0047d2951d57f370e4492163
Author: sqzer <110329244+devastator-x@users.noreply.github.com>
Date: Sat, 25 Jul 2026 16:52:33 +0900

Do not commit .cargo/config.toml

The committed mold linker flag broke CI: GitHub runners do not have mold, so
every build script failed with "collect2: fatal error: cannot find 'ld'".

A linker is a property of the machine, not of the project. Committing
.cargo/config.toml forces that choice on CI and on everyone who clones. It is
gitignored now, with the mold snippet documented in the README for anyone who
wants it locally.

Diffstat:
D.cargo/config.toml | 6------
M.gitignore | 4++++
MREADME.md | 18++++++++++++++++++
3 files changed, 22 insertion(+), 6 deletion(-)

diff --git a/.cargo/config.toml b/.cargo/config.toml
@@ -1,6 +0,0 @@
-# mold 링커 — 링크 시간을 크게 줄인다. (mold 2.41.0)
-#
-# gcc는 `-fuse-ld=mold`를 쓴다 (gcc 12.1+). `--ld-path=`는 clang 전용 플래그라
-# gcc에서는 "unrecognized command-line option"으로 실패한다.
-[target.x86_64-unknown-linux-gnu]
-rustflags = ["-C", "link-arg=-fuse-ld=mold"]
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,9 @@
 /target
 /docs/public
+
+# 로컬 개발자 설정. 링커 같은 머신별 선택이 들어가므로 커밋하지 않는다 —
+# 커밋하면 클론하는 모든 사람과 CI에 강제된다. 설정법은 README 참고.
+/.cargo/config.toml
 **/*.rs.bk
 *.pdb
 
diff --git a/README.md b/README.md
@@ -55,6 +55,24 @@ cargo build --release
 
 Requires Rust 1.97 or newer. Nothing else.
 
+<details>
+<summary>Optional: faster linking with mold</summary>
+
+`.cargo/config.toml` is gitignored, because a linker choice is a property of your
+machine and not of this project — committing one forces it on everyone who clones
+and on CI. If you have [mold] installed, create the file yourself:
+
+```toml
+[target.x86_64-unknown-linux-gnu]
+rustflags = ["-C", "link-arg=-fuse-ld=mold"]
+```
+
+Note `-fuse-ld=mold` is the gcc spelling; `--ld-path=` is clang-only and gcc
+rejects it.
+
+[mold]: https://github.com/rui314/mold
+</details>
+
 ## Documentation
 
 <https://sqzass.sqzer.com> — built with sqzass, from `docs/` in this repository.