Skip to content
Back to search

chuan-hoa-tai-lieu

SkillWorks with Claude CodeGitHub

Chuẩn hoá tài liệu Word (.docx) theo thể thức báo cáo nhà nước (Nghị định 30/2020/NĐ-CP) và quy ước báo cáo khoa học, luận văn. Gồm tạo mục lục, danh mục bảng/biểu đồ/hình tự động; đánh số chỉ mục, chương (số La Mã/Ả Rập); chú thích bảng biểu; phông, cỡ chữ, lề, giãn dòng; văn phong kỹ thuật (khẩu ngữ, câu dài, viết tắt, dấu câu, chính tả thống nhất); thể thức văn bản hành chính (quốc hiệu, tiêu ngữ, tên cơ quan, số ký hiệu, địa danh ngày tháng, tên loại, trích yếu, nơi nhận, vị trí và định dạng chữ ký); cỡ chữ, đậm/nghiêng từng thành phần và từng cấp tiêu đề; vị trí, kích thước ảnh; định dạng bảng; số trang; tạo văn bản mẫu đúng thể thức; kiểm tra số liệu, dấu thập phân, ngày tháng. Dùng khi người dùng nói "đánh mục lục", "danh mục bảng", "chuẩn hoá format", "format theo chuẩn nhà nước", "Nghị định 30", "kiểm tra thể thức", "quốc hiệu tiêu ngữ", "chữ ký", "nơi nhận", "soạn công văn/báo cáo/tờ trình mẫu", "văn phong", "rà soát câu chữ", "luận văn", "báo cáo".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/quangns--vn-doc-format/badge.svg)](/listings/quangns--vn-doc-format)

HTML

