4.4 KiB
4.4 KiB
🍥Fuwari
Một mẫu blog tĩnh được xây bằng Astro.
✨ Tính năng
- Được xây dựng bằng Astro và Tailwind CSS
- Có hoạt ảnh đổi chuyển trang mượt mà
- Chế độ sáng / tối
- Màu sắc và biểu ngữ có thể tùy chỉnh được
- Thiết kế nhanh nhạy
- Có chức năng tìm kiếm với Pagefind
- Có các tính năng mở rộng của Markdown
- Có mục lục
- Nguồn cấp dữ liệu RSS
🚀 Bắt đầu
- Tạo kho lưu trữ blog của bạn:
- Tạo một kho lưu trữ mới từ mẫu này hoặc fork kho lưu trữ này.
- Hoặc chạy một trong các lệnh sau:
npm create fuwari@latest yarn create fuwari pnpm create fuwari@latest bun create fuwari@latest deno run -A npm:create-fuwari@latest
- Để chỉnh sửa blog của bạn trên máy cục bộ, hãy clone kho lưu trữ của bạn, chạy lệnh
pnpm installđể cài đặt các phụ thuộc..- Cài đặt pnpm
npm install -g pnpmnếu chưa có.
- Cài đặt pnpm
- Chỉnh sửa tệp cấu hình
src/config.tsđể tùy chỉnh blog của bạn. - Chạy
pnpm new-post <filename>để tạo một bài viết mới và chỉnh sửa nó trongsrc/content/posts/. - Triển khai blog của bạn lên Vercel, Netlify, GitHub Pages, etc. theo chỉ dẫn. Bạn cần chỉnh sửa cấu hình trang web trong
astro.config.mjstrước khi triển khai.
📝 Tiêu đề đầy đủ của bài viết
---
title: Blog đầu tiên của mình
published: 2023-09-09
description: Đây là bài viết đầu tiên vủa mình trên trang blog tạo bằng Astro này.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
lang: jp # Chỉ đặt nếu ngôn ngữ của bài viết khác với ngôn ngữ của trang web trong `config.ts`
---
🧩 Cú pháp Markdown mở rộng
Ngoài việc Astro đã có hỗ trợ mặc định cho Markdown vị Github, một số tính năng Markdown khác cũng đã được bổ sung:
- Chêm xen (Xem trước và Cách sử dụng)
- Thẻ hiển thị kho lưu trữ GitHub (Xem trước và Cách sử dụng)
- Các khối mã nâng cao với Expressive Code (Xem trước / Tài liệu)
⚡ Lệnh
Tất cả các lệnh được chạy từ thư mục gốc của dự án, từ một bảng điều khiển:
| Lệnh | Mục đích |
|---|---|
pnpm install |
Cài đặt các phụ thuộc |
pnpm dev |
Khởi động máy chủ cục bộ tại localhost:4321 |
pnpm build |
Xây dựng trang web của bạn vào ./dist/ |
pnpm preview |
Xem trước bản web cục bộ của bạn, trước khi triển khai |
pnpm check |
Chạy kiểm tra lỗi trong mã của bạn |
pnpm format |
Định dạng mã của bạn bằng Biome |
pnpm new-post <filename> |
Tạo một bài viết mới |
pnpm astro ... |
Chạy các lệnh CLI như astro add, astro check |
pnpm astro --help |
Nhận trợ giúp sử dụng Astro CLI |
✏️ Đóng góp
Xem Hướng dẫn đóng góp để biết thêm chi tiết về cách đóng góp cho dự án này.
📄 Giấy phép
Dự án này đã được cấp Giấy phép MIT.
