chore: update typst template

Author: GZTimeWalker

README.md

@@ -6,9 +6,9 @@
 
 ## 实验反馈
 
--   交流实验中遇到的困难：[![Discussions](https://img.shields.io/github/discussions/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/discussions)
--   提出实验设计的问题：[![Issues](https://img.shields.io/github/issues/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/issues)
--   改善这个实验：[![Issues-pr](https://img.shields.io/github/issues-pr/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/pulls)
+- 交流实验中遇到的困难：[![Discussions](https://img.shields.io/github/discussions/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/discussions)
+- 提出实验设计的问题：[![Issues](https://img.shields.io/github/issues/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/issues)
+- 改善这个实验：[![Issues-pr](https://img.shields.io/github/issues-pr/YatSenOS/YatSenOS-Tutorial-Volume-2)](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/pulls)
 
 ## 常见问题解答
 

docs/css/inst.css

@@ -6,18 +6,19 @@
   font-family: 'JetBrains Mono', monospace;
   font-weight: 600;
   border-collapse: collapse;
+  --inst-border: 0.06rem solid var(--md-default-fg-color);
 }
 .inst-node {
   text-align: center;
   padding: 0.2em;
-  border: 0.04rem solid var(--md-default-fg-color);
+  border: var(--inst-border);
 }
 .inst-node-little,
 .fl-table-node {
   text-align: center;
   font-size: 0.7rem;
   padding: 0.15em;
-  border: 0.04rem solid var(--md-default-fg-color);
+  border: var(--inst-border);
 }
 .inst-numnode {
   font-size: 0.5rem;

docs/general/typst.md

@@ -4,6 +4,8 @@
 
 关于 typst 的一些细节可以参考 [typst doc](https://typst.app/docs/)，同时，推荐使用模板来撰写格式更加更为统一的实验报告，可以参考[模板](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/tree/main/template)，后文给出了一个可能的使用方法。
 
+!!! tip "相关原始 [Typst 模板](https://github.com/SYSUMSC/GZ-Typst-Templates)目前由中山大学互联网与开源技术协会维护。"
+
 ## 使用示例
 
 !!! note "假设你已经成功安装 typst，并已经加入到系统路径"

docs/labs/0x01/tasks.md

@@ -186,14 +186,14 @@ unsafe {
 
     !!! note "使用 `.gdbinit` 方便你的调试过程"
 
-          以下是一个 `.gdbinit` 的例子，你可以将其放置在你的工作目录下，这样每次进入 GDB 调试环境时，它都会自动加载。请注意部分指令是 `gef` 所提供的，详情请见调试文档。
-
-          ```bash
-          file esp/KERNEL.ELF
-          gef-remote localhost 1234
-          tmux-setup
-          b ysos_kernel::init
-          ```
+        以下是一个 `.gdbinit` 的例子，你可以将其放置在你的工作目录下，这样每次进入 GDB 调试环境时，它都会自动加载。请注意部分指令是 `gef` 所提供的，详情请见调试文档。
+
+        ```bash
+        file esp/KERNEL.ELF
+        gef-remote localhost 1234
+        tmux-setup
+        b ysos_kernel::init
+        ```
 
 - 使用 `c` 命令继续执行，你将会看到 QEMU 窗口中的输出，同时 GDB 将会在断点处停下。
 - 查看断点处的汇编和符号是否正确，使用 `vmmap` 和 `readelf` 等指令查看内核的加载情况。

docs/labs/0x02/tasks.md

@@ -191,31 +191,7 @@ impl XApic {
 
     查询文档可知，SPIV 寄存器的偏移量为 0xF0。其位描述如下：
 
-      <table class="inst">
-      <tr>
-          <td class="inst-numnodel">31</td>
-          <td class="inst-numnode" colspan="16"></td>
-          <td class="inst-numnoder">10</td>
-          <td class="inst-numnoder">9</td>
-          <td class="inst-numnoder">8</td>
-          <td class="inst-numnode" colspan="3"></td>
-          <td class="inst-numnoder">4</td>
-          <td class="inst-numnoder">3</td>
-          <td class="inst-numnoder">2</td>
-          <td class="inst-numnoder">1</td>
-          <td class="inst-numnoder">0</td>
-      </tr>
-      <tr>
-          <td colspan="18" class="inst-node-little"></td>
-          <td colspan="1" class="inst-node-little">FC</td>
-          <td colspan="1" class="inst-node-little">EN</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-          <td colspan="1" class="inst-node-little">1</td>
-          <td colspan="1" class="inst-node-little">1</td>
-          <td colspan="1" class="inst-node-little">1</td>
-          <td colspan="1" class="inst-node-little">1</td>
-      </tr>
-      </table>
+    <table class="inst"><tr><td class="inst-numnodel">31<td class="inst-numnode"colspan="16"><td class="inst-numnoder">10<td class="inst-numnoder">9<td class="inst-numnoder">8<td class="inst-numnode"colspan="3"><td class="inst-numnoder">4<td class="inst-numnoder">3<td class="inst-numnoder">2<td class="inst-numnoder">1<td class="inst-numnoder">0<tr><td class="inst-node-little"colspan="18"><td class="inst-node-little"colspan="1">FC<td class="inst-node-little"colspan="1">EN<td class="inst-node-little"colspan="4">Vector<td class="inst-node-little"colspan="1">1<td class="inst-node-little"colspan="1">1<td class="inst-node-little"colspan="1">1<td class="inst-node-little"colspan="1">1</table>
 
     因此，需要在保持其他位不变的情况下，将 EN bit 设置为 1，并将 Vector 设置为 `Irq::Spurious`，但是请注意实际设置的中断向量号需要加上 `Interrupts::IrqBase`。同时，此寄存器的 0-3 bit 无法被修改，始终为 1。
 
@@ -234,78 +210,7 @@ impl XApic {
 
     Local Vector Table 寄存器用于设置中断向量号和触发模式。它们的位描述如下：
 
-      <table class="inst">
-      <tr>
-          <td class="inst-numnode" colspan="4"></td>
-          <td class="inst-numnodel">31</td>
-          <td class="inst-numnode" colspan="8"></td>
-          <td class="inst-numnoder">18</td>
-          <td class="inst-numnoder">17</td>
-          <td class="inst-numnoder">16</td>
-          <td class="inst-numnoder">15</td>
-          <td class="inst-numnoder">14</td>
-          <td class="inst-numnoder">13</td>
-          <td class="inst-numnoder">12</td>
-          <td class="inst-numnoder">11</td>
-          <td class="inst-numnode" colspan="2"></td>
-          <td class="inst-numnoder">8</td>
-          <td class="inst-numnode" colspan="3"></td>
-          <td class="inst-numnoder">0</td>
-      </tr>
-      <tr>
-          <td colspan="4">Timer</td>
-          <td colspan="10" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">TP</td>
-          <td colspan="1" class="inst-node-little">M</td>
-          <td colspan="3" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="4" class="inst-node-little">-</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-      </tr>
-      <tr>
-          <td colspan="4">LINT0</td>
-          <td colspan="11" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">M</td>
-          <td colspan="1" class="inst-node-little">TM</td>
-          <td colspan="1" class="inst-node-little">RI</td>
-          <td colspan="1" class="inst-node-little">IP</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="1" class="inst-node-little">-</td>
-          <td colspan="3" class="inst-node-little">DMode</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-      </tr>
-      <tr>
-          <td colspan="4">LINT1</td>
-          <td colspan="11" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">M</td>
-          <td colspan="1" class="inst-node-little">TM</td>
-          <td colspan="1" class="inst-node-little">RI</td>
-          <td colspan="1" class="inst-node-little">IP</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="1" class="inst-node-little">-</td>
-          <td colspan="3" class="inst-node-little">DMode</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-      </tr>
-      <tr>
-          <td colspan="4">ERROR</td>
-          <td colspan="11" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">M</td>
-          <td colspan="3" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="4" class="inst-node-little">-</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-      </tr>
-      <tr>
-          <td colspan="4">PCINT</td>
-          <td colspan="11" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">M</td>
-          <td colspan="3" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="1" class="inst-node-little">-</td>
-          <td colspan="3" class="inst-node-little">DMode</td>
-          <td colspan="4" class="inst-node-little">Vector</td>
-      </tr>
-      </table>
+    <table class="inst"><tr><td class="inst-numnode"colspan="4"><td class="inst-numnodel">31<td class="inst-numnode"colspan="8"><td class="inst-numnoder">18<td class="inst-numnoder">17<td class="inst-numnoder">16<td class="inst-numnoder">15<td class="inst-numnoder">14<td class="inst-numnoder">13<td class="inst-numnoder">12<td class="inst-numnoder">11<td class="inst-numnode"colspan="2"><td class="inst-numnoder">8<td class="inst-numnode"colspan="3"><td class="inst-numnoder">0<tr><td colspan="4">Timer<td class="inst-node-little"colspan="10">-<td class="inst-node-little"colspan="1">TP<td class="inst-node-little"colspan="1">M<td class="inst-node-little"colspan="3">-<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="4">-<td class="inst-node-little"colspan="4">Vector<tr><td colspan="4">LINT0<td class="inst-node-little"colspan="11">-<td class="inst-node-little"colspan="1">M<td class="inst-node-little"colspan="1">TM<td class="inst-node-little"colspan="1">RI<td class="inst-node-little"colspan="1">IP<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="1">-<td class="inst-node-little"colspan="3">DMode<td class="inst-node-little"colspan="4">Vector<tr><td colspan="4">LINT1<td class="inst-node-little"colspan="11">-<td class="inst-node-little"colspan="1">M<td class="inst-node-little"colspan="1">TM<td class="inst-node-little"colspan="1">RI<td class="inst-node-little"colspan="1">IP<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="1">-<td class="inst-node-little"colspan="3">DMode<td class="inst-node-little"colspan="4">Vector<tr><td colspan="4">ERROR<td class="inst-node-little"colspan="11">-<td class="inst-node-little"colspan="1">M<td class="inst-node-little"colspan="3">-<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="4">-<td class="inst-node-little"colspan="4">Vector<tr><td colspan="4">PCINT<td class="inst-node-little"colspan="11">-<td class="inst-node-little"colspan="1">M<td class="inst-node-little"colspan="3">-<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="1">-<td class="inst-node-little"colspan="3">DMode<td class="inst-node-little"colspan="4">Vector</table>
 
     - Vector 为中断向量号，当中断发生时，CPU 会跳转到中断向量表中对应处理程序执行。
     - DMode（Delivery Mode）为中断传递模式，本实验中不做理解要求。
@@ -373,53 +278,7 @@ impl XApic {
 
     中断命令寄存器的位描述如下：
 
-      <table class="inst">
-      <tr>
-          <td class="inst-numnode" colspan="3"></td>
-          <td class="inst-numnodel">63</td>
-          <td class="inst-numnode" colspan="3"></td>
-          <td class="inst-numnoder">56</td>
-          <td class="inst-numnode" colspan="17"></td>
-          <td class="inst-numnoder">32</td>
-      </tr>
-      <tr>
-          <td colspan="3" >0x310</td>
-          <td colspan="5" class="inst-node-little">DF</td>
-          <td colspan="18" class="inst-node-little">-</td>
-      </tr>
-      <tr>
-          <td class="inst-numnode" colspan="3"></td>
-          <td class="inst-numnodel">31</td>
-          <td class="inst-numnode" colspan="4"></td>
-          <td class="inst-numnoder">20</td>
-          <td class="inst-numnode" colspan="1"></td>
-          <td class="inst-numnoder">18</td>
-          <td class="inst-numnode" colspan="1"></td>
-          <td class="inst-numnoder">16</td>
-          <td class="inst-numnoder">15</td>
-          <td class="inst-numnoder">14</td>
-          <td class="inst-numnoder">13</td>
-          <td class="inst-numnoder">12</td>
-          <td class="inst-numnoder">11</td>
-          <td class="inst-numnode" colspan="2"></td>
-          <td class="inst-numnoder">8</td>
-          <td class="inst-numnode" colspan="4"></td>
-          <td class="inst-numnoder">0</td>
-      </tr>
-      <tr>
-          <td colspan="3" >0x300</td>
-          <td colspan="6" class="inst-node-little">-</td>
-          <td colspan="2" class="inst-node-little">DSH</td>
-          <td colspan="2" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">TM</td>
-          <td colspan="1" class="inst-node-little">LV</td>
-          <td colspan="1" class="inst-node-little">-</td>
-          <td colspan="1" class="inst-node-little">DS</td>
-          <td colspan="1" class="inst-node-little">DM</td>
-          <td colspan="3" class="inst-node-little">DMode</td>
-          <td colspan="5" class="inst-node-little">Vector</td>
-      </tr>
-      </table>
+    <table class="inst"><tr><td class="inst-numnode"colspan="3"><td class="inst-numnodel">63<td class="inst-numnode"colspan="3"><td class="inst-numnoder">56<td class="inst-numnode"colspan="17"><td class="inst-numnoder">32<tr><td colspan="3">0x310<td class="inst-node-little"colspan="5">DF<td class="inst-node-little"colspan="18">-<tr><td class="inst-numnode"colspan="3"><td class="inst-numnodel">31<td class="inst-numnode"colspan="4"><td class="inst-numnoder">20<td class="inst-numnode"colspan="1"><td class="inst-numnoder">18<td class="inst-numnode"colspan="1"><td class="inst-numnoder">16<td class="inst-numnoder">15<td class="inst-numnoder">14<td class="inst-numnoder">13<td class="inst-numnoder">12<td class="inst-numnoder">11<td class="inst-numnode"colspan="2"><td class="inst-numnoder">8<td class="inst-numnode"colspan="4"><td class="inst-numnoder">0<tr><td colspan="3">0x300<td class="inst-node-little"colspan="6">-<td class="inst-node-little"colspan="2">DSH<td class="inst-node-little"colspan="2">-<td class="inst-node-little"colspan="1">TM<td class="inst-node-little"colspan="1">LV<td class="inst-node-little"colspan="1">-<td class="inst-node-little"colspan="1">DS<td class="inst-node-little"colspan="1">DM<td class="inst-node-little"colspan="3">DMode<td class="inst-node-little"colspan="5">Vector</table>
 
     具体的配置配置细节这里不做理解要求，只需要按照如下描述进行配置即可：
 

docs/labs/0x03/tasks.md

@@ -301,9 +301,9 @@ pub fn new(init: Arc<Process>) -> Self {
 
     !!! note "缺页异常？"
 
-          你可能会注意到，4GiB 的栈空间中实际映射的目前只有 2MiB，剩下的页面都是没有映射的。
+        你可能会注意到，4GiB 的栈空间中实际映射的目前只有 2MiB，剩下的页面都是没有映射的。
 
-          在未来的实验内容中，你将会处理这种缺页异常，并在需要时为进程进行映射。
+        在未来的实验内容中，你将会处理这种缺页异常，并在需要时为进程进行映射。
 
 在了解了这些虚拟地址空间预设的情况下，进一步来考虑其他进程的内存布局。本次实验中，由于还没有“用户进程”的概念，可以暂时先考虑的少一些，但是便于本次实验使用的解决方案。
 

template/README.md

@@ -2,9 +2,9 @@
 
 ## 使用方式
 
--   安装 [Typst](https://typst.app)
--   将本仓库克隆到任意目录
--   通过 `ln -s /path/to/repo/ ./base` 将本仓库链接到你的项目
--   在 Typst 中使用模板（例如 `#import "./base/templates/report.typ": *`）
+- 安装 [Typst](https://typst.app)
+- 将本仓库克隆到任意目录
+- 通过 `ln -s /path/to/repo/ ./base` 将本仓库链接到你的项目
+- 在 Typst 中使用模板（例如 `#import "./base/templates/report.typ": *`）
 
 你可以在 [usage.typ](./usage.typ) 中查看示例。

template/shared.typ

@@ -56,7 +56,7 @@
   show link: underline
   set math.vec(delim: "[")
   set math.mat(delim: "[")
-  show par: set block(spacing: line_height)
+  set par(spacing: line_height)
 
   doc
 }