<a href="/listings/quangns--vn-doc-format"><img src="/api/listings/quangns--vn-doc-format/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 134 lines
  1. ---
  2. name: chuan-hoa-tai-lieu
  3. description: Chuẩn hoá tài liệu Word (.docx) theo thể thức báo cáo nhà nước (Nghị định 30/2020/NĐ-CP) và quy ước báo cáo khoa học, luận văn. Gồm tạo mục lục, danh mục bảng/biểu đồ/hình tự động; đánh số chỉ mục, chương (số La Mã/Ả Rập); chú thích bảng biểu; phông, cỡ chữ, lề, giãn dòng; văn phong kỹ thuật (khẩu ngữ, câu dài, viết tắt, dấu câu, chính tả thống nhất); thể thức văn bản hành chính (quốc hiệu, tiêu ngữ, tên cơ quan, số ký hiệu, địa danh ngày tháng, tên loại, trích yếu, nơi nhận, vị trí và định dạng chữ ký); cỡ chữ, đậm/nghiêng từng thành phần và từng cấp tiêu đề; vị trí, kích thước ảnh; định dạng bảng; số trang; tạo văn bản mẫu đúng thể thức; kiểm tra số liệu, dấu thập phân, ngày tháng. Dùng khi người dùng nói "đánh mục lục", "danh mục bảng", "chuẩn hoá format", "format theo chuẩn nhà nước", "Nghị định 30", "kiểm tra thể thức", "quốc hiệu tiêu ngữ", "chữ ký", "nơi nhận", "soạn công văn/báo cáo/tờ trình mẫu", "văn phong", "rà soát câu chữ", "luận văn", "báo cáo".
  4. ---
  5. # Chuẩn hoá tài liệu theo thể thức nhà nước
  6. Quy chuẩn chi tiết: [references/the-thuc-nd30.md](references/the-thuc-nd30.md). Đọc file này trước khi
  7. sửa, và khi báo cáo cho người dùng thì trích đúng quy định.
  8. ## Môi trường
  9. ```bash
  10. PY=/opt/shared/venvs/docx/bin/python # venv dùng chung, có python-docx
  11. S=/workspace/chuan-hoa-tai-lieu/scripts
  12. # nếu venv chưa có:
  13. # UV_PYTHON_INSTALL_DIR=/opt/shared/uv/python UV_CACHE_DIR=/opt/shared/uv/cache uv venv /opt/shared/venvs/docx
  14. # VIRTUAL_ENV=/opt/shared/venvs/docx uv pip install python-docx
  15. ```
  16. Máy không có Word/LibreOffice, nên số trang của mục lục chỉ có sau khi người dùng mở file và bấm **Ctrl+A → F9**.
  17. Luôn nhắc người dùng bước này.
  18. ## Quy trình
  19. 1. **Sao lưu.** Giữ bản gốc: `"<tên> (bản gốc trước khi chuẩn hoá).docx"` (`cp -n`). Làm việc trên bản sao ở `/tmp`.
  20. Tên file tiếng Việt có thể ở dạng Unicode NFD: lấy tên bằng `ls`/glob, đừng gõ lại tên, nếu không sẽ sinh
  21. ra 2 file trùng tên hiển thị.
  22. 2. **Kiểm tra** (chỉ đọc):
  23. ```bash
  24. $PY $S/audit_docx.py file.docx # thêm --json nếu cần xử lý tiếp
  25. ```
  26. Báo cáo các mục: khổ và lề trang, phông và cỡ chữ, tiêu đề chưa gán style (nên không lên mục lục), tiêu đề cùng cấp
  27. dùng style khác nhau, số chỉ mục trùng hoặc nhảy cóc, tên chương ghi không thống nhất, chú thích bảng/biểu đồ/hình
  28. trùng số, thiếu số, sai dấu hoặc bị tách đoạn, mục lục gõ tay hoặc lỗi "Error! Bookmark", dấu thập phân, dấu ±.
  29. Với văn bản hành chính, kiểm tra thêm: thiếu thành phần thể thức; cỡ, đậm, nghiêng, in hoa, canh lề của từng thành phần
  30. (so với bảng ở mục 1a của reference); quốc hiệu, tiêu ngữ ghi sai; thiếu đường kẻ; số văn bản, ngày tháng thiếu số 0;
  31. dấu cuối dòng nơi nhận; khối chữ ký không nằm cùng hàng với nơi nhận. Kiểm tra cả ảnh (nổi, tràn lề, chưa canh giữa,
  32. chú thích sai vị trí), bảng (tên bảng sai vị trí, không viền, không lặp dòng tiêu đề, tràn lề, cỡ chữ) và số trang.
  33. **Văn phong kỹ thuật** (`scripts/van_phong.py`, tắt bằng `--no-van-phong`): khẩu ngữ, từ cảm tính, chủ quan, dấu
  34. chấm than; câu trên 70 âm tiết, đoạn quá dài; lặp từ; dấu câu và khoảng trắng; khoảng giá trị và ngoặc kép không
  35. thống nhất; số viết liền đơn vị; chữ viết tắt chưa giải thích lần đầu, chưa có hoặc thừa trong Danh mục chữ viết tắt,
  36. chỉ dùng 1 lần; i/y và dấu thanh không thống nhất; trộn "tôi" với "chúng tôi". Bỏ qua mục lục, tài liệu tham khảo,
  37. phụ lục.
  38. Số thứ tự `[i]` là chỉ số đoạn trong `doc.paragraphs`.
  39. 3. **Xem cấu trúc phần đầu** trước khi sửa: in khoảng 150 đoạn đầu kèm style và `instrText` để biết mục lục
  40. cũ là field hay gõ tay, và các tiêu đề "MỤC LỤC", "DANH MỤC …" nằm ở đâu.
  41. 4. **Sửa tự động** (không ghi đè file nguồn):
  42. ```bash
  43. $PY $S/fix_docx.py in.docx -o out.docx --all # toàn bộ
  44. $PY $S/fix_docx.py in.docx -o out.docx --headings --captions --toc # chỉ mục lục + danh mục
  45. ```
  46. | Cờ | Việc làm |
  47. |---|---|
  48. | `--page` | A4, lề `--margins 20,20,30,15` (trên,dưới,trái,phải mm) |
  49. | `--font` / `--font-runs` | Times New Roman cho style + docDefaults / cả run gán phông trực tiếp |
  50. | `--body` | Normal: cỡ `--size 13`, canh đều, thụt 1,27 cm, cách sau 6 pt, bỏ Tab đầu dòng; `--line 1.3` giãn dòng |
  51. | `--headings` | gán style tiêu đề theo số thứ tự (Chương/I. → cấp 1, 1.1./1. → cấp 2, 1.1.1. → cấp 3, 1.1.1.1. → cấp 4); dùng lại style tiêu đề sẵn có, nhân bản nếu một style đang gánh 2 cấp; đặt outline level |
  52. | `--chapter arabic\|roman` | thống nhất `Chương 1.` hoặc `Chương I.` |
  53. | `--heading-dot` | `3.1 Tên` → `3.1. Tên` |
  54. | `--captions` | style riêng cho từng loại Bảng/Biểu đồ/Hình; `Bảng 3.4:` → `Bảng 3.4.`; ghép chú thích bị Enter/Shift+Enter giữa câu; sửa "Biều đồ" |
  55. | `--toc` | xoá dòng mục lục gõ tay, thay field cũ hoặc chèn field TOC mới sau "MỤC LỤC", "DANH MỤC BẢNG/BIỂU ĐỒ/HÌNH (ẢNH)"; bật `updateFields`. Mục lục **chỉ tới cấp 3** (`1.1.1.`), không đưa `a)`, `b)`, `c)` vào; đổi bằng `--toc-levels` |
  56. | `--heading-format` | đặt định dạng cho style từng cấp: cấp 1 đậm cỡ 14 canh giữa (mục `I.` của báo cáo hành chính thì canh trái), cấp 2 đậm, cấp 3 đậm nghiêng, cấp 4 nghiêng; xoá đậm/nghiêng/cỡ/màu gán tay trong tiêu đề |
  57. | `--admin` | thể thức NĐ 30: sửa chữ quốc hiệu, tiêu ngữ; cỡ, đậm, nghiêng, in hoa, canh giữa cho từng thành phần; kẻ đường dưới tiêu ngữ, tên cơ quan, trích yếu (nếu chưa có); `Số: 05/`, `ngày 05 tháng 02`; nơi nhận (`Nơi nhận:`, `-` đầu dòng, `;` và `.` cuối dòng, `- Lưu: `); khối chữ ký in hoa, đậm, canh giữa, chừa ít nhất 3 dòng trống để ký |
  58. | `--images` | ảnh cùng dòng chữ: canh giữa, bỏ thụt, thu nhỏ theo tỷ lệ nếu tràn lề, gắn liền với chú thích dưới |
  59. | `--tables` | chỉ bảng có tên "Bảng …": rộng bằng vùng chữ, canh giữa, viền đơn 0,5 pt, dòng đầu đậm và lặp lại khi sang trang, không ngắt dòng giữa trang, cỡ `--table-size 12`, ô số canh giữa; `--tables-all` để chuẩn hoá cả bảng không có tên |
  60. | `--van-phong` | sửa lỗi trình bày văn phong có quy tắc rõ: khoảng trắng trước/sau dấu câu, trong ngoặc, khoảng trắng kép, `v.v...` → `v.v.`, `±` có cách hai bên, bỏ hư từ lặp (`trong trong`) |
  61. | `--don-vi` | cách số và đơn vị: `23,5mm` → `23,5 mm` (không đụng `%`, `°` và đơn vị 1 chữ dễ nhầm như `1A`, `3D`) |
  62. | `--dau-thanh moi\|cu` | thống nhất vị trí dấu thanh `hòa, khỏe, thủy` (mới) hoặc `hoà, khoẻ, thuỷ` (cũ); không nằm trong `--all` |
  63. | `--page-number` | số trang giữa lề trên, ẩn trang đầu (chỉ khi chưa có số trang và header trống) |
  64. | `--all` | tất cả trừ `--chapter`, `--line`, `--tables-all`, `--dau-thanh` |
  65. Muốn đổi cỡ chữ mặc định của thành phần thể thức thì sửa `SIZES` trong `scripts/the_thuc.py` (vẫn phải nằm
  66. trong khoảng NĐ 30 ghi chú bên cạnh).
  67. Đọc kỹ log, nhất là các dòng `!!`. Rồi chạy lại `audit_docx.py` trên file kết quả để xác nhận.
  68. **Tạo văn bản mới đúng thể thức** (báo cáo, kế hoạch, tờ trình, công văn…):
  69. ```bash
  70. $PY $S/tao_mau.py -o bao-cao.docx --loai "BÁO CÁO" --chu-quan "BỘ Y TẾ" --co-quan "BỆNH VIỆN X" \
  71. --so 5 --ky-hieu BC-BVX --dia-danh "Hà Nội" --ngay 2026-11-19 --trich-yeu "Kết quả công tác năm 2026" \
  72. --quyen-han KT --cap-tren "Giám đốc" --chuc-vu "Phó Giám đốc" --nguoi-ky "Nguyễn Văn A" \
  73. --noi-nhan "Bộ Y tế;Ban Giám đốc"
  74. $PY $S/tao_mau.py -o cv.docx --loai "CÔNG VĂN" --trich-yeu "Về việc ..." --kinh-gui "Sở Y tế;Bệnh viện A"
  75. ```
  76. File mẫu có sẵn trong `mau/`: `bao-cao-mau.docx`, `cong-van-mau.docx`, và một cặp ví dụ trước/sau khi chạy
  77. `fix_docx.py --all` (`vi-du-sai-the-thuc.docx` → `vi-du-sau-khi-sua.docx`).
  78. Kết quả: khổ A4, lề chuẩn, bảng đầu trang và bảng chữ ký 2 cột không viền, các đường kẻ, số trang. Phần nội dung là
  79. đoạn mẫu để thay bằng nội dung thật.
  80. 5. **Sửa tay phần script không làm** (viết Python riêng bằng python-docx khi cần):
  81. - Tiêu đề không theo mẫu số (ví dụ `2 Tồn tại` thiếu dấu chấm, không in đậm) thì gán style bằng tay.
  82. - Số trang La Mã cho phần đầu: cần section break, hướng dẫn người dùng làm trong Word nếu không chắc chắn.
  83. - Ảnh nổi (wrap text) hoặc đường kẻ vẽ bằng shape lệch vị trí: hướng dẫn người dùng chọn "In line with text" trong Word.
  84. - Văn bản hành chính không trình bày bằng bảng 2 cột (quốc hiệu và tên cơ quan nằm ở 2 đoạn rời): script vẫn định dạng
  85. chữ nhưng không dàn được 2 cột. Dựng lại phần đầu bằng `tao_mau.py` rồi chép nội dung sang.
  86. 6. **Văn phong: chỉ tự sửa lỗi trình bày.** Câu dài, khẩu ngữ, chủ quan, viết tắt, i/y, ngôi xưng thì liệt kê kèm vị trí
  87. và gợi ý theo mục 10 của reference. Nếu người dùng nhờ viết lại câu thì đề xuất câu mới để họ duyệt, không tự thay
  88. hàng loạt. Giữ nguyên trích dẫn, tên riêng, thuật ngữ chuyên ngành.
  89. 7. **Không tự sửa nội dung học thuật/số liệu.** Không đánh lại số chương, mục, bảng khi bị trùng/thiếu; không đổi
  90. dấu thập phân hàng loạt (dấu phẩy còn là dấu liệt kê, dấu chấm còn là phân cách nghìn). Liệt kê cụ thể để
  91. người viết quyết định. Chỉ sửa chính tả hiển nhiên ở chú thích ("Biều" → "Biểu") và ghi rõ trong báo cáo.
  92. 8. **Lưu và báo cáo.** Ghi đè file đích (giữ bản gốc), sau đó báo cáo theo 3 nhóm: đã sửa tự động, cần người dùng bấm
  93. F9, lỗi nội dung cần tác giả quyết định (kèm vị trí và trích đoạn).
  94. ## Lưu ý kỹ thuật (đã gặp)
  95. - **Nhân bản style từ Normal phải xoá `w:default="1"`.** Nếu không, cả văn bản sẽ nhận style mới làm style mặc định.
  96. `new_style()` trong `fix_docx.py` đã xử lý việc này.
  97. - **Dấu phân cách trong `\t "style,1,style,2"`** phụ thuộc cài đặt vùng của Word. Dùng theo field có sẵn trong file
  98. (`list_sep()`), mặc định là dấu phẩy.
  99. - **Field TOC cũ trải trên nhiều đoạn**: từ `fldChar begin` đến `fldChar end` khớp cấp. Thay cả vùng đó, không chèn
  100. thêm field mới bên cạnh (`_field_end()`).
  101. - **Mục lục gõ tay** thường có Tab + số trang, hoặc là dòng trùng chữ với tiêu đề thật phía sau (ví dụ "DANH MỤC BẢNG"
  102. nằm ngay dưới "MỤC LỤC").
  103. - **Thứ tự phần tử OOXML**: `w:outlineLvl` phải đứng trước `w:rPr` trong `w:pPr`; `w:rFonts` phải đứng sau `w:rStyle`;
  104. không lồng `w:r` trong `w:r`. Sai thứ tự thì Word báo "unreadable content".
  105. - **Tiêu đề phần đầu đã có style riêng** (ví dụ `001`, `Heading 1`): giữ nguyên style, chỉ thêm style đó vào field mục lục.
  106. - **Chú thích ngay dưới hình** (biểu đồ, hình): không ghép đoạn có ảnh (`w:drawing`) hoặc đoạn bắt đầu bằng "Nguồn",
  107. "Nhận xét".
  108. - **Nhận diện thành phần thể thức** dựa trên chữ (`the_thuc.detect_layout`): quốc hiệu, tiêu ngữ, `Số:` và địa danh
  109. ngày tháng tìm trong khoảng 60 đoạn đầu (kể cả trong bảng); tên cơ quan là các dòng IN HOA đứng trước `Số:` trong
  110. cùng ô; khối chữ ký là ô bên phải cùng hàng với `Nơi nhận:`, trong đó dòng cuối là họ tên, các dòng trên là chức vụ.
  111. Nếu người dùng bố cục khác, chạy `audit_docx.py` trước để xem script nhận ra những thành phần nào.
  112. - **Đường kẻ** dưới tiêu ngữ, tên cơ quan, trích yếu: là một đoạn trống cao 2 pt có viền dưới và thụt trái/phải đều
  113. nhau để vạch kẻ có độ dài mong muốn (`add_rule_after`). Không thêm nếu đã có shape, viền hoặc gạch chân.
  114. - **Bảng bố cục và bảng số liệu**: bảng có chữ quốc hiệu, "Nơi nhận", "Số:", hoặc không viền và ≤ 2 cột ≤ 4 dòng là bảng
  115. bố cục, không động vào. Bảng số liệu chỉ tính bảng có tên "Bảng …" ngay trên hoặc dưới.
