Package: gbt9704 Version: 0.1.4 Date: 2026-07-29 License: LPPL-1.3c

======================================== LaTeX Class for GB/T 9704-2012

Chinese Official Document Format

This package provides a LaTeX document class for typesetting documents according to the Chinese national standard GB/T 9704-2012 (Format of official documents of party and government organs).

REQUIREMENTS

• TeX Live 2020 or later (LuaLaTeX recommended)
• CTEX package (included in TeX Live)
• memoir class (included in TeX Live)
• Required LaTeX packages (all in TeX Live):
  • iftex, fontspec, xcolor, graphicx, array, booktabs, longtable, caption, subcaption, ulem, alltt, indentfirst, fcolumn
• Required: bxcoloremoji + twemojis for colored emoji (LuaLaTeX). Install via: tlmgr install bxcoloremoji twemojis The emoji are rendered as colored PDF vector graphics — no emoji system fonts required. When using XeLaTeX, falls back to system emoji fonts (Segoe UI Emoji or NotoEmoji).
• Fonts:
  • FangSong, SimHei, KaiTi, SimSun (standard Windows/Chinese fonts)
  • FZDaBiaoSong-B06 (FangZheng DaBiaoSong) for red headers. If not installed, the class will automatically fall back to SimHei with fake bold, with a warning message.
  • Sarasa Mono SC (CJK monospace) + DejaVu Sans Mono (box-drawing)
• Optional: zhlineskip (2026/06/30+) for CJK-aware line spacing control. Install via: tlmgr install zhlineskip

OPTIONS

• redline / noredline : Enable/disable red separator line under the red header. (Default: noredline)
• titleindent / notitleindent : Enable/disable first-line indentation for section titles. (Default: titleindent, complying with standard)
• zhlineskip : Enable zhlineskip package for CJK-aware proportional line spacing. Sets bodytextleadingratio=1.75 (28pt/16pt) and restores Western math leading. (Default: off)
• emoji / noemoji : Enable/disable emoji support. (Default: emoji)
  • LuaLaTeX: colored PDF vector graphics via bxcoloremoji→twemojis.
  • XeLaTeX: black-and-white via Segoe UI Emoji / NotoEmoji font fallback.

USAGE EXAMPLE

documentclassredline,zhlineskip{gbt9704} title{文件标题} begin{document} maketitle section{一、总体要求} subsection{（一）指导思想} 正文内容... end{document}

MAIN COMMANDS

• gongwentitle{...} - Main title (No.2 DaBiaoSong, centered)
• gongwensubtitle{...} - Subtitle (No.3 FangSong, centered)
• makeheader{Org}{Num}{Sig} - Red header with issuing organ, document number, and signatory
• mainreceiver{...} - Main receiver (left-aligned, no indent)
• attachmentHZ{...} - Single attachment (with "附件：" prefix, 2-character indent)
• attachmentNOHZ{...} - Single attachment (without prefix, 5-character indent, aligned with first)
• attachments environment - Multiple attachments with attachmentitem
• signature{...} - Signature (right-aligned, 2-char indent)
• signdate{...} - Date (right-aligned, 2-char indent)
• notes{...} - Notes in parentheses (no indent)
• copyto{...} - CC list (no indent, "抄送：" prefix)
• issueinfo{Org}{Date} - Issuing organ and date (left+right)
• seprule - Separator line for page footer area
• emoji{...} - Insert a colored emoji (LuaLaTeX only). Uses bxcoloremoji → twemojis pipeline: each emoji is a colored PDF vector graphic. Example: emoji{👍} renders as 👍. No system emoji font required. Use 'noemoji' option to disable.

HEADING FORMATS (GB/T 9704-2012)

• Heading 1 (一、): SimHei (黑体), No.3, 2-char indent
• Heading 2 (（一）): KaiTi bold (楷体加粗), No.3, 2-char indent
• Heading 3 (1.): FangSong bold (仿宋加粗), No.3, 2-char indent

RECOMMENDED COMPANION PACKAGES

• zhlineskip (2026/06/30+) — CJK-aware proportional line spacing with independent bodytext/footnote/math leading control. Built-in support via the zhlineskip class option. Install via: tlmgr install zhlineskip

KNOWN ISSUES / LIMITATIONS

• The class requires LuaLaTeX (recommended) or XeLaTeX; pdflatex is not supported due to font encoding requirements.
• Colored emoji (emoji{}) requires LuaLaTeX. Uses bxcoloremoji→twemojis pipeline (PDF vector graphics), not system emoji fonts. Emoji inside verbatim environments will not render — use emoji{} outside verbatim.

INSTALLATION

Copy gbt9704.cls to: $TEXMF/tex/latex/gbt9704/ or simply place it in the same folder as your .tex file.

Compile with LuaLaTeX: lualatex document.tex

CONTRIBUTION & FEEDBACK

Bugs, feature requests, and contributions are welcome. Please submit via https://codeberg.org/songwupei/latex-gbt9704 or email: songwupei@163.com

CHANGELOG

v0.1.4 (2026-07-29) - Section numbering and ctex heading integration.

• Section numbering: Chinese numerals (一、（一）、1.) per GB/T 9704-2012.
• Switched heading styles from memoir setsecheadstyle to ctex ctexset for correct font rendering with heading=true.
• Fixed attachment spacing: removed extra vspace between attachment items.
• Various documentation fixes and cleanup.

v0.1.3 (2026-07-28) - Dual-engine emoji and financial tables.

• Unified cls supports both LuaLaTeX (colored vectors) and XeLaTeX (font fallback).
• Dual-engine emoji: bxcoloremoji→twemojis (LuaLaTeX) or Segoe UI Emoji/NotoEmoji (XeLaTeX).
• Built-in financial table support via fcolumn package (C and N column types).
• Added gongwenbody environment and setgongwenlinespread command.
• New dependencies: fcolumn, alltt, Sarasa Mono SC, DejaVu Sans Mono.
• Font fallback for FZDaBiaoSong (graceful degradation to SimHei).
• Memoir-native title indent via setsecindent (cleaner, hyperref-compatible).
• Soul/ulem CJK compatibility fix in AtBeginDocument.

v0.1.2 (2026-07-28) - Engine upgrade and colored emoji support.

• Switch primary engine from XeLaTeX to LuaLaTeX.
• Add colored emoji support via bxcoloremoji → twemojis pipeline: each emoji renders as a colored PDF vector graphic (no system emoji fonts required). Uses TeX number + Lua dec-to-hex conversion to bridge Unicode input to twemojis name lookup.
• Add emoji{<character>} command and noemoji class option.
• Update documentation: two-column code/render layout for all emoji examples (verbatim+emoji incompatibility resolved).

v0.1.1 (2026-07-06) - Feature update.

• Add zhlineskip class option for CJK-aware proportional line spacing (bodytextleadingratio=1.75, footnoteleadingratio=1.75, restoremathleading).
• H2 (subsection): 楷体加粗 (kaishubfseries).
• H3 (subsubsection): 仿宋加粗 (normalfontbfseries).
• signature and signdate: add 2-character right indent.

v0.1 (2026-06-22) - Initial Beta release.

• Core functionality for GB/T 9704-2012 compliance.
• Font fallback mechanism for FZDaBiaoSong.
• Options: redline, titleindent.
• Commands: title, section/subsection, attachments, signature, etc.