8000 GitHub - hovinh/little-one-guide · GitHub
[go: up one dir, main page]

Skip to content
8000

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

little-one-guide

Cẩm nang chăm con 0–12 tháng — trang tĩnh, tiếng Việt, mobile-first.

Tech stack

  • 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 trong src/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.

Chạy thử

npm install
npm run dev      # http://localhost:4321
npm run build    # xuất ra dist/
npm run preview

Deploy

Thư 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.

Cấu trúc

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

Thêm hoặc sửa nội dung

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.

Nội dung tham khảo

  • Chào con! Ba mẹ đã sẵn sàng! — BS. Trần Thị Huyên Thảo

Phần chữ trong các file .md hiệ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.

Enhancement

Việc cần làm sau, chưa thực hiện.

Để deploy / redeploy dễ dàng

  • Chạy npm install rồi commit package-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 engines vào package.json hoặc file .nvmrc.
  • Đặt site (và base nếu dùng GitHub Pages dạng /little-one-guide) trong astro.config.mjs.
  • Cấu hình host: build command npm run build, output directory dist. 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.

Tài liệu và mã nguồn

  • 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.css vào phần "Cấu trúc".
  • Ghi chú notes trong 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').

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0