Cẩm nang chăm con 0–12 tháng — trang tĩnh, tiếng Việt, mobile-first.
- Astro 5 — xuất HTML tĩnh, JS chỉ gửi xuống ở những phần cần tương tác.
- Tailwind CSS 4 (qua
@tailwindcss/vite) — token màu/phông khai báo trongsrc/styles/global.css. - Fuse.js — tìm kiếm phía client, hỗ trợ gõ có dấu lẫn không dấu.
- Không backend, không API lúc chạy.
npm install
npm run dev # http://localhost:4321
npm run build # xuất ra dist/
npm run previewThư mục dist/ là site tĩnh: kéo thả lên Netlify, connect repo với Vercel, hoặc GitHub Pages.
Nếu dùng GitHub Pages dạng hovinh.github.io/little-one-guide, bỏ comment site và base trong
astro.config.mjs.
src/
content/topics/*.md 56 chủ đề — mỗi file một bài, frontmatter giữ metadata
content.config.ts schema của collection (zod)
data/who.ts số liệu tham chiếu WHO 0–24 tháng
data/books.ts danh sách sách tham khảo
lib/pillars.ts 3 nhóm nội dung + màu + danh sách chủ đề (theme)
lib/vi.ts bỏ dấu tiếng Việt, nhãn mốc tuổi
components/ Search (Fuse.js), TopicCard
layouts/Base.astro header + tabs + footer
pages/ index (bản đồ), chu-de, theo-thang, tang-truong, tham-khao, bai/[slug]
search.json.ts chỉ mục tìm kiếm sinh lúc build
Tạo file mới trong src/content/topics/:
---
title: "Tên bài"
pillar: 1 # 1 | 2 | 3
icon: child_care # tên icon Material Symbols
theme: "Bú & sữa" # xem THEMES trong src/lib/pillars.ts
ageFrom: 0
ageTo: 6
ageLabel: "0–6 tháng"
summary: "Câu tóm tắt hiện trên thẻ."
order: 60
notes: # nội dung theo từng mốc tuổi, hiện ở trang Theo tháng
- from: 0
to: 2
text: "Điều cần biết ở 0–2 tháng."
- from: 3
to: 6
text: "Điều cần biết ở 3–6 tháng."
---
## Tóm tắt nhanh
Nội dung bài viết bằng Markdown.Một chủ đề xuất hiện ở mọi tháng nằm trong khoảng của từng note, nên khoảng tuổi nào cũng
thấy đủ thông tin mà không phải nhớ lại bài trước.
- Chào con! Ba mẹ đã sẵn sàng! — BS. Trần Thị Huyên Thảo
Phần chữ trong các file
.mdhiện là văn bản mẫu để dựng cấu trúc; thay bằng nội dung gốc từ sách.
Việc cần làm sau, chưa thực hiện.
- Chạy
npm installrồi commitpackage-lock.jsonđể mỗi lần build cài đúng cùng phiên bản. - Khai báo phiên bản Node (Astro 5 cần ≥ 18.20): thêm
enginesvàopackage.jsonhoặc file.nvmrc. - Đặt
site(vàbasenếu dùng GitHub Pages dạng/little-one-guide) trongastro.config.mjs. - Cấu hình host: build command
npm run build, output directorydist. Thư mục.astro/do Astro tự sinh lúc build nên không cần commit (đã nằm trong.gitignore). - Nếu repo vẫn nằm trong
rag-learning-lab/template/little-one-guide/, trỏ root directory của host vào thư mục này; tách ra repo riêng thì bỏ bước này.
- Nói rõ trong README rằng font và icon (Nunito, Be Vietnam Pro, Material Symbols Rounded) tải từ Google Fonts, nên trang cần mạng để hiện đúng; hoặc tự host font.
- Thêm
src/styles/global.cssvào phần "Cấu trúc". - Ghi chú
notestrong frontmatter bắt buộc có ít nhất 1 mục. - Viết lại câu về "mọi tháng nằm trong khoảng của từng note" cho dễ hiểu hơn.
- Sửa comment đầu
src/components/Search.astro(/search.json→base + 'search.json').