---
url: https://docs.danghong.me/sites/docs/ops.md
description: >-
  Vận hành docs.danghong.me: chạy local, cổng kiểm npm run check, build, deploy
  bằng wrangler, chuyển hướng URL cũ, việc còn mở.
---

# docs.danghong.me Ops

| Hạng mục | Giá trị |
| :--- | :--- |
| Domain | `docs.danghong.me` (CNAME → `danghong-docs.pages.dev`) |
| Mã nguồn | `docs/` |
| Pages project | `danghong-docs` |
| Build | `npm run build` → `docs/.vitepress/dist` |
| Deploy | GitHub Actions `deploy-docs.yml` (đang lỗi, [Infrastructure](../../ecosystem/infrastructure.md) I5); tạm thời deploy tay |

## Lệnh

```bash
cd docs
npm install
npm run dev       # http://localhost:5173
npm run check     # cổng kiểm: frontmatter, description, link, cỡ trang
npm run build     # build, kiểm link, sinh llms.txt
CLOUDFLARE_ACCOUNT_ID=574e12931f580feff7ebaf755990b8a2 npm run deploy
```

## Chuyển hướng

`docs/public/_redirects` giữ URL cũ hoạt động (301). CI job `docs` chạy `npm run check` rồi `npm run build`. Khi đổi hoặc xoá một trang đã công khai, thêm dòng vào file này.

## Việc còn mở

| # | Việc |
| :--- | :--- |
| DO2 | Sửa workflow deploy docs (I5). |