docs：从 Healthv2.0 复制研发过程性材料框架 + 转Word说明

2026-09-15 09:09:51 +08:00
parent 78458361fa
commit 78df903deb
2 changed files with 530 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 框架转 Word（.docx）说明
+
+> 当前环境（Git Bash）下未找到 `pandoc`，下面的方案需在你本机执行。
+
+---
+
+## 1. 安装 Pandoc（一次性）
+
+### 方案 A：winget（Windows 11 自带，推荐）
+```powershell
+winget install JohnMacFarlane.Pandoc
+```
+安装完关闭当前 PowerShell / Git Bash，重新打开。
+
+### 方案 B：Chocolatey
+```powershell
+choco install pandoc
+```
+
+### 方案 C：手动下载
+到 https://github.com/jgm/pandoc/releases 下载最新版 `pandoc-X.X.X-windows-x86_64.msi` 双击装即可。
+
+### 验证
+```powershell
+pandoc --version
+```
+看到版本号即成功。
+
+---
+
+## 2. 转 Word 命令
+
+打开 PowerShell 或 Git Bash，`cd` 到仓库根目录：
+
+### 2.1 最简转换
+```bash
+pandoc "docs/研发过程性材料-框架.md" -o "docs/研发过程性材料.docx"
+```
+
+### 2.2 生成带目录的版本（推荐甲方用）
+```bash
+pandoc "docs/研发过程性材料-框架.md" -o "docs/研发过程性材料.docx" \
+  --toc \
+  --toc-depth=3 \
+  -V lang=zh-CN \
+  -V mainfont="Microsoft YaHei" \
+  -V geometry:margin=2.5cm
+```
+
+### 2.3 加样式的版本（更正式）
+如果你有 `reference.docx` 模板（标题、表格、代码块样式）：
+```bash
+pandoc "docs/研发过程性材料-框架.md" \
+  -o "docs/研发过程性材料.docx" \
+  --reference-doc=docs/reference.docx \
+  --toc --toc-depth=3
+```
+
+---
+
+## 3. 填图/视频工作流
+
+1. 在 Word 中打开 `研发过程性材料.docx`。
+2. 找到每个 `[📷 图片占位 — 描述]`（Word 中显示为 Markdown 文本），删除占位符，**插入 → 图片**。
+3. 每个 `[🎬 视频占位 — 描述]`：**插入 → 联机视频**（B站/腾讯视频URL）或 **插入 → 对象 → 媒体**（本地 MP4）。
+4. 填完所有 `[📝 占位 ...]` 与代码片段。
+5. **最终交付前**：
+   - 检查所有 ⏳ 项，确认是否纳入正式交付
+   - 更新封面日期与版本号
+   - 导出 PDF 一并交付（`文件 → 另存为 → PDF`）
+
+---
+
+## 4. 备选方案（不装 Pandoc）
+
+| 方案 | 操作 | 优缺点 |
+|------|------|--------|
+| VSCode 插件 | 装 `Markdown PDF` / `Markdown Word` 扩展，右键导出 | 简单，但样式不如 Pandoc |
+| 在线工具 | `https://cloudconvert.com/md-to-docx` 上传 → 下载 | 零安装，但内容会过第三方服务器 |
+| Typora | 导入 md → 导出 docx | 商业软件，样式好 |
+| PowerShell + Word COM | 自动调用 Word.Application 转换（需 Word 已装） | 可批处理但脚本较复杂 |
+
+如要 PowerShell + Word COM 脚本，告诉我我写给你。
+
+---
+
+## 5. 文件位置
+
+| 文件 | 路径 |
+|------|------|
+| Markdown 源（你填这个） | `docs/研发过程性材料-框架.md` |
+| Word 输出（待生成） | `docs/研发过程性材料.docx` |
+| 图片（建议） | `docs/images/`（自己建） |
+| 视频（建议） | `docs/videos/`（自己建） |
+| 引用样式模板（可选） | `docs/reference.docx` |