https://github.com/jinqKing/SZU-Physics-Experiment-Report-LaTeX-Module
深大大物实验报告LaTeX模版
https://github.com/jinqKing/SZU-Physics-Experiment-Report-LaTeX-Module
Last synced: 5 months ago
JSON representation
深大大物实验报告LaTeX模版
- Host: GitHub
- URL: https://github.com/jinqKing/SZU-Physics-Experiment-Report-LaTeX-Module
- Owner: jinqKing
- Created: 2024-03-22T13:54:34.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-04-24T13:29:42.000Z (over 1 year ago)
- Last Synced: 2024-08-17T23:02:11.050Z (over 1 year ago)
- Language: TeX
- Homepage:
- Size: 5.97 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.md
Awesome Lists containing this project
README
**深圳大学大学物理实验报告** $\LaTeX$ 模板（基于大学物理实验（三）要求）及案例
*请根据自己的数据自行调整仅作模版案例示意*
> 更漂亮的字体，更好的排版，更方便的使用。
>
> 适合上进者去练习 $\LaTeX$ 的好机会。
*结尾指出如何适应一般实验报告（如物理实验一二）。*
*请在环境配置好的电脑上运行，以上调试过程在 Linux （WSL）使用 `XeLaTeX` 编译，示例使用 VSCode 文本编辑。*
# ~~不建议流程：~~
直接使用 `实用主义白板.tex` 添加实验内容。**但这样不方便批量管理实验报告，不利于复用模板文件。**
优点是里面包含所有必要部分，而附加（保障）内容最少。
# 建议流程：
文档结构：
```shell
.
├──── ReadMe.md
├──── phyreport.cls
├──── 空白
│ └── 模版.tex
├──── 电感
│ ├── 电感的测量.tex
│ ├── 电感的测量.pdf
│ ├── fig
│ │ └── p1.png
│ └── data
│ └── pd.csv
└──── cover.pdf*
```
0. **修改 `phyreport.cls` 文件，填写个人信息。**
1. 复制 `空白` 文件夹，重命名为实验文件夹。
2. 重命名 `模版.tex` 文件，编辑内容，补充实验细节。
3. 编译 `实验.tex` 文件，生成 `实验.pdf` 文件。
\* cover.pdf 为封面图片，可选。
这样安排可以方便管理实验报告，**一个文件夹记录一次实验**，统一模板文件。
# 原理说明
编写了一个 `phyreport.cls` 类文件（就像article、ctexart），定义了实验报告的格式，通过控制页边距等使得像官方提供的 Word 模版。于是每次文档直接使用这个类文件即可得到一份“普通的”实验报告。
基于 ctexart 类，预先一些常用包和需要的功能，如我们使用 `tikz` 绘制了封面以及各种打分方格。
细节说明:
+ 使用 fancypage 和页边指令控制页边距，清除页眉页脚，让页码只在右下；
+ 改了一般的节 section 标题格式，变成汉字数字且左对齐 *这里也许可以改进得更简单*
+ 使用新命令定义变量，方便修改，如实验名称、实验地点、实验日期等；
正文使用的命令
1. `\phyExpCover` : 生成封面，里面的日期
2. **`\longLine` : 生成一条长横线，用于分隔不同部分;** *这是目前实现的最简单做法*
3. `\endBox` : 用于绘制结尾教师评价和打分表格。
# 修改配置
## 必要
- 进入 `phyreport.cls` 文件，修改 `\NewDocumentCommand\phyExpCover{}` 内容，填上你的课程编号、学院、老师、名字、学号、组号等不会变的信息。
- [ 可选 ] 填写每次实验地点：取消注释 l.38-41 l.72,同时注释l.73 ,使之变成
```latex
\newcommand{\expAddr}[1]{
\IfValueTF{#1}{\newcommand{\phyExpAddr}{#1}}
{\newcommand{\phyExpAddr}{致原楼}}
}
...
...
...
\node[above] at (5.75,-16.3){\phyExpAddr};
% \node[above] at (5.75,-16.3){致原楼};
```
**但是这样每次得需要写上 `\phyExpAddr{}` 否则编译报错.**
## 自定义
- [ 特殊 ] 使用 pdf 作为封面在pdf添加相应信息: 在 `phyreport.cls` 文件中的 `\NewDocumentCommand\phyExpCover{}` 中的 `\begin{tikzpicture}` 之后，直接插入封面图片。
```latex
\node at (current page.center)
{
\includegraphics[width=\paperwidth, height=\paperheight, keepaspectratio=false]{../cover.pdf};
};
```
可参考 `卡门实验` 文件.其中使用了 `cover.pdf` 和自定义的 `phyreport.cls` 文件,。
^ 这个可以方便实验（一/二）
# 其它
- 同一目录操作:
```latex
\documentclass[a4paper]{../phyreport}
```
`../` 代表上一级目录，可以直接在`实验`文件夹中使用上一级`样版`中`phyreport.cls` 文件。如果不习惯,可以将 `phyreport.cls` 文件相应 .tex 同文件夹下删掉 `../`。
- 一般报错：两处字体大小不合适,会提示难以适配,不影响整体。
- 默认载入包：尽量覆盖一般使用，但比如处理多图并排时不够，细节自行查看`\RequirePackage` 部分。
- 本模板为学习交流使用，不保证完全符合实验报告要求。
- **不完美之处**：有时最好删掉 `longLine` 自己调整格式,使得看起来更协调。
- 最大优势: ~~方便抄别人的报告 + Copilot 自动补全~~
## 加入样板的实验报告:
1. 卡门实验
2. 电感测量
3. 单双缝衍射
4. 弹簧振子周期
没有 Q&A，架构简单，请自由探索。