Skip to content

Commit

Permalink
Update quotation marks
Browse files Browse the repository at this point in the history
  • Loading branch information
William-Shi233 committed Aug 23, 2023
1 parent 03753ed commit 6b8aed3
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 9 deletions.
8 changes: 4 additions & 4 deletions docs/Postface/Log.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,19 @@

十七日晚,William_Shi 修改 CSS 文件,俾使 Blockquote 引文渲染后类似 docsify 引文。

十八日晨,William_Shi 修改 CSS 文件,俾使 Vitepress 所支持的 Markdown-It 格式中以 ::: 包裹的自定义容器渲染后类似 docsify 中 !> 和 ?> 容器。夜,William_Shi 修改 CSS 文件,俾使代码高亮颜色近于 docsify 所用之 Prism 高亮系统,并调整代码块背景颜色、复制按钮颜色。又复原事件模拟”及“确认行动结束两功能。至斯,页面样式大备,与原站难分真假。
十八日晨,William_Shi 修改 CSS 文件,俾使 Vitepress 所支持的 Markdown-It 格式中以 ::: 包裹的自定义容器渲染后类似 docsify 中 !> 和 ?> 容器。夜,William_Shi 修改 CSS 文件,俾使代码高亮颜色近于 docsify 所用之 Prism 高亮系统,并调整代码块背景颜色、复制按钮颜色。又复原事件模拟」及「确认行动结束两功能。至斯,页面样式大备,与原站难分真假。

二十六日晨,服务商迁移机器,致使服务器 IP 生变,域名解析至错误地址上。晚,Moe_Miner 修改域名解析地址,网站恢复正常。

## 2023-7

七月七日旰,Moe_Miner 和 William_Shi 二人重绘图片告竣。教程内容全齐。晚,William_Shi 拟在 MCBBS 编程开发版发帖,用于宣传《补订<日记>》,并由管理组在 ThatRarityEG 原帖内删去失效域名,添加《补订<日记>》相关信息。私信呈请于编程开发版主 tdiant 后,获准。

