Giới thiệu
Xây dựng một blog cá nhân là một dự án thú vị, cho phép bạn ghi lại kiến thức, chia sẻ kinh nghiệm và thể hiện phong cách riêng. Thay vì sử dụng các nền tảng blog có sẵn, việc tự xây dựng blog mang lại sự linh hoạt tuyệt đối về thiết kế và tùy chỉnh. Bài viết này sẽ hướng dẫn bạn từng bước để tạo một blog tĩnh đơn giản bằng Hexo và triển khai nó trên GitHub Pages.
Yêu cầu trước khi bắt đầu
- Node.js và npm (Node Package Manager)
- Git
- Tài khoản GitHub
Cài đặt Node.js
Tải và cài đặt Node.js từ trang chủ chính thức. Sau khi cài đặt, mở cửa sổ dòng lệnh (Command Prompt hoặc Terminal) và kiểm tra phiên bản bằng các lệnh sau:
node -v
npm -v
Nếu các lệnh trên trả về phiên bản, nghĩa là cài đặt thành công.
Cài đặt Hexo
Cài đặt Hexo CLI (Command Line Interface) toàn cục bằng npm. Nếu gặp vấn đề kết nối do các hạn chế mạng, bạn có thể sử dụng npm镜像 (mirror) của Taobao để tăng tốc độ tải:
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install -g hexo-cli
Sau khi cài đặt, bạn có thể kiểm tra phiên bản Hexo:
hexo -v
Khởi tạo blog cục bộ
- Tạo một thư mục mới cho blog của bạn. Mở terminal, di chuyển vào thư mục đó và khởi tạo Hexo:
hexo init ten_blog_cua_ban
- Di chuyển vào thư mục blog vừa tạo và cài đặt các gói phụ thuộc:
cd ten_blog_cua_ban
npm install
- Tạo các tệp tĩnh và khởi động máy chủ phát triển cục bộ:
hexo g
hexo s
Bây giờ, bạn có thể truy cập blog tại http://localhost:4000 trong trình duyệt web.
Triển khai blog lên GitHub
- Tạo một repository mới trên GitHub với tên
ten_tai_khoan.github.io, thayten_tai_khoanbằng tên người dùng GitHub của bạn. Đây sẽ là địa chỉ blog của bạn. - Mở file
_config.ymltrong thư mục blog và cấu hình phầndeploy:
deploy:
type: git
kho_luu_tru: git@github.com:ten_tai_khoan/ten_tai_khoan.github.io.git
nhánh: main
thông_điệp: 'Cập nhật nội dung blog'
Giải thích các tham số:
kho_luu_tru: Địa chỉ kho lưu trữ (repository) trên GitHub. Sử dụng định dạng SSH để tránh phải nhập mật khẩu mỗi lần deploy.nhánh: Tên nhánh chứa mã nguồn (thường làmainhoặcmaster).thông_điệp: Thông điệp tùy chỉnh cho lần commit (commit message).
- Triển khai blog lên GitHub bằng lệnh:
hexo d -g
Lệnh này sẽ tự động tạo các tệp tĩnh và đẩy chúng lên repository đã cấu hình.
Cấu hình tên miền tùy chỉnh
Để sử dụng tên miền riêng (ví dụ: tenblogcuanban.com), bạn cần mua một tên miền và cấu hình phân giải DNS. Thêm một bản ghi CNAME trỏ đến ten_tai_khoan.github.io. Trong thư mục source của blog, tạo một file mới tên CNAME (không có phần mở rộng) và ghi tên miền của bạn vào đó. Cuối cùng, deploy lại blog bằng lệnh hexo d -g.