Bắt đầu
Bài viết đầu tiên của bạn với Chirping Astro. Tìm hiểu cách cấu hình trang web, viết bài và triển khai.
Chào mừng bạn đến với blog mới! Bài viết mẫu này sẽ hướng dẫn bạn những điều cơ bản khi sử dụng Chirping Astro.
Mở file src/config.ts và cập nhật:
- title — tên trang web/blog của bạn
- description — hiển thị trên công cụ tìm kiếm và RSS
- author.name — hiển thị ở sidebar và footer
- url — URL production của bạn (được thiết lập qua biến môi trường
SITE_URLkhi deploy)
Sao chép .env.example thành .env:
cp .env.example .envCác biến quan trọng:
| Biến | Mục đích |
|---|---|
SITE_URL | URL production của bạn (ví dụ: https://myblog.com) |
BASE_PATH | Đặt là /<repo-name> nếu dùng GitHub Pages, nếu không thì để trống |
PUBLIC_GITHUB_HANDLE | Hiển thị icon GitHub ở sidebar |
PUBLIC_GISCUS_* | Bật comment Giscus (hướng dẫn setup) |
Tạo file Markdown trong src/content/posts/en/:
---title: 'Tiêu đề bài viết'description: 'Mô tả ngắn cho SEO và danh sách bài viết.'pubDate: 2026-05-03tags: [tag1, tag2]categories: [Danh mục]---
Viết nội dung của bạn tại đây bằng Markdown tiêu chuẩn.| Trường | Bắt buộc | Mô tả |
|---|---|---|
title | Có | Tiêu đề bài viết (1–140 ký tự) |
description | Có | Mô tả meta (1–280 ký tự) |
pubDate | Có | Ngày đăng (định dạng ISO) |
tags | Không | Mảng các tag |
categories | Không | Mảng các danh mục |
heroImage | Không | Đường dẫn ảnh đại diện |
pinned | Không | Ghim lên đầu danh sách |
toc | Không | Hiển thị mục lục |
draft | Không | Ẩn khi production |
Để có nội dung nâng cao hơn, dùng file .mdx để chèn component:
---title: 'Ví dụ MDX'description: 'Sử dụng component trong bài viết.'pubDate: 2026-05-03tags: [mdx]categories: [Hướng dẫn]---
import Callout from '../../components/Callout.astro';
<Callout type="tip">Bạn có thể nhúng trực tiếp component Astro vào bài viết!</Callout>Push lên branch main trên GitHub. Workflow đi kèm sẽ tự động build và deploy lên GitHub Pages.
Đối với domain riêng, thiết lập SITE_URL trong biến môi trường của repository tại Settings → Environments → github-pages.
Chúc bạn blogging vui vẻ! Hãy xóa bài viết này khi bạn đã sẵn sàng đăng nội dung của riêng mình.