chore: auto wrap text, fix typos

.gitignore

@@ -117,3 +117,4 @@ testdir
 
 bin/
 obj/
+.pre-commit-config.yaml

.prettierignore

@@ -0,0 +1,15 @@
+LICENSE.md
+dist
+pnpm-lock.yaml
+flake.lock
+vercel.json
+cache
+temp
+.temp
+themes/
+.github/
+data/
+static-suprises/
+static/
+assets/
+layouts/

.prettierrc.yaml

@@ -0,0 +1,6 @@
+# https://prettier.io/docs/en/options
+semi: false
+singleQuote: false
+printWidth: 100
+proseWrap: always # always change wrapping in markdown text
+trailingComma: es5

.typos.toml

@@ -0,0 +1,16 @@
+[files]
+ignore-dot = true
+ignore-files = true
+extend-exclude = ["themes/", "data/", "static-surprises/", "resources/"]
+
+[default]
+binary = false
+# ignore some special identifiers(sha256, mac address, crypto keys, etc)
+extend-ignore-re = [
+  "UE",          # Unreal Engine 5
+  "i-0b662ef9931388ba0", # AWS instance id
+  "LBa", # AWS load balancer
+  "BA", # latex symbol
+  "iterm2", # iterm2 terminal
+  "802.3ba-2010" # IEEE standard
+]

3d graphics & modeling/3d-printing/README.md

@@ -5,15 +5,17 @@
 我买这台打印机参考的网友建议有：
 
 - 新手一定要买知名品牌如创想三维、ELEGOO、ANYCUBIC，而且一定要有自动调平功能。
-  - 千万别买自组机，因为自组机非常耗费时间跟精力，新手玩很容易弃坑（除非你有足够的时间跟精力慢慢组装、调试机器）。
+  - 千万别买自组机，因为自组机非常耗费时间跟精力，新手玩很容易弃坑（除非你有足够的时间跟精力慢慢组
+    装、调试机器）。
 - 新手一定要买 FDM 熔积成型类型的打印机
   - 不要买光固化，光固化虽然速度快且足够精细，但后期处理很繁琐很耗费精力，容易劝退新手。
-- 买了第一台打印机后，如果成功玩上了，下一步显然是 DIY，所以建议买 I3 结构的成品机，网上成熟的 DIY 方案很多。因此不建议买著名的 K3MS，虽然极其稳定但是太贵了。
+- 买了第一台打印机后，如果成功玩上了，下一步显然是 DIY，所以建议买 I3 结构的成品机，网上成熟的 DIY
+  方案很多。因此不建议买著名的 K3MS，虽然极其稳定但是太贵了。
 
 等玩熟了之后可以再考虑 DIY 一台自己的 Core-XY 打印机，或者上 3D 光固化。
 
-最终选择了目前性价比最高的 ELEGOO Neptune 3 Pro，同价位配置相对很高，被称为「卷王」。
-朋友说这个价格已经相当便宜了，很值得入手。
+最终选择了目前性价比最高的 ELEGOO Neptune 3 Pro，同价位配置相对很高，被称为「卷王」。朋友说这个价格
+已经相当便宜了，很值得入手。
 
 ### 如何找 3D 模型
 
@@ -24,23 +26,25 @@
 - 其他的
   - https://www.cgtrader.com/3d-print-models
   - https://free3d.com/zh/
-  - https://www.turbosquid.com/Search/3D-Models/free 
+  - https://www.turbosquid.com/Search/3D-Models/free
   - ...
 
 ### 如何转换与打印模型
 
