Các Bước tạo Website với MKDocs

Nguồn tham khảo:¶

Chuẩn bị những gì¶

Tải VS Code
Tải Github destop
Đăng ký tài khoản github
Cài đặt Python
Tải template blog của một ai đó làm mẫu- mình sử dụng blog của thienqc.github.io

Lưu ý¶

Ở bước cài python nhớ chọn đường dẫn, nếu quên thì xóa->cài lại

Thực Hành¶

B1-Trên github page¶

Tạo một repository -> copy link HTTPS ->sang bước 2

B2 - Trên github destop¶

Github destop đăng nhập bằng tài khoản github của bạn. Vào mục File-> clone repository -> Paste đường link ở bước 1 để clone thư mục về máy tính.

B3 Vào VS code¶

Chọn file -Open folder vừa tạo ở bước 2
Mở Terminal trên VS code
Nhập dòng lệnh bên dưới để cài mkdocs :Tham khảo thêm ở đây

 pip install mkdocs-material

Bước 4 vẫn đang ở VS code¶

Gõ tiếp dòng lệnh ở trong cái folder blog vừa clone và đang mở VS code gõ mkdocs new . (dấu chấm)
Nhớ là mkdocs new . (dấu . để nó ko tạo thêm folder con)

  mkdocs new .

Sau bước này sẽ thấy trong folder có thêm file mkdocs.yml và folder docs chứa tệp index

Xong rồi, giờ ta gõ tiếp ,lệnh này là để preview web thôi.

mkdocs server

Giờ ta đã có một website được hiện thị ở đường link hiện ra trên cửa sổ Terminal của VS code kiểu

link http://127.0.0.1:8000/ là truy cập được rồi

B5 Đến bước cấu hình theo cá nhân rồi đây¶

Website bên trên là một web cơ bản nhất ( tempalte ) Giờ ta cần làm một chút để nó được cá nhân hóa và làm đẹp và đẩy lên mạng là xong rồi. cùng làm tiếp các bước sau nhé.