八日午后,William_Shi 将草稿帖发出,即[《补订 RarityEG's Plugin Dev Tutorial 插件开发日记》](https://www.mcbbs.net/thread-1454134-1-1.html)。又于 MCBBS 反馈版发布主题[《申请维护 RarityEG's Plugin Dev Tutorial》](https://www.mcbbs.net/thread-1454189-1-1.html),请求版主在原帖内标注xuogroup.top域名为失效入口,并提供指向《补订<日记>》的链接。tdiant 版主乙览,批准申请,并将图标、图章、高亮移至新帖。
八日午后,William_Shi 将草稿帖发出,即[《补订 RarityEG's Plugin Dev Tutorial 插件开发日记》](https://www.mcbbs.net/thread-1454134-1-1.html)。又于 MCBBS 反馈版发布主题[《申请维护 RarityEG's Plugin Dev Tutorial》](https://www.mcbbs.net/thread-1454189-1-1.html),请求版主在原帖内标注xuogroup.top域名为失效入口,并提供指向《补订<日记>》的链接。tdiant 版主乙览,批准申请,并将图标、图章、高亮移至新帖。

二十一日中午,Freeze_Dolphin 编写了一节 Adventure API 教程。按,Paper 团队对原有 API 作了众多颠覆性调整,将许多常用方法标记为过时,很可能令 Spigot 插件开发者无所适从。而 ThatRarityEG 在 EX-2-1 中建议读者使用 Paper API,故应当另起一节,专门论述这些过时方法的替代品。又,原教程第五卷主要介绍前文中所未提及的一部分 Bukkit API 内的方法,故将 Adventure API 教程置于第五卷内。该卷原先只有七节,5-7 为自定义进度,现于 5-6 和 5-7 之间插入一节 Adventure API 教程,将自定义进度移至 5-8。之所以不将新写的教程附在卷末,是因为自定义进度这一节有结束语,对第五卷内容作了总结,必须置尾。
二十一日中午,Freeze_Dolphin 编写了一节 Adventure API 教程。按,Paper 团队对原有 API 作了众多颠覆性调整,将许多常用方法标记为过时,很可能令 Spigot 插件开发者无所适从。而 ThatRarityEG 在 EX-2-1 中建议读者使用 Paper API,故应当另起一节,专门论述这些过时方法的替代品。又,原教程第五卷主要介绍前文中所未提及的一部分 Bukkit API 内的方法,故将 Adventure API 教程置于第五卷内。该卷原先只有七节,5-7 为自定义进度,现于 5-6 和 5-7 之间插入一节 Adventure API 教程,将自定义进度移至 5-8。之所以不将新写的教程附在卷末,是因为自定义进度这一节有结束语,对第五卷内容作了总结,必须置尾。

二十五日中午,CaveNightingale 对原有的 AC-1-3 节内容作了扩充修正。按,原教程中异步调用了 setWalkSpeed 方法,但该方法并不线程安全。又如,真实服务器环境中,玩家上线时的位置可能处于下界传送门内,因而无法登录。种种问题此处不具。原调试 HarmonyAuth SMART篇幅仅有一节,即 AC-1-3。现在将 AC-1-3 命名为调试 HarmonyAuth SMART Part I,新增 AC-1-4,命名为调试 HarmonyAuth SMART Part II
二十五日中午,CaveNightingale 对原有的 AC-1-3 节内容作了扩充修正。按,原教程中异步调用了 setWalkSpeed 方法,但该方法并不线程安全。又如,真实服务器环境中,玩家上线时的位置可能处于下界传送门内,因而无法登录。种种问题此处不具。原调试 HarmonyAuth SMART篇幅仅有一节,即 AC-1-3。现在将 AC-1-3 命名为调试 HarmonyAuth SMART Part I,新增 AC-1-4,命名为调试 HarmonyAuth SMART Part II

二十五日晚,GitHub 仓库与网站内容不再同步。修改 GitHub 仓库内的文件后,网站内容仍为原样。按 Moe_Miner 称,莱云的 cPanel 许可证又坏了,本教程网站的自动部署藉由 cPanel 的 Git 功能来同步,受其影响,不能工作。

Expand Down
2 changes: 1 addition & 1 deletion docs/Volume3/EX-2-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

注:Paper 服务端是基于 Spigot 服务端而开发的。即云,Spigot 服务端中包含的方法,Paper 服务端囊括全收。而在此之外,Paper 团队还向服务端中添加了一些方法。这等方法是 Spigot 服务端中所未有的。按 [Paper 服务端官方文档](https://docs.papermc.io/paper/adding-plugins#finding-plugins),如果某个插件只用到了 Spigot 服务端中的方法,则它可以在 Paper 服务端上正常运作。然而,如果某个插件用到了 Paper 团队添加进服务端中的方法,则它就不可能在 Spigot 服务端上运行。

编者谨按,ThatRarityEG 原文称示例代码在你的开发工具中显示错误,即云示例代码中用到的某些方法是 Paper 团队添加到服务端中的,Spigot 服务端内没有。如果开发时的依赖是 Spigot 服务端,则 IDE 无法找到这些方法,因而报错。必须将依赖换成 Paper 服务端方可。用到这些 Paper 独有的方法之后,插件无法在 Spigot 服务端上运行,只能在 Paper 服务端上运行。
编者谨按,ThatRarityEG 原文称示例代码在你的开发工具中显示错误,即云示例代码中用到的某些方法是 Paper 团队添加到服务端中的,Spigot 服务端内没有。如果开发时的依赖是 Spigot 服务端,则 IDE 无法找到这些方法,因而报错。必须将依赖换成 Paper 服务端方可。用到这些 Paper 独有的方法之后,插件无法在 Spigot 服务端上运行,只能在 Paper 服务端上运行。
:::

## 行动背景
Expand Down
2 changes: 1 addition & 1 deletion docs/Volume7/7-3.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

![SCB.png](https://s2.loli.net/2022/04/15/pEkFN7zZ9bXvCxL.png)

*有鉴于图床失效、原图丢失,上图系定稿后再行修补,并非选自网络*
*有鉴于图床失效、原图丢失,上图系定稿后再行修补,并非选自网络*

这就是记分板,在单人游戏中几乎看不到(除非有意创建),能够显示玩家的分数,在原版中也可以通过命令进行修改。

Expand Down
4 changes: 2 additions & 2 deletions docs/Volume8/AC-3-3.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@ CREATE DATABASE cutecoin;

等一小会,配置就被重新加载了,这个指令也适用于插件代码的修改,怎么样,是不是很方便?

注:reload 指令可以用于热重载插件。服务端运行该指令时,会卸载各个插件,然后重新启动它们。在这一过程中,配置文件被重新读取。所谓插件代码的修改,是指开发者在 IDE 里修改插件的源代码并编译出一个新 Jar 文件以后,粘贴到服务端 plugins 目录内以替换原 Jar 文件的过程。开发者修改代码、编译、粘贴并替换文件时,无需关闭服务器。替换文件后,执行 reload 指令,即可卸载旧的插件,改用新的 Jar,运行新的代码。热重载一词,强调重载插件时无需关服。与热重载相对的,是重启服务器。关闭服务器时插件自然会被卸载,开启服务器时自然要加载插件。因而在服务器关闭之后、开启以前,可以修改配置、替换旧 Jar 。开服时就能读取新配置、运行新的代码。
注:reload 指令可以用于热重载插件。服务端运行该指令时,会卸载各个插件,然后重新启动它们。在这一过程中,配置文件被重新读取。所谓插件代码的修改,是指开发者在 IDE 里修改插件的源代码并编译出一个新 Jar 文件以后,粘贴到服务端 plugins 目录内以替换原 Jar 文件的过程。开发者修改代码、编译、粘贴并替换文件时,无需关闭服务器。替换文件后,执行 reload 指令,即可卸载旧的插件,改用新的 Jar,运行新的代码。热重载一词,强调重载插件时无需关服。与热重载相对的,是重启服务器。关闭服务器时插件自然会被卸载,开启服务器时自然要加载插件。因而在服务器关闭之后、开启以前,可以修改配置、替换旧 Jar 。开服时就能读取新配置、运行新的代码。

reload 指令并不完善,常常导致匪夷所思的问题。比如 William_Shi 调试自己的某个插件时发现,使用该指令会导致 `StackOverFlowError`,且没有任何报错堆栈,无法排查原因。又如,粘液科技插件的作者表示,如果使用该指令来安装粘液科技插件,可能会导致内存泄漏。详见 [Slimefun4 Wiki](https://github.com/Slimefun/Slimefun4/wiki/Installing-Slimefun#how-to-install) 中的内容。像 Plugman、Yum 等插件也是大同小异,它们是用于热重载插件的插件,提供了在服务端运行时加载、卸载单个插件的功能,但也不可能保证重载插件时不出问题。

编者谨按,用于重载插件的最好方法必然是重启服务器。如果一个插件在开启服务器时不产生报错,在服务端正常关闭时能恰当卸载,那就足够。至于输入 reload 指令后,无论产生什么报错,又何伤乎?在调试插件时,如果每次都重启服务器,往往失之低效,因此才把 reload 指令作为无可奈何的选择,惟有“方便”这一优点。而“稳定”则根本无从谈起。任何一个服主,如果要向自己的生产环境服务端内添加一个新插件,都应该重新启动服务器。(生产环境指正式上线给用户使用的程序,调试环境指内部测试的程序)。所以对插件开发者而言,只要插件在重启服务器时不会出错,就堪称合格。
编者谨按,用于重载插件的最好方法必然是重启服务器。如果一个插件在开启服务器时不产生报错,在服务端正常关闭时能恰当卸载,那就足够。至于输入 reload 指令后,无论产生什么报错,又何伤乎?在调试插件时,如果每次都重启服务器,往往失之低效,因此才把 reload 指令作为无可奈何的选择,惟有「方便」这一优点。而「稳定」则根本无从谈起。任何一个服主,如果要向自己的生产环境服务端内添加一个新插件,都应该重新启动服务器。(生产环境指正式上线给用户使用的程序,调试环境指内部测试的程序)。所以对插件开发者而言,只要插件在重启服务器时不会出错,就堪称合格。

重新加载之后:

Expand Down
2 changes: 1 addition & 1 deletion docs/Volume9/END-8-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ RarityCommons 是自由软件,CuteCoin(我编写的部分)也是,那什

> **自由软件意味着使用者有运行、复制、发布、研究、修改和改进该软件的自由。**
>
> 自由软件是权利问题,不是价格问题。要理解这个概念,你应该考虑free”是“言论自由(free speech)”中的“自由”;而不是免费啤酒(free beer)”中的“免费”
> 自由软件是权利问题,不是价格问题。要理解这个概念,你应该考虑free」是「言论自由(free speech)」中的「自由」;而不是免费啤酒(free beer)」中的「免费」
>
> 更精确地说,自由软件赋予软件使用者四项基本自由:
>
Expand Down

0 comments on commit 6b8aed3

Please sign in to comment.