# physics-lab

**Repository Path**: omni331/physics-lab

## Basic Information

- **Project Name**: physics-lab
- **Description**: 大学物理实验报告（集美大学 通信2513）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-26
- **Last Updated**: 2026-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 物理实验（大学物理实验报告）

集美大学 · 大学物理实验报告归档与版本管理。

- **班级 / 学号 / 姓名：** 通信 2513 · 202221032059 · 王一飞
- **远端仓库：** https://gitee.com/omni331/physics-lab
- **本地路径：** `D:\Desktop\学生工作\物理实验`

## 目录结构

每个实验单独一个文件夹，文件夹内统一包含以下文件：

```
物理实验/
├── 实验十九-RC、RL电路的暂态过程/     # 实验名称文件夹
│   ├── 实验十九-...-实验报告.md      # Markdown 源文件（便于修改、公式为 LaTeX）
│   ├── 实验十九-...-实验报告.docx    # Word 正式稿（公式为 Word 原生公式，可编辑）
│   ├── 实验十九-...-实验报告.pdf     # 排版固定版（打印 / 提交）
│   ├── 实验十九-...-抄写稿.*         # 写字机用抄写稿（无小标题，8 页→7 页）
│   ├── 实验十九-...-单面稿.*         # 只写报告纸 3、4 面（含标题行）
│   ├── 实验十九-...-单面稿-无标题.*  # 同上，去掉报告纸上已印好的标题行
│   ├── 分板块/                        # 上述两页拆成 4 个板块，每个 1 页，便于分别对位
│   │   ├── 板块1-实验数据.docx/.md/.pdf
│   │   ├── 板块2-RC时间常数.docx/.md/.pdf
│   │   ├── 板块3-RL时间常数.docx/.md/.pdf
│   │   └── 板块4-结果与讨论.docx/.md/.pdf
│   └── ref_cn.docx                    # 中文排版模板（A4 + 宋体/黑体 + Boxed 样式）
├── README.md
├── build-report.py                    # 排版模板生成 / 页面设置修补 / 抄写稿生成
└── sync-gitee.ps1                     # 一键同步脚本
```

> 报告纸第 3、4 面的四个板块依次是：①（一）实验数据 ②（二）实验数据处理（1）RC 电路中时间常数 τ 及其不确定度 U_τ ③（2）RL 电路中时间常数 τ 及其不确定度 U_τ ④ 4 实验结果（结论）与讨论。

## 实验进度

| 实验 | 名称 | md | docx | pdf | 状态 |
| :---: | :--- | :---: | :---: | :---: | :---: |
| 十九 | RC、RL 电路的暂态过程 | ✅ | ✅ | ✅ | 已完成 |
| 二十 | 待补充 | — | — | — | 未开始 |

## 报告生成流程

**推荐：直接用现成的 Word 稿修改**，改完在 Word 里导出 PDF 即可。

需要从 Markdown 重新生成时（本机已具备完整工具链）：

```powershell
$pandoc = "C:\Users\wangf.004OMNI331\AppData\Roaming\Python\Python312\site-packages\pypandoc\files\pandoc.exe"
& $pandoc "报告.md" -f markdown+pipe_tables+tex_math_dollars -t docx --reference-doc="ref_cn.docx" -o "报告.docx"
python ..\build-report.py fix "报告.docx"      # 确保 A4 页面设置（重要）
```

- `pandoc 3.9`：把 LaTeX 公式转成 **Word 原生公式对象（OMML）**，可在 Word 中双击编辑；
- 中文样式模板 `ref_cn.docx`（已入库）：正文宋体小四、标题黑体、黑色字、1.5 倍行距、**A4 纸张 + 上下 2.54cm / 左右 2.5cm 页边距**；
  重建方法：`pandoc --print-default-data-file reference.docx > ref_orig.docx` 后运行 `python ..\build-report.py ref`；
- **注意**：pandoc 默认模板的 `<w:sectPr>` 里只有 `<w:footnotePr>`，不含纸张与页边距，会让正文行宽超出页面、文字被裁；`build-report.py fix` 就是补上这一设置，生成 docx 后务必执行；
- PDF：用 LibreOffice（或 Word）打开 docx 导出 PDF 即可。

### 写字机抄写稿

由正式稿派生出「无小标题、全篇统一正文样式」的抄写稿（供写字机誊抄）：

```powershell
python ..\build-report.py copy "实验十九-...-实验报告.md" "实验十九-...-抄写稿.md"
& $pandoc "实验十九-...-抄写稿.md" -f markdown+pipe_tables+tex_math_dollars -t docx --reference-doc="ref_cn.docx" -o "实验十九-...-抄写稿.docx"
python ..\build-report.py fix "实验十九-...-抄写稿.docx"
```

处理规则：`## 一、…` → 正文加粗行；`### 表 N …`（表标题）→ 正文加粗行；其余 `###/####` 小标题**整行删除**；`>` 引用符号去除。

### 结果公式加方框

Markdown 源文件里用带自定义样式的围栏 div 包住公式，样式由模板中的 `Boxed` 提供（带边框、居中）：

```markdown
::: {custom-style="Boxed"}
$$\tau=\bar{\tau}\pm u_\tau=(200.87\pm0.083)\ \mu\mathrm{s}\quad (P=0.683)$$
:::
```

## 同步到 Gitee

```powershell
cd D:\Desktop\学生工作\物理实验
.\sync-gitee.ps1 "本次修改说明"     # 不带说明时自动用时间戳
```

脚本会依次执行 `git add -A` → 提交 → 推送到 Gitee `main` 分支。