Hướng dẫn triển khai Website MkDocs + Cloudflare Pages¶
Tài liệu này ghi lại quy trình chuẩn để xây dựng và duy trì website tĩnh tốc độ cao, phù hợp cho chia sẻ kiến thức kỹ thuật.
1. Chuẩn bị môi trường¶
- Cài đặt Python 3.12+ (64-bit): Tải từ python.org. Lưu ý: Tích chọn "Add Python to PATH" khi cài đặt.
- Cài đặt Git for Windows: Tải từ git-scm.com. Giữ nguyên tùy chọn mặc định.
- Kiểm tra: Mở PowerShell, gõ
python --versionvàgit --versionđể xác nhận.
2. Khởi tạo dự án MkDocs¶
Mở PowerShell và chạy các lệnh sau: ```powershell
Cài đặt thư viện giao diện Material¶
pip install mkdocs-material
Tạo dự án mới và di chuyển vào thư mục¶
mkdocs new hi-io-vn cd hi-io-vn