Resep pembangunan ulang aset

Resep pembangunan ulang aset meregenerasi setiap aset raster dari SVG master. Ini adalah jalur pembaruan otoritatif untuk iterasi merek.

Kapan menjalankannya

Jalankan resep pembangunan ulang ketika:

• SVG master (assets/src/logo.svg atau assets/src/logo-dark.svg) berubah.
• Master favicon ringkas (assets/favicon.svg) berubah.
• Master kartu sosial (assets/src/og-banner.svg atau assets/src/twitter-card.svg) berubah.
• Ukuran raster baru dibutuhkan.
• Anda ingin memverifikasi bahwa aset yang sudah di-commit masih cocok dengan sumber SVG.

Skrip

Persyaratan

Generator meraster setiap SVG dengan resvg dan menyusun set raster dengan Pillow:

• Pillow: pip install pillow.
• resvg: unduh binari rilis untuk platform Anda dari rilis resvg — resvg-win64.zip di Windows, resvg-linux-x86_64.tar.gz di Linux, atau resvg-macos.zip di macOS — ekstrak ke PATH Anda, atau arahkan skrip ke binari tersebut dengan --resvg <path>.

Penggunaan

Regenerasi setiap aset raster:

python scripts/dev/rebuild-assets-resvg.py

Berikan --check-only untuk memverifikasi bahwa toolchain tersedia tanpa meregenerasi aset apa pun:

python scripts/dev/rebuild-assets-resvg.py --check-only

Jika resvg tidak ada di PATH Anda, arahkan skrip ke binari tersebut:

python scripts/dev/rebuild-assets-resvg.py --resvg /path/to/resvg

Verifikasi

Eksekusi yang berhasil meregenerasi raster mark terang dan gelap, set favicon PNG/ICO, ikon Apple touch, gambar OG/Twitter, dan mencerminkan subset yang disajikan di web —termasuk sumber logo hero yang dirujuk situs— ke site/public/. Setelah generasi, jalankan build situs dan periksa halaman Beranda, favicon tab peramban, dan PNG kartu sosial sebelum memublikasikan.