# Docs

- [Citely Docs](/docs): Tài liệu Citely — hướng dẫn sử dụng cho khách và tài liệu API cho nhà phát triển (Citely Connect / CPP).
- Hướng dẫn sử dụng
  - [Hướng dẫn sử dụng](/docs/guides): Hướng dẫn dùng Citely — tạo bài, kết nối website, xuất bản.
  - [Bắt đầu](/docs/guides/getting-started): Từ đăng ký đến bài viết đầu tiên trên Citely.
  - [Kết nối WordPress](/docs/guides/connect-wordpress): Cho Citely xuất bản lên WordPress của bạn bằng Application Password.
  - [Kết nối Google Search Console](/docs/guides/connect-google-search-console): Cấp quyền để Citely đọc thứ hạng và yêu cầu lập chỉ mục.
  - [Xuất bản bài viết](/docs/guides/publishing): Đẩy bài từ Citely ra website — WordPress hoặc site khác qua Citely Connect.
- Nhà phát triển
  - [Citely Connect — Tổng quan](/docs/developer): Giao thức Citely Publish Protocol (CPP v1) để đẩy bài viết đã hoàn thiện từ Citely ra website của bạn.
  - [Envelope (CPP v1)](/docs/developer/protocol-envelope): Cấu trúc JSON canonical của một bài viết mà Citely gửi ra khi publish.
  - [Receiver endpoint](/docs/developer/receiver): Endpoint website phải dựng — GET handshake năng lực + POST nhận bài.
  - [Ký & xác minh webhook](/docs/developer/webhook-signing): Citely ký mọi request bằng Standard Webhooks (HMAC-SHA256). Cách receiver xác minh.
  - [Mã lỗi CPP_*](/docs/developer/errors): Từ vựng lỗi & trạng thái publish dùng chung giữa Citely và receiver.
  - [Trạng thái bất đồng bộ (building → live)](/docs/developer/async-publish): Cách CPP mô hình hoá site tĩnh — nhận bài, build, rồi mới hiển thị.
  - Adapters
    - [citely-api (khuyến nghị)](/docs/developer/adapters/citely-api): Citely tự host nội dung — website chỉ là reader, không cần backend/receiver.
    - [db (site có database)](/docs/developer/adapters/db): Site runtime (Next SSR / Laravel / Astro SSR) — nhận bài, upsert vào DB, live ngay.
    - [fs-build (site tĩnh self-host)](/docs/developer/adapters/fs-build): Site tĩnh self-host trên VPS — ghi .md vào content, kích build, phục vụ dist mới.
  - [Read-API reference](/docs/developer/read-api): API đọc bài của adapter citely-api — endpoint, auth, phân trang, mã lỗi.