Astro Starlight

Astro Starlight là một chủ đề tài liệu được xây dựng trên nền tảng web Astro. Nó cung cấp một cấu trúc sẵn sàng để tạo các trang web tài liệu nhanh, dễ tiếp cận và dễ bảo trì. Khác với các công cụ tài liệu khác, Starlight gửi rất ít JavaScript đến trình duyệt, giúp thời gian tải nhanh hơn và hiệu suất tốt hơn.

Công cụ hỗ trợ viết nội dung bằng các định dạng Markdown, MDX và Markdoc, mang lại sự linh hoạt trong cách bạn tạo tài liệu. Nó bao gồm tính năng tạo điều hướng tự động, tìm kiếm tích hợp được hỗ trợ bởi Pagefind, và thiết kế đáp ứng hoạt động trên tất cả các thiết bị. Starlight cũng hỗ trợ đa ngôn ngữ ngay khi cài đặt, phù hợp cho các dự án tài liệu toàn cầu. Chủ đề này có thể tùy chỉnh cao thông qua các tệp cấu hình, cho phép bạn phù hợp với thương hiệu của mình trong khi vẫn giữ được sự đơn giản khi thiết lập.

Bắt đầu với Astro Starlight rất đơn giản và chỉ cần vài bước sau:

• Cài đặt Starlight bằng cách sử dụng dòng lệnh, chạy npm create astro@latest -- --template starlight trong terminal của bạn. Lệnh này sẽ thiết lập mọi thứ tự động.

• Sau khi cài đặt xong, khởi động server phát triển với npm run dev để xem trước trang tài liệu của bạn trên trình duyệt cục bộ.

• Thêm các trang tài liệu mới bằng cách tạo các file Markdown hoặc MDX trong thư mục src/content/docs/. Mỗi file sẽ tự động trở thành một trang.

• Cấu hình cài đặt trang web trong file astro.config.mjs. Tại đây bạn có thể đặt tiêu đề trang, thêm liên kết mạng xã hội và tùy chỉnh thanh điều hướng bên.

• Tổ chức các trang bằng cách tạo thư mục bên trong thư mục docs. Starlight sẽ tự động tạo điều hướng dựa trên cấu trúc file của bạn.

• Khi sẵn sàng xuất bản, xây dựng trang web với npm run build và triển khai lên bất kỳ dịch vụ lưu trữ tĩnh nào như Netlify, Vercel hoặc GitHub Pages.

• Tạo trang tĩnh nhanh với JavaScript tối thiểu

• Tìm kiếm tích hợp với Pagefind

• Hỗ trợ quốc tế hóa đầy đủ

• Tự động tạo điều hướng

• Bao gồm giao diện tối và sáng

• Hỗ trợ Markdown, MDX và Markdoc

• Tích hợp đa framework (React, Vue, Svelte)

• Thiết kế tập trung vào khả năng truy cập

• Bố cục đáp ứng cho thiết bị di động

• Chủ đề và màu sắc có thể tùy chỉnh

• Liên kết chỉnh sửa trang

• Tích hợp mạng xã hội

• Tối ưu hóa SEO