Đến nội dung chính
CafeJS Docs

Ảnh

Ảnh tải lên trong admin nằm ở public/uploads/. Mỗi ảnh cần mô tả cho người đọc màn hình, nguồn rõ ràng, và bản nhỏ cho điện thoại.

Tải ảnh lên

  1. Bấm ô ảnh trong section, chọn ảnh từ máy để tải lên.
  2. Điền Image description (alt text): một câu nói ảnh có gì. Ảnh chỉ để trang trí thì để trống.
  3. Bấm Lưu.

Ảnh được lưu vào public/uploads/ và gọi bằng đường dẫn /uploads/….

Bản nhỏ cho điện thoại

Sau khi thêm ảnh, chạy lệnh dưới trong thư mục của mẫu (hoặc nhờ developer chạy):

Terminal
pnpm images --recompress

Lệnh nén lại ảnh gốc (rộng tối đa 1600 px) và tạo các bản rộng 480, 800 và 1200 px trong public/variants/. Không chạy thì ảnh vẫn hiện, nhưng điện thoại phải tải bản lớn.

Lưu ý

Đưa lên mạng bằng TinaCloud: ảnh tải lên trong admin được commit vào public/uploads/ và hiện sau lần build. Bản nhỏ cho điện thoại thì chưa có, cho tới khi chạy pnpm images --recompress trên máy rồi commit.

Nguồn và giấy phép

Ảnh mới phải có nguồn và giấy phép rõ; ghi vào CREDITS.md (nguồn, tác giả, giấy phép). Ảnh mẫu của bộ khung nằm trong public/samples/.

Cảnh báo

Admin xem thử không lưu được gì, kể cả ảnh tải lên.