-
-1. 首先需要有已经准备好的 OBJ/STL 格式的模型，这个模型可以在前面提供的网站上下载，也可以自己学习使用参数化建模软件来设计。
-2. 打印前，要考虑好基本的物理支撑结构，找到需要的「额外支撑」最少的摆放方式，并据此调整模型角度，通常这样打印出的东西结构强度也最高。
-3. 需要使用开源的切片软件 [Cura](https://github.com/Ultimaker/Cura) 调整模型，它会通过内置算法设定好合适的打印走线方式。
+1. 首先需要有已经准备好的 OBJ/STL 格式的模型，这个模型可以在前面提供的网站上下载，也可以自己学习使用
+   参数化建模软件来设计。
+2. 打印前，要考虑好基本的物理支撑结构，找到需要的「额外支撑」最少的摆放方式，并据此调整模型角度，通
+   常这样打印出的东西结构强度也最高。
+3. 需要使用开源的切片软件 [Cura](https://github.com/Ultimaker/Cura) 调整模型，它会通过内置算法设定好
+   合适的打印走线方式。
 4. 将模型导出并复制到 U 盘，然后插入打印机开始打印。
 
-
 ### 打印机耗材
 
 我手上只有 FDM 打印机，所以直接看 FDM 耗材：
 
-- PLA 聚乳酸: 使用淀粉制作的新型可再生生物降解材料，具有良好的拉伸强度，经济实惠。但是机械强度不高，适合打印概念模型
+- PLA 聚乳酸: 使用淀粉制作的新型可再生生物降解材料，具有良好的拉伸强度，经济实惠。但是机械强度不高，
+  适合打印概念模型
   - ELEGOO 官方卖的 PLA 是 69 一卷 1KG
   - 目前看到卖最离谱的是创想三维，溢价太高了。
 - ABS 塑料: 具有持久的机械强度跟稳定性，适合打印最终成品
@@ -49,13 +53,15 @@
   - 典型應用包括柔性軟管、導管、進氣管、密封件、防護罩和減震器等
 - PETG: 同时拥有 ABS 的刚性和机械性能以及 PLA 的易打印、无异味
 
-耗材相关品牌，知名的有「易生」，不过贵。另外最近很多人推荐天瑞的 PETG-ECO 这款耗材，相当便宜而且据说不坑。
-
-上述耗材还有许多变种，不同材料、加入的杂质不同，都会影响打印效果。
-大家说普通 PLA 最好打原因就是它不易拉丝、欠挤出、翘边，但是如果换其他材料，就可能会出各种问题，需要通过调整热床温度、挤出头温度、热床涂胶水防翘边等等手段来解决。
+耗材相关品牌，知名的有「易生」，不过贵。另外最近很多人推荐天瑞的 PETG-ECO 这款耗材，相当便宜而且据说
+不坑。
 
-另外所有耗材都需要防潮。如果受潮了，网上有线材专用烘干机卖不过比较贵。省钱的话像我用三面围挡式的暖脚宝来烘干也行，重点是温度不能太高，40 - 50 度左右就行。
+上述耗材还有许多变种，不同材料、加入的杂质不同，都会影响打印效果。大家说普通 PLA 最好打原因就是它不
+易拉丝、欠挤出、翘边，但是如果换其他材料，就可能会出各种问题，需要通过调整热床温度、挤出头温度、热床
+涂胶水防翘边等等手段来解决。
 
+另外所有耗材都需要防潮。如果受潮了，网上有线材专用烘干机卖不过比较贵。省钱的话像我用三面围挡式的暖脚
+宝来烘干也行，重点是温度不能太高，40 - 50 度左右就行。
 
 ### 模型后处理
 
@@ -68,27 +74,30 @@
 
 此外如果是精细手办等模型，还需要上色，这个感觉也是个手艺活...后面再研究吧。
 
-
 ### 如何设计自己的 3D 打印件
 
-目前最流行的 3D 打印设计软件貌似是 Autodesk 家的 Fusion 360，不过我作为开源爱好者与 Linux 爱好者，当然倾向于选择开源且支持 Linux 的软件。
+目前最流行的 3D 打印设计软件貌似是 Autodesk 家的 Fusion 360，不过我作为开源爱好者与 Linux 爱好者，当
+然倾向于选择开源且支持 Linux 的软件。
 
 了解了一番发现 3D 设计软件按底层原理分类有两类：
 
-1. 多边形建模：流行的开源 3D 设计与动画制作软件 Blender 的特点就是多边形建模，适合做动画，但是不适合做仿真，用它设计 3D 打印件有困难。
+1. 多边形建模：流行的开源 3D 设计与动画制作软件 Blender 的特点就是多边形建模，适合做动画，但是不适合
+   做仿真，用它设计 3D 打印件有困难。
 2. 参数化建模：刚刚提到的 Fusion 360，以及开源的 FreeCAD，都是这个类别。
-   1. FreeCAD 据说已经勉强能胜任产品级的设计了，不过相比商业软件还有较大差距。对我个人玩耍而言，应该可堪一用了。
+   1. FreeCAD 据说已经勉强能胜任产品级的设计了，不过相比商业软件还有较大差距。对我个人玩耍而言，应该
+      可堪一用了。
 
-因此，看起来如果要玩 3D 设计，还想打印些手办啥的，FreeCAD 应该是比较好的选择，手办的话 Blender 也得学一学。
+因此，看起来如果要玩 3D 设计，还想打印些手办啥的，FreeCAD 应该是比较好的选择，手办的话 Blender 也得
+学一学。
 
 ### 打印机改造
 
 TODO
 
-
 ### DIY 打印机
 
-- [VoronDesign](https://github.com/VoronDesign): 朋友说这个 voron2 现在很火，core-xy 结构速度应该能比我的 i3 机器快很多。
+- [VoronDesign](https://github.com/VoronDesign): 朋友说这个 voron2 现在很火，core-xy 结构速度应该能
+  比我的 i3 机器快很多。
 - 打印机固件
   - [klipper](https://github.com/Klipper3d/klipper): 最流行的 Linux 3D 打印机固件
   - [Marlin](https://github.com/MarlinFirmware/Marlin): 最流行的基于 MCU 的 3D 打印机固件

3d graphics & modeling/README.md

@@ -7,34 +7,37 @@
 最知名的两个图形学引擎，尤其是 3D 图形学引擎，目前来说就三个：
 
 - Unreal Engine 5: 顶级画质与体验，但是更复杂
-    - 游戏开发、建筑可视化、影视制作，都是 Unreal 的目标场景
-    - 主要只支持两种编程手段：C++ 与蓝图
-    - C++ 语言本身就比较复杂，同时 UE5 还引入了非常多它自定义的宏，学习难度较高
-    - 蓝图是一个通过拖拽实现的开发工具，底层会编译成 C++ 因此性能很高，但问题是它是二进制格式，无法使用 Git 仓库存储，而且编程步骤会比直接用 C++ 繁琐很多。
-    - 开源引擎
-- Unity3D: 简单易学，可以快速上手，画面跟 3A 相比一般，但是用于制作一些写意的 3D 动画或游戏是完全够用的。
-    - 主要支持使用 C#/lua 两种语言
-    - 闭源，不过个人版有免费授权
+  - 游戏开发、建筑可视化、影视制作，都是 Unreal 的目标场景
+  - 主要只支持两种编程手段：C++ 与蓝图
+  - C++ 语言本身就比较复杂，同时 UE5 还引入了非常多它自定义的宏，学习难度较高
+  - 蓝图是一个通过拖拽实现的开发工具，底层会编译成 C++ 因此性能很高，但问题是它是二进制格式，无法使
+    用 Git 仓库存储，而且编程步骤会比直接用 C++ 繁琐很多。
+  - 开源引擎
+- Unity3D: 简单易学，可以快速上手，画面跟 3A 相比一般，但是用于制作一些写意的 3D 动画或游戏是完全够
+  用的。
+  - 主要支持使用 C#/lua 两种语言
+  - 闭源，不过个人版有免费授权
 - Godot: 开源引擎，与 Unity3D 类似，目前也比较受欢迎。
 
 此外就是建模、材质工具、布料解算、骨骼模拟等专用工具了，其中最出名的是开源工具 Blender.
 
->2022-04-10最近突然想学学游戏引擎，原因是手边有台 Quest 2 VR 头显吃灰有一阵了，想拿来搞搞 VR 开发，另外还想自己制作些超高画质（4k/6k/8k）的 MMD 动画放 VR 里看。
-
+> 2022-04-10最近突然想学学游戏引擎，原因是手边有台 Quest 2 VR 头显吃灰有一阵了，想拿来搞搞 VR 开发，
+> 另外还想自己制作些超高画质（4k/6k/8k）的 MMD 动画放 VR 里看。
 
 ## 业余爱好者的 VR 开发与 VR 动画制作学习路线
 
 先罗列下我的需求：
 
 - 需要支持 Quest 2 跟 SteamVR
-    - Unreal 跟 Unity3D 都支持
+  - Unreal 跟 Unity3D 都支持
 - 画质一定要高，就是想体验下极致的画质
-    - 如果是纪念碑谷这类写意风格的话，Unity3D 就完全足够了
-    - 如果是 3A 游戏或者 MMD 布料解算这类写实风格的话，就需要 Unreal/Blender 才能提供足够的画质
+  - 如果是纪念碑谷这类写意风格的话，Unity3D 就完全足够了
+  - 如果是 3A 游戏或者 MMD 布料解算这类写实风格的话，就需要 Unreal/Blender 才能提供足够的画质
 - 快糙狠，需要能快速出成果
-    - Unity3D 跟 Unreal 蓝图应该都能达成这个目标
+  - Unity3D 跟 Unreal 蓝图应该都能达成这个目标
 
-综合来看，感觉学一学 Unreal Engine 的蓝图是最优的选项，画质够高，学习难度也低，应该也能快速出成果，后面进阶可以再考虑 C++.
+综合来看，感觉学一学 Unreal Engine 的蓝图是最优的选项，画质够高，学习难度也低，应该也能快速出成果，
+后面进阶可以再考虑 C++.
 
 学习方法的话，一是直接看官方文档，二是找找官方及社区的 Youtube 视频教程吧。
 
@@ -43,22 +46,26 @@
 那么总结一下学习路线：
 
 1. 学习 UE5 基础知识
-    - 官方文档：<https://docs.unrealengine.com/5.0/zh-CN/>
-    - 社区视频教程：
-        - Youtube 上最火的 UE5 视频 [Unreal Engine 5 Beginner Tutorial - UE5 Starter Course!](https://www.youtube.com/watch?v=gQmiqmxJMtA): 长达 5 个小时的 UE5 教学视频，手把手教学。
-        - 其他看着还不错的教学视频
-            - https://www.youtube.com/watch?v=ptCN4cysDig
-            - https://www.youtube.com/watch?v=e-nENnVVtJA
-    - [UE5 的 VR 编辑模式](https://docs.unrealengine.com/5.0/zh-CN/vr-mode-in-unreal-editor/): 直接带上头盔，在 VR 世界进行游戏/动画的制作
-    - 交互式 XR 场景动画：好处是可以实时交互，甚至可以移动
-        - 可以对接 SteamVR 或者 Oculus，借助 UE5 可实现高质量的实时渲染
-    - VR 视频制作：不可交互，但好处是可以通过长时间渲染达成极高画质，比如使用 1h 来渲染一个 3mins 的视频
-        - [Unreal Engine for 360° VR & ArchViz Virtual Tour Video In-depth Tutorial | Oculus TV + YouTube VR](https://www.youtube.com/watch?v=TLHyMwQ0bo0)
+   - 官方文档：<https://docs.unrealengine.com/5.0/zh-CN/>
+   - 社区视频教程：
+     - Youtube 上最火的 UE5 视频
+       [Unreal Engine 5 Beginner Tutorial - UE5 Starter Course!](https://www.youtube.com/watch?v=gQmiqmxJMtA):
+       长达 5 个小时的 UE5 教学视频，手把手教学。
+     - 其他看着还不错的教学视频
+       - https://www.youtube.com/watch?v=ptCN4cysDig
+       - https://www.youtube.com/watch?v=e-nENnVVtJA
+   - [UE5 的 VR 编辑模式](https://docs.unrealengine.com/5.0/zh-CN/vr-mode-in-unreal-editor/): 直接带
+     上头盔，在 VR 世界进行游戏/动画的制作
+   - 交互式 XR 场景动画：好处是可以实时交互，甚至可以移动
+     - 可以对接 SteamVR 或者 Oculus，借助 UE5 可实现高质量的实时渲染
+   - VR 视频制作：不可交互，但好处是可以通过长时间渲染达成极高画质，比如使用 1h 来渲染一个 3mins 的
+     视频
+     - [Unreal Engine for 360° VR & ArchViz Virtual Tour Video In-depth Tutorial | Oculus TV + YouTube VR](https://www.youtube.com/watch?v=TLHyMwQ0bo0)
 2. blender 基础
-    - [Blender 2.9-3.1黑铁骑士Ⅱ系统零基础入门教程](https://www.bilibili.com/video/BV1zh411Y7LX)
+   - [Blender 2.9-3.1黑铁骑士Ⅱ系统零基础入门教程](https://www.bilibili.com/video/BV1zh411Y7LX)
 3. MMD 二次元老婆模型、动作、场景资源
-    - [模型屋 - 大量正版二次元老婆模型、动作](https://www.aplaybox.com/)
-    - [永昼UE】免费UE教程#01 PMX模型导入虚幻引擎5教程以及为什么这么做](https://www.bilibili.com/video/BV1uL411c7HH)
+   - [模型屋 - 大量正版二次元老婆模型、动作](https://www.aplaybox.com/)
+   - [永昼UE】免费UE教程#01 PMX模型导入虚幻引擎5教程以及为什么这么做](https://www.bilibili.com/video/BV1uL411c7HH)
 4. 参数化建模：通过具体的参数进行精确建模
    - [openscad](https://github.com/openscad/openscad): 通过编程进行参数化建模
    - [FreeCAD](https://github.com/FreeCAD/FreeCAD): 开源的 CAD 软件

3d graphics & modeling/Unreal Engine 5/README.md

@@ -1,5 +1,3 @@
 # Unreal Engine 5
 
-
 TBD
-

3d graphics & modeling/taichi/README.md

@@ -11,6 +11,3 @@
   - 视觉与机器人学
   - 影视特效
   - 通用编程
-
-
-

3d graphics & modeling/创造性编程.md

@@ -2,17 +2,20 @@
 
 可是因为各种原因（懒、三分钟热度），现在最终成了一个半吊子运维开发。
 
-然后最近这段时间，Wenyan-lang 在 Github 上大火，也带着我认识了一番 **creative-coding** 这个词，也就是**创造性编程**。老夫也想聊发一下少年狂了。
+然后最近这段时间，Wenyan-lang 在 Github 上大火，也带着我认识了一番 **creative-coding** 这个词，也就
+是**创造性编程**。老夫也想聊发一下少年狂了。
 
-我是因为觉得编程有趣，写游戏好玩，黑客很酷才自学的编程，可现在从事的工作却和最初的想法南辕北辙。虽然说也算如了一半的愿景——工作确实是写代码，也确实不怎么枯燥。
+我是因为觉得编程有趣，写游戏好玩，黑客很酷才自学的编程，可现在从事的工作却和最初的想法南辕北辙。虽然
+说也算如了一半的愿景——工作确实是写代码，也确实不怎么枯燥。
 
 可是我想做的很多事，却一直搁置到现在：
 
 1. 想玩玩 3D 编程，也想自己尝试下渲染/打印个自己的手办(Waifu)。
 1. 想玩玩开源硬件，比如自己实现个画画机器人/3D打印机。
 1. 想稍微学一学钢琴，然后进阶玩玩音乐制作。
 
-于是今天又百度一番，定了个可能永远不会执行的计划（就像曾经半途而废的爬虫学习计划、Java学习计划、Python/Java源码阅读计划、C语言进阶计划、Python音乐处理计划那样）。。。
+于是今天又百度一番，定了个可能永远不会执行的计划（就像曾经半途而废的爬虫学习计划、Java学习计
+划、Python/Java源码阅读计划、C语言进阶计划、Python音乐处理计划那样）。。。
 
 ## 3D 编程与手办渲染/打印
 
@@ -29,4 +32,4 @@
 1. 钢琴：正在通过 Midi 键盘学习，起码要到能弹奏流行钢琴音乐的程度。
 1. 乐理：这个边学钢琴边补，主要是和弦和转调之类的，要烂熟于心。
 1. 编程：[Python 的音乐处理库](https://www.cnblogs.com/kirito-c/p/9088038.html)
-1. 音乐制作：FL Studio
+1. 音乐制作：FL Studio