check_sitemap_lastmod.py fails on local macOS builds (no Git date for non-ASCII paths)

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#929 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
66/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
git, hugo, python
Lĩnh vực
build-system, documentation

Hướng nghiên cứu

Bắt đầu với scripts/check_sitemap_lastmod.py và các cài đặt Git trong deploy.yaml quanh dòng 48. Tái hiện các mục lastmod bị thiếu trên một bản clone macOS mới bằng các cài đặt được đề xuất core.precomposeunicode và core.quotepath, sau đó so sánh với CI. Nếu cài đặt này khắc phục được vấn đề, hãy cập nhật CONTRIBUTING.md và AGENTS.md; nếu không, hãy để bước kiểm tra báo cáo riêng trường hợp này.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Problem

python3 scripts/check_sitemap_lastmod.py public/sitemap.xml fails on a local macOS build of main (2026-10-28), although the same check passes in deploy.yaml:

URLs without <lastmod>: 735 (limit 5)
FAILED

The 735 URLs are glossary and curated-resource pages with non-ASCII characters in their file paths. Hugo finds no Git date for them, so they get no lastmod. PR #925 hit the same gap: 10 curated resources with accented filenames got no dateModified locally.

CI sets git config core.quotepath false (deploy.yaml line 48). Setting that locally did not fix it, which suggests a macOS-specific cause. A likely candidate is Unicode normalisation of filenames (NFD on disk vs NFC in Git; see core.precomposeunicode). This has not been tested.

Impact

Local only, as far as we know: the production sitemap is built in CI, and the deploy check passes. But contributors running the documented checks locally get a misleading failure.

Next step

Try git config core.precomposeunicode true with core.quotepath false on a fresh clone. If that fixes it, document it in CONTRIBUTING.md and AGENTS.md (#923). Otherwise, have the check report this case separately.

Ngôn ngữ chính
HTML
Star
42
Fork
33
Merge trung bình
17 giờ 18 phút
Pull request đã merge (30 ngày)
111

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của forrtproject/forrtproject.github.io

Tất cả issue của forrtproject/forrtproject.github.io

Issue tương tự

Thêm issue về Build System

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.