README.md · README · 203 lines
  1. # vn-doc-format: Thể thức văn bản theo Nghị định 30/2020/NĐ-CP – Công cụ chuẩn hoá file Word (.docx) tự động
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  3. ![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)
  4. ![Định dạng: .docx](https://img.shields.io/badge/%C4%91%E1%BB%8Bnh%20d%E1%BA%A1ng-.docx-informational.svg)
  5. Công cụ mã nguồn mở giúp **kiểm tra và tự động định dạng văn bản Word đúng thể thức Nghị định 30/2020/NĐ-CP về công
  6. tác văn thư**. Công cụ cũng chuẩn hoá **luận văn, khoá luận, báo cáo khoa học, báo cáo tổng kết, công văn, tờ trình,
  7. kế hoạch** theo cách trình bày phổ biến ở Việt Nam. Với một file `.docx`, công cụ có thể:
  8. - **tạo mục lục tự động** và **danh mục bảng, danh mục biểu đồ, danh mục hình** tự động;
  9. - **đánh số chương, mục, tiểu mục** thống nhất (số La Mã, số Ả Rập);
  10. - đặt **font Times New Roman**, **cỡ chữ 13–14**, **căn lề chuẩn** (trên, dưới 20–25 mm; trái 30–35 mm; phải 15–20 mm),
  11. khổ A4, giãn dòng, **đánh số trang**;
  12. - trình bày đúng **quốc hiệu, tiêu ngữ**, tên cơ quan, số và ký hiệu, địa danh và ngày tháng, tên loại, trích yếu,
  13. **nơi nhận**, **vị trí chữ ký**;
  14. - định dạng **bảng biểu, hình ảnh** và chú thích;
  15. - rà soát **văn phong hành chính, văn phong khoa học**.
  16. Dùng được qua dòng lệnh (Python) hoặc làm skill cho Claude Code ([SKILL.md](SKILL.md)).
  17. > **Từ khoá:** thể thức văn bản hành chính, định dạng văn bản theo Nghị định 30, cách trình bày văn bản hành chính,
  18. > font chữ văn bản hành chính, căn lề văn bản chuẩn, cỡ chữ quốc hiệu tiêu ngữ, tạo mục lục tự động trong Word,
  19. > danh mục bảng biểu luận văn, format luận văn thạc sĩ, chuẩn hoá báo cáo, kiểm tra lỗi trình bày văn bản.
  20. > (Không dấu: the thuc van ban nghi dinh 30, dinh dang van ban hanh chinh, tao muc luc tu dong word, format luan van.)
  21. ---
  22. ## Mục lục
  23. - [Dùng cho ai?](#dùng-cho-ai)
  24. - [Tính năng](#tính-năng)
  25. - [Tóm tắt quy định thể thức Nghị định 30](#tóm-tắt-quy-định-thể-thức-nghị-định-30)
  26. - [Cài đặt](#cài-đặt)
  27. - [Hướng dẫn sử dụng](#hướng-dẫn-sử-dụng)
  28. - [Ví dụ kết quả kiểm tra](#ví-dụ-kết-quả-kiểm-tra)
  29. - [Câu hỏi thường gặp](#câu-hỏi-thường-gặp)
  30. - [English summary](#english-summary)
  31. - [Giấy phép](#giấy-phép)
  32. ## Dùng cho ai?
  33. - **Cán bộ văn thư, chuyên viên** soạn công văn, báo cáo, tờ trình, kế hoạch, quyết định cần đúng thể thức
  34. Nghị định 30/2020/NĐ-CP.
  35. - **Học viên cao học, sinh viên, nghiên cứu sinh** cần định dạng luận văn, khoá luận, luận án: mục lục, danh mục
  36. bảng, danh mục biểu đồ, đánh số chương mục, chú thích bảng và hình.
  37. - **Nhóm nghiên cứu, đơn vị sự nghiệp** cần chuẩn hoá báo cáo khoa học, báo cáo đề tài.
  38. ## Tính năng
  39. ### 1. Kiểm tra thể thức văn bản – `scripts/audit_docx.py`
  40. Chỉ đọc file và liệt kê lỗi kèm vị trí, không sửa gì:
  41. - khổ giấy, lề trang, font chữ, cỡ chữ, số trang;
  42. - tiêu đề chưa gán style (nên không lên mục lục), **số chương, mục bị trùng hoặc nhảy cóc**, tên chương ghi không
  43. thống nhất (`Chương 1.` / `Chương II:`);
  44. - chú thích **bảng, biểu đồ, hình** trùng số, thiếu số, sai thứ tự, sai dấu, bị ngắt dòng; mục lục gõ tay; lỗi
  45. "Error! Bookmark not defined";
  46. - **thành phần thể thức**: quốc hiệu, tiêu ngữ, tên cơ quan, số ký hiệu, ngày tháng, tên loại, trích yếu, nơi nhận,
  47. chữ ký. Kiểm tra cỡ chữ, in đậm, in nghiêng, in hoa, căn giữa, đường kẻ;
  48. - **ảnh**: ảnh nổi (wrap), ảnh tràn lề, ảnh chưa căn giữa, chú thích sai vị trí; **bảng**: tên bảng sai vị trí, không có
  49. viền, không lặp dòng tiêu đề, tràn lề;
  50. - **văn phong**: khẩu ngữ, từ chủ quan, câu quá dài, lặp từ, dấu câu, số viết liền đơn vị, chữ viết tắt chưa giải
  51. thích, i/y và dấu thanh không thống nhất (`hoà`/`hòa`), dấu thập phân.
  52. ### 2. Tự động sửa – `scripts/fix_docx.py`
  53. | Tuỳ chọn | Việc làm |
  54. |---|---|
  55. | `--page` | khổ A4, căn lề 20–20–30–15 mm |
  56. | `--font` `--body` | font Times New Roman, cỡ 13, căn đều, thụt đầu dòng 1,27 cm, cách đoạn 6 pt |
  57. | `--headings` `--heading-format` | gán style tiêu đề theo số thứ tự, định dạng đậm và nghiêng thống nhất theo cấp |
  58. | `--toc` | **mục lục tự động** (tối đa 3 cấp), **danh mục bảng, biểu đồ, hình** tự động, xoá mục lục gõ tay |
  59. | `--captions` | chuẩn hoá chú thích `Bảng 3.1.`, `Biểu đồ 3.1.`, `Hình 1.1.` |
  60. | `--chapter arabic\|roman` | thống nhất `Chương 1.` hoặc `Chương I.` |
  61. | `--admin` | quốc hiệu, tiêu ngữ, tên cơ quan, `Số: 05/…`, `ngày 05 tháng 02`, nơi nhận, khối chữ ký, đường kẻ |
  62. | `--images` `--tables` | căn giữa và thu nhỏ ảnh vừa lề; bảng rộng bằng vùng chữ, có viền, dòng tiêu đề lặp lại |
  63. | `--page-number` | số trang giữa lề trên, ẩn ở trang đầu |
  64. | `--van-phong` `--don-vi` `--dau-thanh` | khoảng trắng, dấu câu, `23,5mm` → `23,5 mm`, dấu thanh `hòa/thủy` |
  65. | `--all` | chạy tất cả |
  66. Công cụ **không** tự đánh lại số chương, bảng và **không** sửa câu chữ. Các lỗi nội dung chỉ được liệt kê để người
  67. viết quyết định.
  68. ### 3. Tạo văn bản hành chính mẫu – `scripts/tao_mau.py`
  69. Sinh khung **báo cáo, kế hoạch, tờ trình, công văn**… đúng thể thức: bảng đầu trang (cơ quan, quốc hiệu, tiêu ngữ),
  70. tên loại và trích yếu, khối nơi nhận và chữ ký, số trang. Xem file mẫu trong thư mục [`mau/`](mau/).
  71. ## Tóm tắt quy định thể thức Nghị định 30
  72. Bản đầy đủ: [references/the-thuc-nd30.md](references/the-thuc-nd30.md). Tài liệu này gồm bố cục trang, đánh số,
  73. bảng biểu, mục lục, chữ số, ngày tháng, viết hoa, chữ viết tắt và văn phong.
  74. | Thành phần | Cỡ chữ | Kiểu chữ |
  75. |---|---|---|
  76. | Quốc hiệu `CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM` | 12–13 | IN HOA, đứng, đậm |
  77. | Tiêu ngữ `Độc lập - Tự do - Hạnh phúc` | 13–14 | đứng, đậm, có đường kẻ bên dưới |
  78. | Tên cơ quan ban hành | 12–13 | IN HOA, đứng, đậm |
  79. | `Số: 05/BC-UBND` | 13 | đứng |
  80. | Địa danh, ngày tháng | 13–14 | nghiêng |
  81. | Tên loại văn bản (BÁO CÁO, KẾ HOẠCH…) | 13–14 | IN HOA, đứng, đậm |
  82. | Nội dung văn bản | 13–14 | đứng; giãn dòng 1–1,5; cách đoạn ≥ 6 pt |
  83. | Quyền hạn, chức vụ người ký | 13–14 | IN HOA, đứng, đậm |
  84. | Họ tên người ký | 13–14 | đứng, đậm |
  85. | `Nơi nhận:` / danh sách nơi nhận | 12 / 11 | nghiêng đậm / đứng |
  86. Khổ A4, font **Times New Roman** (Unicode TCVN 6909:2001). **Lề trên, dưới 20–25 mm; lề trái 30–35 mm; lề phải
  87. 15–20 mm.** Số trang đặt giữa lề trên, không hiện ở trang đầu.
  88. ## Cài đặt
  89. Cần Python 3.9 trở lên.
  90. ```bash
  91. git clone https://github.com/quangns/vn-doc-format.git
  92. cd vn-doc-format
  93. python3 -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
  94. pip install python-docx
  95. ```
  96. ## Hướng dẫn sử dụng
  97. ```bash
  98. # 1. Kiểm tra lỗi thể thức, văn phong
  99. python scripts/audit_docx.py "bao-cao.docx"
  100. # 2. Chuẩn hoá toàn bộ (không ghi đè file gốc)
  101. python scripts/fix_docx.py "bao-cao.docx" -o "bao-cao-chuan.docx" --all
  102. # Chỉ tạo mục lục, danh mục bảng, danh mục biểu đồ cho luận văn
  103. python scripts/fix_docx.py "luan-van.docx" -o "luan-van-muc-luc.docx" --headings --captions --toc
  104. # 3. Tạo báo cáo mẫu đúng thể thức
  105. python scripts/tao_mau.py -o bao-cao.docx --loai "BÁO CÁO" --chu-quan "UBND TỈNH A" --co-quan "SỞ Y TẾ" \
  106. --so 5 --ky-hieu BC-SYT --dia-danh "Hà Nội" --ngay 2026-11-19 --trich-yeu "Kết quả công tác năm 2026" \
  107. --quyen-han KT --cap-tren "Giám đốc" --chuc-vu "Phó Giám đốc" --nguoi-ky "Nguyễn Văn A" \
  108. --noi-nhan "UBND tỉnh;Ban Giám đốc"
  109. python scripts/fix_docx.py --help # xem đầy đủ tuỳ chọn
  110. ```
  111. Sau khi chạy, mở file bằng **Microsoft Word** rồi nhấn **Ctrl + A → F9** để Word cập nhật mục lục, danh mục và số
  112. trang.
  113. ## Ví dụ kết quả kiểm tra
  114. ```text
  115. == KIỂM TRA THỂ THỨC: vi-du-sai-the-thuc.docx
  116. ## Trang giấy (khổ, lề)
  117. - section 1: khổ 215.9×279.4 mm (cần A4 210×297); lề trên 25.4 (20–25); lề phải 31.8 (15–20)
  118. - chưa có số trang (giữa lề trên, ẩn trang đầu)
  119. ## Cỡ/kiểu chữ thành phần thể thức
  120. - Quốc hiệu "CỘNG HOÀ XÃ HỘI CHỦ NGHĨA VIỆT NAM": cỡ 14 (cần 12–13), cần in đậm, cần canh giữa
  121. - Tiêu ngữ "Độc Lập – Tự Do – Hạnh Phúc": cỡ 11 (cần 13–14), cần in đậm, cần canh giữa
  122. - "Nơi nhận:" "Nơi nhận": cỡ 11 (cần 12), cần in đậm, cần in nghiêng
  123. ## Cách ghi thành phần thể thức
  124. - "Số 5/BC-SYT": số nhỏ hơn 10 phải thêm 0 (Số: 05/...)
  125. - "Hà Nội, ngày 3 tháng 2 năm 2026": ngày < 10 và tháng 1, 2 phải thêm 0
  126. ```
  127. Sau khi chạy `fix_docx.py --all`, kết quả là [`mau/vi-du-sau-khi-sua.docx`](mau/vi-du-sau-khi-sua.docx), không còn
  128. lỗi.
  129. ## Câu hỏi thường gặp
  130. **Nghị định 30/2020 quy định font chữ và cỡ chữ văn bản hành chính như thế nào?**
  131. Font Times New Roman (bộ mã Unicode TCVN 6909:2001), màu đen. Cỡ chữ phần nội dung từ 13 đến 14. Quốc hiệu cỡ 12–13
  132. in hoa đậm; tiêu ngữ cỡ 13–14 đậm.
  133. **Căn lề văn bản theo Nghị định 30 là bao nhiêu?**
  134. Lề trên 20–25 mm, lề dưới 20–25 mm, lề trái 30–35 mm, lề phải 15–20 mm, khổ giấy A4.
  135. **Làm sao tạo mục lục, danh mục bảng, danh mục biểu đồ tự động cho luận văn?**
  136. Chạy `fix_docx.py --headings --captions --toc`. Công cụ gán style cho tiêu đề và chú thích, rồi chèn trường mục lục
  137. (TOC) của Word. Mở file, nhấn Ctrl + A → F9 để cập nhật số trang.
  138. **Ngày tháng trong văn bản hành chính ghi thế nào?**
  139. `Hà Nội, ngày 05 tháng 02 năm 2026`: ngày nhỏ hơn 10 và tháng 1, 2 thêm số 0 phía trước, dòng này in nghiêng.
  140. **Công cụ có sửa nội dung văn bản không?**
  141. Không. Công cụ chỉ sửa trình bày (định dạng, khoảng trắng, dấu câu, số 0 trong ngày tháng…). Số chương, bảng bị trùng
  142. hay câu văn chưa chuẩn chỉ được liệt kê để người viết tự sửa. File gốc không bị ghi đè.
  143. **Có dùng được với Google Docs, LibreOffice không?**
  144. Công cụ đọc và ghi định dạng `.docx`. Có thể tải file từ Google Docs về dạng `.docx` để xử lý. Riêng mục lục cần mở
  145. bằng Microsoft Word để cập nhật (LibreOffice: Tools → Update → Update All).
  146. ## English summary
  147. **Vietnamese document formatting checker and auto-formatter for Word (.docx)** following *Decree 30/2020/ND-CP* on
  148. clerical work (official administrative document format in Vietnam) and common conventions for theses and research
  149. reports. It audits and fixes page setup, Times New Roman fonts, margins, heading numbering, automatic table of
  150. contents and lists of tables/figures, captions, the national title and motto block, signature block, tables, images,
  151. page numbers, and technical writing style. Written in Python with `python-docx`; also usable as a Claude Code skill.
  152. ## Giấy phép
  153. Phát hành theo giấy phép [MIT](LICENSE). Bạn được tự do sử dụng, sửa đổi và phân phối lại.
  154. Tài liệu quy chuẩn trong repo là bản tóm tắt để tra cứu nhanh. Khi cần căn cứ pháp lý, hãy đối chiếu với văn bản
  155. gốc của Nghị định 30/2020/NĐ-CP.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.