Squashed commits and removed TrueType font files

Features/Signalling.md

@@ -74,7 +74,7 @@ This has the effect of adding a penalty for trains which could use the bay platf
 越行线入口处朝后的信号机有足够大的惩罚值（1600 > 800），因此在站台未被占用时，列车将优先考虑使用站台线通过。
 当站台线被占用时，站台线的惩罚值比越行线大，此时列车会使用越行线通过。
 
-寻路限制程序中的长预留命令是为了让通过列车能够更好地使用中央越行线超越站台上停止的列车。
+寻路限制程序中的接续预留命令是为了让通过列车能够更好地使用中央越行线超越站台上停止的列车。
 
 ### 可执行操作
 
@@ -89,19 +89,19 @@ This has the effect of adding a penalty for trains which could use the bay platf
 默认值为：小 = 500，中 = 2000，大 = 8000。
 本选项可以用来精细调整列车寻路行为。
 
-#### 通过预留
+#### 延续预留
 
 列车预留路径不会在这个信号处结束，就好像信号在前进方向上根本不存在一样。
 此操作在应用于有信号的隧道/桥梁入口或出口时没有效果。
 
-#### 长预留
+#### 接续预留
 
 如果列车的预留路径在这个信号处终止，游戏会尝试从这个信号开始预留另一段路径。
 第一段路径和第二段路径无关。第二段路径预留失败不影响第一段路径。
 此操作在应用于有信号的隧道/桥梁入口或出口时没有效果。
 
-“长预留（除非停车）”子操作只在列车的第一段路径不经过其将要停靠的车站或路点时才会尝试开始预留另一段路径。
-本子操作用于站台末的信号时可以防止停靠的列车使用长预留导致效率降低。
+“接续预留（除非停车）”子操作只在列车的第一段路径不经过其将要停靠的车站或路点时才会尝试开始预留另一段路径。
+本子操作用于站台末的信号时可以防止停靠的列车使用接续预留导致效率降低。
 
 #### 新闻控制
 

Kale/basic_pbs_programming.md

