Chuyển đến nội dung chính

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.

Hướng dẫn 2 phút đọc

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_URL khi deploy)

Sao chép .env.example thành .env:

Terminal window
cp .env.example .env

Các biến quan trọng:

BiếnMục đích
SITE_URLURL 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_HANDLEHiể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-03
tags: [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ườngBắt buộcMô tả
titleTiêu đề bài viết (1–140 ký tự)
descriptionMô tả meta (1–280 ký tự)
pubDateNgày đăng (định dạng ISO)
tagsKhôngMảng các tag
categoriesKhôngMảng các danh mục
heroImageKhôngĐường dẫn ảnh đại diện
pinnedKhôngGhim lên đầu danh sách
tocKhôngHiển thị mục lục
draftKhô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-03
tags: [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.

Bình luận