From 5a4f7cdf37ef96ac11ec823bd6159ebb2958e914 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=8F=E5=BC=9F=E8=B0=83=E8=B0=83?= <398188662@qq.com> Date: Wed, 13 Aug 2025 22:32:12 +0800 Subject: [PATCH] doc: format markdown. --- docs/python.md | 8 +++++++- docs/ssh.md | 1 - docs/swift.md | 8 +++----- docs/wails.md | 19 +++++++++---------- 4 files changed, 19 insertions(+), 17 deletions(-) diff --git a/docs/python.md b/docs/python.md index db33df55..01ce3f35 100644 --- a/docs/python.md +++ b/docs/python.md @@ -1397,6 +1397,7 @@ Yoki.sound() # => Woof! ### 属性封装与访问控制 实现计算属性、只读属性和验证逻辑。 + ```python class Person: def __init__(self, age): @@ -1840,9 +1841,11 @@ else: # try/except 块的可选子句。 必须遵循除块 finally: # 在所有情况下执行 print("我们可以在这里清理资源") ``` + ### 高阶函数map 将一个函数应用到可迭代对象(如列表)的每个元素上,并返回一个新的迭代器。 + ```python def square(x): return x ** 2 @@ -1858,6 +1861,7 @@ print(list(result)) # 输出: [1, 4, 9, 16] ### 高阶函数sorted 对可迭代对象进行排序,返回一个新的已排序列表(原对象不变) + ```python # 按照分数排序 users = [ @@ -1883,6 +1887,7 @@ for user in sorted_users: ### 高阶函数reduce 将一个二元函数(接受两个参数的函数)累积应用到可迭代对象的元素上,最终合并为单个值 + ```python from functools import reduce @@ -1896,9 +1901,11 @@ result = reduce(multiply, numbers) print(result) # 输出: 120(2×3×4×5=120) ``` + ### 偏函数 固定原函数的某些参数,生成新函数 + ```python from functools import partial @@ -1914,7 +1921,6 @@ print(square(5)) # 输出: 25 (5²) print(square(10)) # 输出: 100 (10²) ``` - ### pyenv & pipenv diff --git a/docs/ssh.md b/docs/ssh.md index c80a1dc9..ce227018 100644 --- a/docs/ssh.md +++ b/docs/ssh.md @@ -296,7 +296,6 @@ $ ssh -L 4000:192.168.1.10:80 user@example.com -N 其中 `-N` 表示不执行远程命令,只是建立隧道。 - ### 远程端口转发 diff --git a/docs/swift.md b/docs/swift.md index 1ed83562..aa73d714 100644 --- a/docs/swift.md +++ b/docs/swift.md @@ -2027,12 +2027,11 @@ print(intStorage.retrieve() ?? "Empty") `swift-inspect` | 模块/符号分析工具 | 检查模块结构/调试工具输出 - ### swift — 脚本执行 & REPL 命令 | 说明 -:-- | :-- +:-- | :-- `swift` | 启动交互式环境(REPL) `swift my_script.swift` | 运行 Swift 脚本文件 `swift build` | 使用 SwiftPM 编译项目 @@ -2068,7 +2067,7 @@ $ swift package dump-package 命令 | 说明 -:-- | :-- +:-- | :-- `swiftc main.swift` | 编译为默认名 `main` 的可执行文件 `swiftc main.swift -o myapp` | 编译为 `myapp` 可执行文件 `swiftc -c Foo.swift` | 编译为中间的 `.o` 文件 @@ -2080,12 +2079,11 @@ $ swift package dump-package `swiftc -emit-object Foo.swift` | 输出目标文件 `.o` - ### swift-inspect 命令 | 说明 -:-- | :-- +:-- | :-- `swift-inspect MyApp` | 分析一个编译产物(如 `.app`、`.dylib`) `swift-inspect --symbols MyModule.swiftmodule` | 查看模块的符号信息 `swift-inspect --help` | 查看所有可用选项 diff --git a/docs/wails.md b/docs/wails.md index 6fa9b51b..9e41751e 100644 --- a/docs/wails.md +++ b/docs/wails.md @@ -292,14 +292,14 @@ ClipboardSetText("text") ### Windows 打包 -#### 默认生成: `.exe` 可执行文件。 +#### 默认生成: `.exe` 可执行文件 ```bash $ wails build -platform windows/amd64 ``` -#### 生成 NSIS 安装程序: +#### 生成 NSIS 安装程序 **前提条件**: 需要预先安装 [NSIS (Nullsoft Scriptable Install System)](https://nsis.sourceforge.io/Download)。 @@ -320,7 +320,7 @@ $ wails build -platform windows/amd64 $ wails build -platform windows/amd64 -nsis ``` -#### 处理 WebView2 依赖: +#### 处理 WebView2 依赖 `download`: 提示用户下载 WebView2。 @@ -328,11 +328,13 @@ $ wails build -platform windows/amd64 -nsis ```bash $ wails build -platform windows/amd64 -webview2 download ``` + `embed`: 将 WebView2 嵌入到应用中(推荐)。 ```bash $ wails build -platform windows/amd64 -webview2 embed ``` + `browser`: 在浏览器中打开下载页面。 ```bash @@ -341,20 +343,19 @@ $ wails build -platform windows/amd64 -webview2 browser ### macOS 打包 - -#### 默认生成: `.app` 应用程序包。 +#### 默认生成: `.app` 应用程序包 ```bash $ wails build -platform darwin/amd64 ``` -#### 代码签名与公证: +#### 代码签名与公证 需要通过 Apple 开发者账户进行 **代码签名** 和 **公证** 才能分发。 -#### 跳过打包成 `.app` 步骤: +#### 跳过打包成 `.app` 步骤 ```bash @@ -389,7 +390,7 @@ $ wails build -platform linux/amd64 -rpm #### AppImage 支持 -Wails 不直接内置对 AppImage 的支持,但可以使用外部工具手动创建。使用 `appimagetool`: +Wails 不直接内置对 AppImage 的支持,但可以使用外部工具手动创建。使用 `appimagetool`: ```shell appimagetool ./your-app-dir @@ -474,7 +475,6 @@ func (a *App) LongRunningTask(ctx context.Context) error { - **Go 部分**: 使用 `wails dev -debug` 启动并附加您的 Go 调试器。 - **前端部分**: 在 `wails dev` 模式下,右键点击应用,选择“检查”打开浏览器开发者工具。 - ### 性能优化 #### 构建优化 @@ -528,7 +528,6 @@ $ wails dev $ wails dev -frontenddevserverurl http://localhost:3000 ``` - 参考资料 ---