# Linux_course_students

**Repository Path**: jiamin_luu/linux_course_students

## Basic Information

- **Project Name**: Linux_course_students
- **Description**: 用来分发和收集《Linux操作系统与应用》课程的相关材料，包括课件和学生作业
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 39
- **Created**: 2026-04-28
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Linux_course_students

#### 一、介绍 
本项目仓库用于分发和收集河海大学《Linux操作系统与应用》课程（0601059）的相关材料。

#### 二、项目架构
```tree
released_slides				/*用来分发课程课件*/
submitted_slides			/*用来收集分组报告的 marp 源代码*/
├── assets				/*在源码中被关联的图片等附件*/
├── css					/*源码引用的样式*/
├── marp.config.mjs		        /*编译选项的配置文件*/
├── example.md				/*示例用 marp 源代码文件*/
├── makefile				/*用于编译当前目录下的所有 marp 源代码*/
└── pdf					/*用来存储编译后生成的pdf文件*/
    └── example.pdf		        /*示例用 marp 源代码文件生成的pdf文件*/
```



#### 三、部署教程

##### 1. 前置依赖

| 依赖         | 性质       | 用途                                |
| ------------ | ---------- | ----------------------------------- |
| **Node.js**  | 运行时环境 | 执行 Marp CLI 所需的基础            |
| **npm**      | 包管理器   | 用来安装 Marp CLI                   |
| **Marp CLI** | 核心工具   | 执行 `marp` 命令编译 `.md` → `.pdf` |
| **Make**     | 构建工具   | 执行 `makefile` 中的批处理指令      |
| **Git**      | 包管理工具 | 用于管理代码仓库                    |

检查命令：

``` bash
node -v      # 应输出 v20.x 或更高
npm -v			 # 应输出 v10.x 或更高
make -v			 # 应输出 v4.x 或更高
git --verion # 应输出 v2.x 或更高
marp --version # 应输出 v4.x 或更高
```

##### 2. 克隆仓库

``` bash
git clone https://gitee.com/jiamin_luu/linux_course_students.git
cd linux_course_students 
```

在 `linux_course_students` 目录中，应可以看到 **软件架构** 中提及的所有文件

##### 3. 编译验证

`pdf/example.pdf` 为示例性文件。可以自己查看和备份。下面我们将先删除该文件，再通过编译获得该文件，以对当前环境进行验证。

``` bash
# 删除既已生成的PDF文件
make clean
# 重新编译，将遍历当前目录下所有的md文档，并逐一生成同名的PDF文件，并置于 pdf 子目录中
make
```

makefile 中已设置了基本的编译过程。因此，在编译后，应该可以在 `pdf` 目录中，找到新编译生成 `example.pdf`。就此可以证明整个项目已成功部署。

```
ls -lh pdf/example.pdf
```



#### 四、提交汇报文件

1. 准备好自己的 [Gitee](https://gitee.com/) 账号，并通过认证，确保能创建自己的公开仓库。

2. 在浏览器中访问[源仓库](https://gitee.com/jiamin_luu/linux_course_students)，并点击右上角的 **Fork** 按钮，将其分支为自己的个人仓库。Fork 完成后，你会在个人账号下得到一个同名仓库，地址形如 `https://gitee.com/<你的用户名>/Linux_course_students`

3. 根据前期不同的执行步骤，选择以下两种方式之一完成本地化部署的过程：

   a) 若未根据第三节**部署教程**，克隆源仓库的，可以直接将个人的分支仓库克隆到本地，再依据部署教程中的第3节，验证本地环境

   ``` bash
   # 替换 <你的用户名> 为实际用户名
   git clone https://gitee.com/<你的用户名>/Linux_course_students.git
   cd Linux_course_students/submitted_slides
   ```

   

   b) 若在创建分支仓库前已克隆源仓库，可在本地克隆的仓库内替换远程仓库位置

   ``` bash
   # 1. 查看当前 remote（应该只有 origin，指向源仓库）
   git remote -v
   
   # 2. 把源仓库改名为 teacher，避免混淆
   git remote rename origin teacher
   
   # 3. 添加个人 fork 的分支仓库地址（替换 <你的用户名>）
   git remote add origin https://gitee.com/<你的用户名>/Linux_course_students.git
   
   # 4. 确认配置
   git remote -v
   # 预期输出：
   # origin    https://gitee.com/<你的用户名>/<仓库名>.git (fetch)
   # origin    https://gitee.com/<你的用户名>/<仓库名>.git (push)
   # teacher  https://gitee.com/jiamin_luu/linux_course_students (fetch)
   # teacher  https://gitee.com/jiamin_luu/linux_course_students (push)
   
   ```

