Bỏ qua

Đăng bài từ điện thoại trong 60 giây

Trang quản trị /admin/ cho phép viết, sửa và đăng bài ngay trên trình duyệt điện thoại. Không cần cài Git, không cần mở máy tính.

Chuẩn bị (chỉ một lần)

  1. Mở https://hi.io.vn/admin/ bằng Chrome hoặc Safari.
  2. Bấm Login with GitHub, đăng nhập tài khoản có quyền ghi vào repo Nhut7736/hi-io-vn.
  3. Cấp quyền cho ứng dụng OAuth. Xong — lần sau trình duyệt sẽ ghi nhớ phiên đăng nhập.

Thêm vào màn hình chính

Trên iOS: mở trang trong Safari → Chia sẻ → Thêm vào MH chính. Trên Android: Chrome → menu ⋮ → Thêm vào màn hình chính. Sau đó chỉ cần một chạm là mở trang viết bài.

Viết bài mới

  1. Trong /admin/, chọn Bài viết (Blog) → New Bài viết.

  2. Điền các trường:

    Trường Ghi chú
    Tiêu đề Ngắn, rõ, chứa từ khóa chính
    Mô tả ngắn 1–2 câu, hiện ở danh sách bài và khi chia sẻ link
    Ngày đăng Mặc định là thời điểm hiện tại
    Chuyên mục Chọn đúng một chuyên mục chính
    Tags 2–5 thẻ, viết thường, không dấu
    Nội dung Trình soạn thảo Markdown

  3. Bấm Publish. Bài được commit vào GitHub, Cloudflare build lại và lên sóng sau khoảng 1–2 phút.

Mẹo viết nhanh trên điện thoại

  • Dán từ Google Docs/Word: dán dạng văn bản thuần trước, rồi định dạng lại bằng Markdown để tránh kéo theo style rác.
  • Ảnh: chụp xong nên nén dưới ~500 KB trước khi tải lên. Trong trình soạn thảo, bấm nút ảnh → chọn từ thư viện.

  • Bảng: gõ nhanh theo mẫu, mỗi dòng một hàng:

    | Thông số | Giá trị | Đơn vị |
| :--- | ---: | :--- |
| Đường kính ngoài | 114.3 | mm |

  • Công thức: dùng $...$ cho công thức trong dòng và $$...$$ cho công thức riêng một dòng.

  • Lưu nháp: bật Draft thay vì Publish. Bài nháp không hiện trên site cho đến khi bạn tắt Draft.

Cấu trúc một bài viết tốt

# Tiêu đề (chỉ một H1, thường trùng với tiêu đề bài)

Đoạn mở đầu: bài này giải quyết vấn đề gì, cho ai đọc.

<!-- more -->   <!-- phần trên hiện ở danh sách bài -->

## 1. Bối cảnh / giả thiết
## 2. Nội dung chính
### 2.1. Chi tiết
## 3. Kết luận và lưu ý

!!! warning "Lưu ý"
    Giới hạn áp dụng, điều cần kiểm tra lại.

Khi có sự cố

Hiện tượng Nguyên nhân thường gặp Cách xử lý
Đăng nhập lỗi Chưa cấp quyền OAuth, hoặc tài khoản không có quyền ghi repo Đăng xuất, đăng nhập lại; kiểm tra quyền trên GitHub
Bấm Publish không thấy bài Build đang chạy hoặc build lỗi Chờ 1–2 phút; xem log trong Cloudflare Pages
Ảnh không hiện Đường dẫn ảnh sai hoặc chưa upload xong Chèn lại ảnh từ thư viện media
Trang 404 sau khi đổi tên file URL cũ không còn tồn tại Giữ nguyên tên file sau khi đã đăng

Quy ước đặt tên file

Trang quản trị tự sinh tên file từ tiêu đề (bỏ dấu, nối bằng dấu gạch ngang). Tên file chính là URL bài viết, nên:

  • Nên: tinh-chieu-day-thanh-ong-asme-b31-3.md
  • Tránh: bai1.md, Untitled.md
  • Không đổi tên file sau khi đã chia sẻ link.
Viết bài