@@ -0,0 +1,47 @@
+# 寻路限制
+
+在这里我将介绍一些寻路限制在游戏中的运用实例。[^rspp]
+部分例子在预防冲突与节省基建时几乎是唯一解决方案。
+对寻路限制与寻路限制程序的合理运用可以很大程度上提升运行的顺滑度，
+同时也降低阻塞的风险。虽然单一程序可能耗不起眼，但程序积少成多，
+最终你的网络会让在其上运行的列车快速且准确。
+
+[^rspp]: 译注：寻路限制（Routefinding restriction）和可编程逻辑信号（Programmable pre-signal）是两个极其容易混淆的概念。
+寻路限制仅适用于路径信号，可编程逻辑信号只适用于可编程逻辑信号（橙色灯牌）
+两者之间的差异在于可编程逻辑信号本质上来说还是逻辑信号（通过、进出口、复合），
+所以不需要预留一段路径。
+而寻路限制本质上是给路径信号路径预留增加了限制，需要预留路径。
+详细解释参见“[信号](../Features/Signalling.md)”章节。
+
+## 如何配置
+
+首先要介绍的就是分区功能当中的一个选项。
+你可以在分区选项中设置高亮寻路限制信号，这样就可以快速找到你特别设置过的信号灯。[^remove_signal]
+防止你误操作删除你设置过的信号。
+
+[^remove_signal]: 译注：实际上如果完全使用 8bpp 图像，且信号灯的灯杆是灰色或蓝灰色，在开启“寻路限制信号使用蓝色灯柱”时，
+游戏会自动将这些信号的灯柱替换为蓝色，所以可以不使用文中所述分区功能。不过，“启用蓝色灯柱”不适用于这些情形：
+灯柱不是蓝色的，或图像不是 8bpp 的（即图像为 32bpp）。
+
+为了给信号灯编制寻路限制程序，你需要点选信号灯菜单中的齿轮图标。
+点选后，点击你所需编程的信号。
+
+这就是寻路限制菜单了。
+
+## 简单信号路径优先
+
+寻路限制信号编程的一大作用是确定优先级。这里是一个优先级的例子。
+具体实现优先级需要这两种操作当中的一种，不过我个人认为接续预留的效果最好：
+
+* [延续预留](../Features/Signalling.md#延续预留)（Reserve through）
+
+  *列车预留路径不会在这个信号处结束，就好像信号在前进方向上根本不存在一样。*
+  *此操作在应用于有信号的隧道/桥梁入口或出口时没有效果。*
+
+* [接续预留](../Features/Signalling.md#接续预留)（Long reserve）
+
+  *如果列车的预留路径在这个信号处终止，游戏会尝试从这个信号开始预留另一段路径。*
+  *第一段路径和第二段路径无关。第二段路径预留失败不影响第一段路径。*
+  *此操作在应用于有信号的隧道/桥梁入口或出口时没有效果。*
+
+<!--客运列车的优先级比货运列车高，因此在这种设置种-->

Kale/kales_model_railway_tutorials.md

@@ -8,13 +8,6 @@
 Post by KaleTrans » 26 Jun 2024 09:53
 ```
 
-```{toctree}
-:maxdepth: 2
-:caption: 目录
-
-./scheduled_dispatch.md
-```
-
 ## 前言
 
 你好！我是 Kale，你们友好的社区版主。

_static/css/kai.css

@@ -0,0 +1,66 @@
+@font-face {
+  font-family: "wenkai";
+  src: url(fonts/LXGWWenKaiMono-Regular.woff2) format("woff2"),
+    url(fonts/LXGWWenKaiMono-Regular.woff) format("woff"),
+}
+
+@font-face {
+  font-family: "sarasa";
+  src: url(fonts/SarasaGothicSC-Regular.woff2) format("woff2"),
+    url(fonts/SarasaGothicSC-Regular.woff) format("woff");
+  /* regular */
+  font-weight: 400;
+}
+
+@font-face {
+  font-family: "sarasa";
+  src: url(fonts/SarasaGothicSC-Bold.woff2) format("woff2"),
+    url(fonts/SarasaGothicSC-Bold.woff) format("woff");
+  /* bold */
+  font-weight: 700;
+}
+
+
+/* 斜体 - 美化 */
+em, /* 预览模式下 */
+span.cm-em, /* 实时预览下 */
+.cm-quote.cm-quote-1.cm-em /* 实时预览的引用块下 */ {
+  /* 不倾斜 */
+  font-style: normal;
+  font-family: "wenkai";
+}
+
+body,
+textarea,
+input[type="button"],
+input[type="reset"],
+input[type="week"],
+input[type="color"],
+input[type="date"],
+input[type="datetime-local"],
+input[type="datetime"],
+input[type="email"],
+input[type="month"],
+input[type="number"],
+input[type="password"],
+input[type="search"],
+input[type="tel"],
+input[type="text"],
+input[type="time"],
+input[type="url"],
+input[type="submit"],
+.btn {
+  font-family: Lato,"sarasa",proxima-nova, Helvetica Neue, Arial, sans-serif;
+}
+
+.rst-content .sidebar .sidebar-title,
+.rst-content .toctree-wrapper > p.caption,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+legend {
+  font-family: Roboto Slab,"sarasa", ff-tisa-web-pro, Georgia, Arial, sans-serif;
+}

conf.py

@@ -26,6 +26,7 @@
 myst_heading_anchors = 3
 
 html_theme = "sphinx_rtd_theme"
+html_logo = "_static/logo.png"
 
 extensions = [
     "sphinx.ext.autodoc",
@@ -48,3 +49,7 @@
     "substitution",
     "tasklist",
 ]
+
+# add custom css
+html_static_path = ["_static"]
+html_css_files = ["css/kai.css"]

extras.md

@@ -0,0 +1,15 @@
+# 译者的话
+
+## 下载游戏
+
+### GitHub
+
+下载游戏的唯一官方途径为 [GitHub](https://github.com/jgrennison/openttd-patches/releases)。你也可以自己通过源码编译。
+
+## 贡献者
+
+感谢所有志愿者贡献的时间与精力：
+
+* JGRennison
+* WenSim
+* Mikhail

index.md

@@ -13,27 +13,49 @@ for the original thread.
 你可以于 [TT-forums](https://www.tt-forums.net/viewtopic.php?p=1270083#p1270083) 上找到原文。
 ```
 
-关于项目，请查看[项目自述文件](https://github.com/JGRennison/OpenTTD-patches/blob/jgrpp/README.md)。\
-关于百科，请查看[百科自述文件](./readme.md)。
+```{toctree}
+:caption: JGRPP 百科
+:titlesonly:
+:hidden:
+:glob:
 
-TT-Forums [项目链接](https://www.tt-forums.net/viewtopic.php?f=33&t=73469)。
+Features/*
+```
 
 ```{toctree}
-:maxdepth: 2
-:caption: 目录
-
-beginners.md
-Features/Day-length.md
-Features/Network-server-administration.md
-Features/One-way-roads.md
-Features/Order-window-features.md
-Features/Other-features.md
-Features/Realistic-braking.md
-Features/Signalling.md
-Kale/kales_model_railway_tutorials.md
+:caption: Kale 的模型铁路教程
+:hidden:
+:glob:
+:titlesonly:
+
+简介 <Kale/kales_model_railway_tutorials.md>
+Kale/*
 ```
 
-NewGRF 拓展：
+```{toctree}
+:titlesonly:
+:hidden:
+:caption: 其他
+
+extras.md
+百科自述文件 <readme.md>
+```
+
+```{toctree}
+:titlesonly:
+:hidden:
+:caption: 外部链接
+
+项目地址 <https://github.com/jgrennison/openttd-patches>
+NML 文档 <https://jgrennison.github.io/OpenTTD-patches/newgrf-additions-nml.html>
+NFO 文档 <https://jgrennison.github.io/OpenTTD-patches/newgrf-additions.html>
+TT-Forums 项目链接 <https://www.tt-forums.net/viewtopic.php?f=33&t=73469>
+```
+
+OpenTTD JGRPP，全称 OpenTTD JGR’s Patchpack（OpenTTD JGR 的补丁包，以下简称 JGRPP）。由 JGR 于 2015 年开始基于原版 OpenTTD 开发。
+JGRPP 保留了与原版的兼容性，其本身也基于原版代码库（包含原版的所有 commit，但代码上有作调整），因此可以读取原版存档，但反之则不可以。
+
+JGRPP 包含众多功能，包括真实制动与寻路限制。
 
-* [NML 文档](https://jgrennison.github.io/OpenTTD-patches/newgrf-additions-nml.html)
-* [NFO 文档](https://jgrennison.github.io/OpenTTD-patches/newgrf-additions.html)
+本百科基于官方页面，主要由 WenSim 翻译。翻译可能有欠缺或不足之处。你可以提交 Issue 指出，或者直接提交 PR
+进行更改。本人经验不足，还请见谅。