pengxiao
219232de74
以讲义内容为骨架迁移到标准目录格式： - officefile/ 主内容（12章 + 附录 + CC4SI补充） - dofile/ 代码示例（11个Python脚本） - data/ 图片资源 - output/ 生成输出（忽略） - Archive/ 归档旧目录（忽略） - .claude/skills/ 保留markdown-to-docx工具链 - .pandoc/ 保留CSL和本地化配置 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
35 lines
2.9 KiB
Markdown
35 lines
2.9 KiB
Markdown
# DOCX Template Rules
|
|
|
|
This file records Word-export rules that the template rendering pipeline tries to enforce.
|
|
|
|
## Non-negotiable layout rules
|
|
|
|
- Prefer the latest reviewed `.docx` as the `--reference-doc` when available; treat a `.dotx` as a base template.
|
|
- If the reference template contains Word shortcut bindings, generated `.docx` files should retain `word/customizations.xml` so style hotkeys such as `ALT+1` remain available. The render pipeline auto-copies these bindings when the reference template already contains them.
|
|
- Replace only the default header text. Keep first-page and even-page headers blank unless the editor file shows otherwise.
|
|
- Strip Pandoc body styles such as `FirstParagraph`, `BodyText`, and `Compact` so the reference template's body style wins.
|
|
- Keep screenshot/image paragraphs mapped to the custom style `图`.
|
|
- Map figure captions to the custom style `图题`.
|
|
- Apply Word `keep with next` to every `图` paragraph so each image stays on the same page as the following figure caption.
|
|
- Apply Word `keep with next` to every `表题1-1` paragraph so each table caption stays on the same page as the following table.
|
|
- Map only real note/warning labels such as `注：`, `注意：`, and `关键注意：` to the custom style `注意`.
|
|
- Keep generic explanatory lead-ins such as `说明：` and `解释：` in body text, or rewrite them into prose in the source manuscript.
|
|
- Remove the first-line indent from exported code-block paragraphs (`Source Code` / `代码清单`) so code starts flush-left inside the code block.
|
|
- Clear first-line indent for all paragraphs inside Word table cells so table content does not visually inherit body-text indentation.
|
|
- Align unordered-list text with the Chinese body-text first-line indent. Avoid Word's default deep bullet indentation; level-0 bullet text should start at the same visual column as a normal Chinese paragraph first line.
|
|
|
|
## Figure and table caption rules
|
|
|
|
- Figure captions must use the short form `图1-1 标题`.
|
|
- Table captions must use the short form `表1-1 标题`.
|
|
- Use hyphen serials such as `1-1`, not dotted serials such as `1.1`.
|
|
- Do not place explanatory text inside figure captions.
|
|
- If a source figure caption contains a second explanatory sentence, move that sentence into body text and keep only the short title in the caption.
|
|
- Figure and table captions should not end with a full stop.
|
|
|
|
## Editorial writing rules reflected in export
|
|
|
|
- When the text says `确认`, `确保`, or `检查`, provide an explicit verification action or acceptance signal nearby instead of leaving the confirmation vague.
|
|
- Prefer `如图1-1所示` style references in body text when explanation needs to point readers back to a screenshot.
|
|
- Treat structural rewrites separately from template rules. Examples: adding bridge sentences, converting numbered explanation lists into prose, or rewriting a subsection outline.
|