# 框架转 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` |