4. 创建提交分组报告的功能分支

   分支命名规范：Group_<组号>，组号为课程分组中自己设置的小组编号，统一为2位。即若是第1组，分支名应为 `Brach_Group_01`

``` bash
git checkout -b Brach_Group_<组号>
```



5. 编写自己小组的 Marp 报告

**关键规范：**

- 报告文件名建议：`Group_<组号>_report.md`，避免中文文件名，放在`submitted_slides/`目录下，不要额外建立任何子目录。

- 所使用到的附件图片等必须放在 `submitted_slides/assets/` 目录下，并在报告文件中使用相对路径引用：`./assets/xxx.png`。为避免不同分组间的命名冲突，附件图片文件应加上 `Group_<组号>` 的前缀。

- 不允许修改 `css/` 目录下默认的样式文件，如需自定义样式，则样式文件必须存储在 `css/` 目录下，样式文件的命名应为 `Group_<组号>.scss`。

  

6. 编辑报告时，可使用 VSCode 等第三方编辑器。但完成后的报告必须通过本地编译验证。**注意！！如无法通过编译，则最终成绩中的分组报告部分计分为 0。**

```bash
# 1. 验证本地存储有分组报告所需的 md 文件、样式文件和附件文件
cd submitted_slides
ls Group_<组号>_report.md  # 必须存在
ls assets/Group_<组号>*		# 可选
ls css/Group_<组号>.scss	# 可选

# 2. 编译 marp 文件
make

# 3. 检查编译是否完成
ls -lh pdf/Group_<组号>_report.pdf
```

编译完成后，检查生成的PDF 文件中的内容是否均正常显示。

7. 提交更改

```bash
# 查看变更
git status
# 应包括.md、assets/ 下的图片、css/ 下的样式、生成的 pdf

# 添加新增文件
git add .

# 提交本次更改
git commit -m "提交第XX组的课程报告"
```

8. 推送到个人仓库

``` bash
# 将本地分支推送到第2步中创建的个人分支仓库
git push -u origin Brach_Group_<组号>
```

9. 发起 Pull Request（PR）
   - 打开个人的 Gitee 仓库页面 `https://gitee.com/<你的用户名>/<仓库名>`
   - 点击 **Pull Request → 新建 Pull Request**
   - **源分支**：选择你刚推送的 `Brach_Group_<组号>`
   - **目标分支**：选择[源仓库](https://gitee.com/jiamin_luu/linux_course_students)的 `master`
   - 填写 PR 标题：`提交第XX组课程报告`
   - 填写描述，包括组号、组长、组员、报告标题等必要信息
   - 点击 **创建 Pull Request**

10. 等待合并

- 仓库维护者会审查你的 PR，如有问题会在 PR 页面评论
- 如需修改：在本地继续编辑 → `git add` → `git commit` → `git push`，PR 会自动更新
- 审查通过后，维护者会将你的分支合并到 `master`



#### 参考资料

- [marpit 官方文档](https://marpit.marp.app/)

- [marp Themes](https://github.com/marp-team/marp-core/tree/main/themes)
- [marp-team/awesome-marp](https://github.com/marp-team/awesome-marp)