From ad9b4ec7d58187fd3daf0e816dd382fcbd294a17 Mon Sep 17 00:00:00 2001 From: ShinKouyo Date: Fri, 20 Nov 2026 21:18:36 +0800 Subject: docs(fix): 修正命令错误与过时描述 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Assisted-by: DeepSeek-V4.1-Flash-1017 Signed-off-by: ShinKouyo --- docs/advanced/boot_loader.md | 4 ++-- docs/advanced/btrfs/btrfs.md | 2 +- docs/advanced/btrfs/linux_on_btrfs.md | 2 +- docs/advanced/btrfs/migrating_to_btrfs.md | 4 ++-- docs/advanced/lvm.md | 4 ++-- docs/applications/ai/opencode.md | 2 +- docs/applications/apps.md | 2 +- docs/applications/editors/emacs.md | 4 ++-- docs/applications/editors/nano.md | 8 ++++---- docs/applications/editors/vim.md | 6 +++--- docs/applications/multimedia/kdenlive.md | 2 +- docs/applications/multimedia/obs_studio.md | 2 +- docs/applications/other/fastfetch.md | 2 +- docs/applications/programming/git.md | 4 ++-- docs/applications/shell/bash.md | 2 +- docs/compatibility/windows/vm.md | 2 +- docs/compatibility/windows/wine/bottles.md | 4 ++-- docs/desktop/de/kde.md | 8 ++++---- docs/desktop/wm/hyprland.md | 2 +- docs/desktop/wm/i3.md | 2 +- docs/desktop/wm/sway.md | 2 +- docs/distros/debian/debian.md | 2 +- docs/distros/gentoo.md | 2 +- docs/distros/nixos.md | 2 +- docs/distros/rhel/almalinux.md | 4 ++-- docs/distros/rhel/fedora.md | 2 +- docs/distros/rhel/rocky.md | 2 +- docs/getting-started/common-command.md | 2 +- docs/getting-started/devices/drivers.md | 18 +++++++++--------- docs/getting-started/devices/others.md | 2 +- docs/getting-started/input-method.md | 2 +- docs/getting-started/install.md | 2 +- docs/getting-started/network.md | 2 +- docs/getting-started/post-installation.md | 4 ++-- docs/getting-started/purpose.md | 17 ++++++++--------- 35 files changed, 66 insertions(+), 67 deletions(-) diff --git a/docs/advanced/boot_loader.md b/docs/advanced/boot_loader.md index 9d50d33..3a39f57 100644 --- a/docs/advanced/boot_loader.md +++ b/docs/advanced/boot_loader.md @@ -16,7 +16,7 @@ GRUB_THEME=/boot/grub/themes/主题文件夹/theme.txt # 一般为theme.txt,部分主题可能不同 ``` -最后,运行`sudo upgrade-grub`来更新GRUB配置即可。 +最后,运行`sudo update-grub`来更新GRUB配置即可。 ## rEFInd @@ -38,7 +38,7 @@ rEFInd是已停止维护的 rEFIt 项目的分支,最初旨在解决非Mac电 大部分发行版已经预置了签名过的shimx64.efi,您只需要替换以下指令`--shim`后的路径即可。 ```bash -sudo refind install --shim /boot/efi/一般为发行版名称/shimx64.efi +sudo refind-install --shim /boot/efi/一般为发行版名称/shimx64.efi # EFI目录可能存在差异 # 或者,您也可以使用/usr/share/shim-signed/shimx64.efi ``` diff --git a/docs/advanced/btrfs/btrfs.md b/docs/advanced/btrfs/btrfs.md index 4f8b2f6..4ee3390 100644 --- a/docs/advanced/btrfs/btrfs.md +++ b/docs/advanced/btrfs/btrfs.md @@ -15,7 +15,7 @@ Btrfs即B-tree文件系统,通常念成Butter FS,Better FS或B-tree FS,一 Btrfs有以下常见功能: -- 子卷(一个或多个可单独挂载的区域,基于每个物理分区划分) +- 子卷(同一 Btrfs 文件系统内可独立挂载的区域) - 快照(只读与可写,写时复制,子卷复制) - 就地转换(支持回滚):可从 ext3/4 与 ReiserFS 转换 - 压缩(全自动透明压缩) diff --git a/docs/advanced/btrfs/linux_on_btrfs.md b/docs/advanced/btrfs/linux_on_btrfs.md index 483cd66..7131811 100644 --- a/docs/advanced/btrfs/linux_on_btrfs.md +++ b/docs/advanced/btrfs/linux_on_btrfs.md @@ -127,7 +127,7 @@ Linux 是自由的,任何布局,只要有一个子卷挂载到 ``/``,都 /dev/sda6 on /mnt/btrfs type btrfs ( ... subvol=/) ``` -现在开始创建子卷,以只有 ``@home`` 一个子卷的布局为例。为了保持兼容性以使用 Timeshift 等工具,我们将默认的 ``@rootfs`` 子卷重命名为 ``@``。 +现在开始创建子卷,以单独分出 ``@home`` 的布局为例。为了保持兼容性以使用 Timeshift 等工具,我们将默认的 ``@rootfs`` 子卷重命名为 ``@``。 ???+ note "有关在根目录上挂载的子卷的名字" Debian 默认使用 ``subvol=/@rootfs`` 作为根目录使用的子卷,而大多数主流发行版倾向使用 ``subvol=/@``。如果使用 Ubuntu 等发行版并正按照本指南操作,不需要移动子卷。 diff --git a/docs/advanced/btrfs/migrating_to_btrfs.md b/docs/advanced/btrfs/migrating_to_btrfs.md index e1fe2a2..4c1089a 100644 --- a/docs/advanced/btrfs/migrating_to_btrfs.md +++ b/docs/advanced/btrfs/migrating_to_btrfs.md @@ -214,7 +214,7 @@ Resize device id 1 (/dev/sda2) from 32.00GiB to max ``--move-data`` 代表在更改分区表时一并移动数据,请不要省略。 - sfdisk 的输入格式是 ``<起始位置>``、``<分区大小>``、``<分区类型>``、``<是否可启动 *仅MBR >``,各项目之间用逗号隔开。 + sfdisk 的输入格式是 ``<起始位置>``、``<分区大小>``、``<分区类型>``、``<是否可启动 *仅MBR >``,实际输入时各项目之间用英文逗号隔开。 进入时,屏幕上方会打印现在的分区表 ``Old situation:`` ```text @@ -245,7 +245,7 @@ Resize device id 1 (/dev/sda2) from 32.00GiB to max ??? tip "Arch 系发行版...?" 使用 Arch 系发行版的 livecd 可以逃课。 - 把包括 EFI 和 swap 在内的所有分区都挂载或启用到 ``/mnt/newroot`` 下,让 ``genfstab`` 能识别它们。 + 把包括 EFI 在内的分区挂载到 ``/mnt/newroot`` 下,并启用 swap 分区,让 ``genfstab`` 能识别它们。 ```bash root@archiso ~ # mount /dev/sda1 /mnt/newroot/boot/efi root@archiso ~ # swapon /dev/sda6 diff --git a/docs/advanced/lvm.md b/docs/advanced/lvm.md index bdc953a..09dc270 100644 --- a/docs/advanced/lvm.md +++ b/docs/advanced/lvm.md @@ -12,7 +12,7 @@ - **VG:卷组**,建立在PV之上,由一个或多个PV组成,可以在VG上创建一个或多个“LVM分区”(逻辑卷),功能类似一块标准的物理硬盘。VG 就像把若干泳池围在一起的隔离区:一个隔离区可以由多个泳池组成,为你提供一块容量巨大、可以动态调配的虚拟水池。 -- **LV:逻辑卷**,从VG中分割出的一块空间,创建之后可以随时增减它的容量,在LV上可以建立文件系统(如/var,/home)。LV 就像在这些泳池里用绳子划分出来的一个个小区域。你可以根据需求随时把区域扩大或缩小,然后在房间里布置不同的家具——也就是创建文件系统,比如这个房间当儿童泳池(/home),那个房间当竞赛泳池(/var)。* +- **LV:逻辑卷**,从VG中分割出的一块空间,创建之后可以随时增减它的容量,在LV上可以建立文件系统(如/var,/home)。LV 就像在隔离区里用绳子划分出来的一个个小区域。你可以根据需求随时把区域扩大或缩小,然后在房间里布置不同的家具——也就是创建文件系统,比如这个房间当儿童泳池(/home),那个房间当竞赛泳池(/var)。 !!! warning "严重警告" - 不推荐新手接触 LVM,它相当复杂。 \ No newline at end of file + 不推荐新手接触 LVM,它相当复杂。 diff --git a/docs/applications/ai/opencode.md b/docs/applications/ai/opencode.md index 49f505a..733e211 100644 --- a/docs/applications/ai/opencode.md +++ b/docs/applications/ai/opencode.md @@ -30,6 +30,6 @@ opencode 以此启动OpenCode。 -如果你无法启动,通常注销后重新登录即可解决,如果登出依然无法解决,可能是因为你更改了默认Shell,可以重新通过命令安装或者上网检索如何修改你使用的Shell的环境变量。 +如果你无法启动,通常注销后重新登录即可解决,如果注销后依然无法解决,可能是因为你更改了默认Shell,可以重新通过命令安装或者上网检索如何修改你使用的Shell的环境变量。 具体方法参照[OpenCode官方文档](https://opencode.ai/docs/zh-cn)。 diff --git a/docs/applications/apps.md b/docs/applications/apps.md index ad08487..58b5d79 100644 --- a/docs/applications/apps.md +++ b/docs/applications/apps.md @@ -187,4 +187,4 @@ Flatpak是Linux新一代跨平台软件安装解决方案。它通过沙箱设 AppImage是一种通用的软件包格式,可以理解为Windows上的绿色版软件。它通过打包依赖来免去额外安装依赖的麻烦,具有通用性,可以在几乎所有发行版上运行。AppImage包没有统一的管理器。 ???+ note "权限问题" - 在下载AppImage后,您需要运行`chmod +x 软件包`来给予其执行权限。 \ No newline at end of file + 在下载AppImage后,您需要运行`chmod +x 软件包`来给予其执行权限。 diff --git a/docs/applications/editors/emacs.md b/docs/applications/editors/emacs.md index a4ff440..6a1c0d5 100644 --- a/docs/applications/editors/emacs.md +++ b/docs/applications/editors/emacs.md @@ -168,7 +168,7 @@ d e l e t e t h i s ???+ tips "提示" - [#移动光标](#快捷键) 的内容可以在这里用哦。 + [移动光标](#移动光标) 的内容可以在这里用哦。 连续按两下 `C`-`SPC` 以退出选区。 @@ -192,7 +192,7 @@ d e l e t e t h i s ##### 替换 -下面的 `Eamcs` 拼写有误,我们使用 `M`-`%` 查找并替换它。按下 `M`-`%`,输入 ``Eamcs``,再输入 ``Emacs``,输入 ``y`` 确认替换。 +下面故意把 `Emacs` 拼错成 `Eamcs`,我们使用 `M`-`%` 查找并替换它。按下 `M`-`%`,输入 ``Eamcs``,再输入 ``Emacs``,输入 ``y`` 确认替换。 ??? tip "如果不想逐个确认..." Eamcs 有一个命令,叫 ``replace-string``,但是默认不绑定至任何键位。如果要运行它,我们先按 `M`-`x`,再手动输入 `replace-string`。 diff --git a/docs/applications/editors/nano.md b/docs/applications/editors/nano.md index 2755004..ea8eb59 100644 --- a/docs/applications/editors/nano.md +++ b/docs/applications/editors/nano.md @@ -138,8 +138,8 @@ nano 按 `M-A` 进入选区模式,移动光标使选区覆盖想操作的文本。 -按 `^K` 剪切选区内的文本; -按 `M-6` 复制选区内的文本; +按 `^K` 剪切选区内的文本; +按 `M-6` 复制选区内的文本; 按 `^U` 粘贴到光标的位置。 如果没有设置选区,会剪切或复制光标所在的一整行。 @@ -153,12 +153,12 @@ nano 按 `^F`,输入要查找的字符,按`回车键`。 -如果找到了,字符会以黄色高亮。 +如果找到了,字符会以黄色高亮。 如果没找到,窗口底部会出现红色的 `not found` 字样。 ##### 查找并替换 -按 `^\`,输入要替换的字符,按`回车键`;再输入要替换成的字符,按`回车键`。 +按 `^\`,输入要替换的字符,按`回车键`;再输入要替换成的字符,按`回车键`。 nano 会逐个询问您每处是否要替换,按 `Y` 替换此处,`N` 保留此处,`A` 替换每处且不再询问,`^C` 取消替换。 如果没找到,窗口底部会出现红色的 `not found` 字样。 diff --git a/docs/applications/editors/vim.md b/docs/applications/editors/vim.md index cec2414..57ec143 100644 --- a/docs/applications/editors/vim.md +++ b/docs/applications/editors/vim.md @@ -33,17 +33,17 @@ sudo pacman -S vim - **INSERT** -> 插入模式 -插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,与普通编辑器的编辑状态相同。 +插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,与普通编辑器的编辑状态相同。 当你处于插入模式的时候,**左下角会出现 INSERT**。 - **NORMAL** -> 普通模式 -普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**。 +普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**。 当你处于普通模式的时候,**左下角是空的**,普通是默认的模式。 - **COMMAND** -> 命令模式 -命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**。 +命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**。 这个模式也是可以批量处理文本的(比如说替换之类的操作),当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中**。 ## 模式的转换 diff --git a/docs/applications/multimedia/kdenlive.md b/docs/applications/multimedia/kdenlive.md index 5d78025..a34ab5a 100644 --- a/docs/applications/multimedia/kdenlive.md +++ b/docs/applications/multimedia/kdenlive.md @@ -1,6 +1,6 @@ # Kdenlive -[Kdenlive](https://kdenlive.org/)(全称KDE Non-Linear Video Editor)是免费开源、跨平台的视频编辑器,对Linux支持十分完善。支持多轨道剪辑、丰富特效和广泛的格式。具备代理剪辑、自动字幕、多机位、关键帧动画等功能,界面可定制,性能优化,适合从个人到专业的创作需求。 +[Kdenlive](https://kdenlive.org/)(全称KDE Non-Linear Video Editor)是免费开源、跨平台的视频编辑器,对Linux支持十分完善。支持多轨道剪辑、丰富的特效与广泛的格式。具备代理剪辑、自动字幕、多机位、关键帧动画等功能,界面可定制,性能优化,适合从个人到专业的创作需求。 !!! warning "警告" Kdenlive的学习成本较高,需要时间上手。 diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 64dfdf0..88800c4 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -112,7 +112,7 @@ OBS Studio 默认输出 1080p、最高 6000 kbps 的视频(具体取决于您 VA-API、VDPAU 可用,性能更好的 NVDEC、NVENC 也可用。 ??? warning "如果您的 Nvidia 显卡较旧..." - 我们了解到,一些发行版中最新的 FFmpeg 是基于新版本 NVENC API 的头文件构建的。如果您使用 **帕斯卡架构**(GeForce **10 系**)及更老的 Nvidia 显卡,无法使用 NVENC,可能需要降级 FFmpeg。 + 我们了解到,一些发行版中最新的 FFmpeg 是基于新版本 NVENC API 的头文件构建的。如果您使用 **帕斯卡架构**(GeForce **10 系**)及更老的 Nvidia 显卡,无法使用 NVENC,可能需要降级 FFmpeg。 如果电脑上有使用 FFmpeg 的其他软件,它们可能也需要跟着一起降级。通常您的包管理器会提醒您所有要降级的软件。 [*专有软件常常是恶意软件*](https://www.gnu.org/proprietary/proprietary.html)*。* diff --git a/docs/applications/other/fastfetch.md b/docs/applications/other/fastfetch.md index f9f1682..1407283 100644 --- a/docs/applications/other/fastfetch.md +++ b/docs/applications/other/fastfetch.md @@ -16,5 +16,5 @@ Arch系:`sudo pacman -S fastfetch` ## 使用 -安装后,使用`fastfetch`即可使用,您可以看到您的发行版、字体、内存占用、内核版本等信息。 +安装后直接运行 `fastfetch` 即可,您可以看到您的发行版、字体、内存占用、内核版本等信息。 diff --git a/docs/applications/programming/git.md b/docs/applications/programming/git.md index 032f639..33e1921 100644 --- a/docs/applications/programming/git.md +++ b/docs/applications/programming/git.md @@ -77,8 +77,8 @@ git log - `git log` 查看commit历史,每一个提交都具有一个独一无二的哈希值 - `git reflog` 可以查看您所有的操作,包括您删除的版本的哈希值 - `git reset --mixed` 这是默认使用参数,会撤销暂存区的内容并移动分支指针,但保留工作区文件 -- `git reset --hard` 会删除本地仓库和缓存区和工作区的文件 -- `git reset --soft` 只删除本地仓库的文件 +- `git reset --hard` 会把暂存区和工作区的改动一并丢弃,直接回到目标提交 +- `git reset --soft` 只移动分支指针,暂存区和工作区都保持不变 > 更推荐您使用默认参数 > diff --git a/docs/applications/shell/bash.md b/docs/applications/shell/bash.md index 43af8f0..d520b10 100644 --- a/docs/applications/shell/bash.md +++ b/docs/applications/shell/bash.md @@ -10,7 +10,7 @@ ## 概述 -Bash是一个古老的[Shell](./shell.md),大多数发行版预装了Bash并作为默认 Shell,Bash符合POSIX标准,因此大多数遵循 POSIX 标准的脚本在两者之间可以通用。 +Bash是一个古老的[Shell](./shell.md),大多数发行版预装了Bash并作为默认 Shell,Bash 大体符合 POSIX 标准,因此多数遵循 POSIX 标准的脚本可不加修改地在各类 POSIX Shell 中运行。 ## 安装 diff --git a/docs/compatibility/windows/vm.md b/docs/compatibility/windows/vm.md index 77c1cd5..339219b 100644 --- a/docs/compatibility/windows/vm.md +++ b/docs/compatibility/windows/vm.md @@ -230,7 +230,7 @@ VirtualBox 使用*树外*内核模组来完成虚拟化。为了编译 VirtualBo #### 将用户加入至 `vboxusers` 组 -只有 `vboxusers` 组内的用户才能使用 USB 设备、共享文件夹等功能;不加组也能启动虚拟机,但会受此限制。 +只有 `vboxusers` 组内的用户才能使用 USB 直通等功能(共享文件夹需在客户机内加入 `vboxsf` 组);不加组也能启动虚拟机,但会受此限制。 要将用户加入 `vboxusers` 组,执行以下命令: ```bash diff --git a/docs/compatibility/windows/wine/bottles.md b/docs/compatibility/windows/wine/bottles.md index f09c7ed..5a9669a 100644 --- a/docs/compatibility/windows/wine/bottles.md +++ b/docs/compatibility/windows/wine/bottles.md @@ -82,8 +82,8 @@ Bottles 内置了依赖管理器,可在 Bottle 详情页的“依赖项(Depe 安装完成后,Bottles 会自动扫描 Bottle 中的开始菜单快捷方式,将软件列入“程序(Programs)”列表。若列表中没有出现新装的软件(例如软件在安装时不写入开始菜单),可点击“添加快捷方式”按钮手动指定可执行文件路径。之后点击程序右侧的运行按钮即可运行该软件。 -???+ note "创建桌面快捷方式" - 在程序的菜单中选择“添加到桌面(Add Desktop Entry)”,即可在桌面和应用菜单中直接启动该软件。Flatpak 版本的 Bottles 需要额外权限才能生成桌面项,请先关闭 Bottles,然后执行: +???+ note "创建应用菜单项" + 在程序的菜单中选择“添加到桌面(Add Desktop Entry)”,即可在应用菜单中直接启动该软件。Flatpak 版本的 Bottles 需要额外权限才能生成桌面项,请先关闭 Bottles,然后执行: ```bash flatpak override com.usebottles.bottles --user --filesystem=xdg-data/applications diff --git a/docs/desktop/de/kde.md b/docs/desktop/de/kde.md index 7252c92..00ddbae 100644 --- a/docs/desktop/de/kde.md +++ b/docs/desktop/de/kde.md @@ -53,9 +53,9 @@ Kvantum(包名为`kvantum`)是一个适用于KDE桌面环境的Qt主题引 - 小部件(Plasma Widget):`~/.local/share/plasma/plasmoids/` - 壁纸插件(Wallpaper Plugin):`~/.local/share/plasma/wallpapers/` - 窗口装饰(Window Decoration):`~/.local/share/aurorae/themes/` - - 桌面特效(KWin 效果)(KWin Effect):`~/.local/share/kwin/effects/` + - 桌面特效(KWin Effect):`~/.local/share/kwin/effects/` - KWin 脚本(KWin Script):`~/.local/share/kwin/scripts/` - - 登录屏幕(SDDM)(Login Screen):无用户安装路径 + - 登录屏幕(SDDM / Login Screen):无用户安装路径 - 欢迎屏幕(Splash Screen):`~/.local/share/plasma/look-and-feel/<主题名称>/contents/splash/` ##### 系统安装 @@ -69,9 +69,9 @@ Kvantum(包名为`kvantum`)是一个适用于KDE桌面环境的Qt主题引 - 小部件(Plasma Widget):`/usr/share/plasma/plasmoids/` - 壁纸插件(Wallpaper Plugin):`/usr/share/plasma/wallpapers/` - 窗口装饰(Window Decoration):`/usr/share/aurorae/themes/` - - 桌面特效(KWin 效果)(KWin Effect):`/usr/share/kwin/effects/` + - 桌面特效(KWin Effect):`/usr/share/kwin/effects/` - KWin 脚本(KWin Script):`/usr/share/kwin/scripts/` - - 登录屏幕(SDDM)(Login Screen):`/usr/share/plasma/lookandfeel/<全局主题名称>/contents/splash/` + - 登录屏幕(SDDM / Login Screen):`/usr/share/plasma/look-and-feel/<全局主题名称>/contents/login/` - 欢迎屏幕(Splash Screen):`/usr/share/plasma/look-and-feel/<全局主题名称>/contents/splash/` (以上内容来自于[Plasma themes and plugins](https://develop.kde.org/docs/plasma/)) diff --git a/docs/desktop/wm/hyprland.md b/docs/desktop/wm/hyprland.md index 3d87888..d38f349 100644 --- a/docs/desktop/wm/hyprland.md +++ b/docs/desktop/wm/hyprland.md @@ -20,7 +20,7 @@ Hyprland拥有相对惊艳的视觉效果,并支持动态平铺窗口,能够 在美观之外,Hyprland 还拥有极其强大的定制性,修改后的配置文件在保存时会自动热加载。且支持插件扩展,并提供了基于socket的IPC机制,方便其他程序与 Hyprland 交互,实现深度定制。 !!! warning "NVIDIA 注意事项" - 由于NVIDIA对Wayland的实现问题,Hyprland官方对 NVIDIA 显卡是不受支持的(unsupported)。虽然有大量用户成功使用,但其配置过程中可能会遇到各种问题。如果你使用 NVIDIA 显卡,建议先阅读官方的 [NVIDIA 专页(英文)](https://wiki.hypr.land/Nvidia/)。 + 由于NVIDIA对Wayland的实现问题,Hyprland 官方不支持 NVIDIA 显卡(unsupported)。虽然有大量用户成功使用,但其配置过程中可能会遇到各种问题。如果你使用 NVIDIA 显卡,建议先阅读官方的 [NVIDIA 专页(英文)](https://wiki.hypr.land/Nvidia/)。 ## 安装 diff --git a/docs/desktop/wm/i3.md b/docs/desktop/wm/i3.md index 0d07a24..8fd5b04 100644 --- a/docs/desktop/wm/i3.md +++ b/docs/desktop/wm/i3.md @@ -35,7 +35,7 @@ i3是一个平铺窗口管理器,采用BSD许可证发布,采用X11显示协 ## 配置 -**配置文件默认在/etc/i3,可复制/etc/i3/config到~/.i3/或~/.config/i3/** +**配置文件默认为`/etc/i3/config`,可复制到`~/.i3/`或`~/.config/i3/`** 因为 i3 官方文档写得较好,所以建议您阅读[官方文档](https://i3wm.org/docs/)。 diff --git a/docs/desktop/wm/sway.md b/docs/desktop/wm/sway.md index db8b589..da96a1b 100644 --- a/docs/desktop/wm/sway.md +++ b/docs/desktop/wm/sway.md @@ -10,7 +10,7 @@ [官方文档](https://github.com/swaywm/sway/wiki) -**注意:如果您使用NVIDIA的闭源驱动,您无法使用Sway,Sway也不会添加关于NVIDIA的支持** +**注意:Sway 官方不为 NVIDIA 闭源驱动提供支持,使用时需要以 `--unsupported-gpu` 启动** ## 概述 diff --git a/docs/distros/debian/debian.md b/docs/distros/debian/debian.md index 45364b7..5cf026c 100644 --- a/docs/distros/debian/debian.md +++ b/docs/distros/debian/debian.md @@ -20,7 +20,7 @@ Debian是一个由全球志愿者社区维护的自由开源操作系统。它 - 官方(较慢):https://cdimage.debian.org/debian-cd/ - 包管理器:[apt](../../applications/apps.md#apt-debian系)、dpkg(底层) - 更新方式:固定版本(Stable)/ 滚动(Testing、Sid) - - 自动换源:是(镜像列表以 302 跳转自动选源) + - 自动换源:是 - 图形安装界面:是 - 换源教程: - TUNA: diff --git a/docs/distros/gentoo.md b/docs/distros/gentoo.md index b73b057..2cb47ba 100644 --- a/docs/distros/gentoo.md +++ b/docs/distros/gentoo.md @@ -22,7 +22,7 @@ Gentoo Linux 是一个高度可定制的、基于源码的操作系统。Gentoo - 官网:https://www.gentoo.org/ - 支持的系统架构:x86_64(amd64)/ia64/x86(i486,i686)/arm64/arm32(arm)/ppc64/ppc32(ppc)/risc-v/mips/alpha/hppa/sparc/s390/m68k ... - 自由软件:是(可选择许可证类型) -- 初始化进程 (init): +- 初始化进程(init): - ``OpenRC`` ( ``sysvinit`` / ``openrc-init`` ) - ``systemd`` ???+ note "有关初始化进程(init)的选择" diff --git a/docs/distros/nixos.md b/docs/distros/nixos.md index 3058039..bbdbece 100644 --- a/docs/distros/nixos.md +++ b/docs/distros/nixos.md @@ -4,7 +4,7 @@ ## 简介 -NixOS是在Nix基础上,把系统配置进一步原子化、可复现的极客发行版。它通过编辑配置文件来修改系统设置(声明式),具有不可变性,并且能够规避依赖冲突等问题。 +NixOS 是在 Nix 基础上构建的极客发行版:它通过编辑配置文件声明式地定义整个系统,因此可以原子回滚、结果可复现,并且能规避依赖冲突等问题。 ## 详细信息 diff --git a/docs/distros/rhel/almalinux.md b/docs/distros/rhel/almalinux.md index 2367be8..698ffe7 100644 --- a/docs/distros/rhel/almalinux.md +++ b/docs/distros/rhel/almalinux.md @@ -4,7 +4,7 @@ ## 简介 -AlmaLinux与Rocky Linux一样,是RHEL的开源衍生版本。作为 RHEL 的社区衍生版本,AlmaLinux 主打极端的稳定性、可预测的长期支持(通常长达 10 年)和企业级安全。由于软件包版本相对保守,且默认缺少商业多媒体解码器、日常桌面软件,导致桌面开箱即用体验对新手而言折腾成本较高,但在服务器、科学计算和高稳定性工作站方面仍是首选。 +AlmaLinux与Rocky Linux一样,是RHEL的开源衍生版本。它主打极端的稳定性、可预测的长期支持(通常长达 10 年)和企业级安全。由于软件包版本相对保守,且默认缺少商业多媒体解码器、日常桌面软件,导致桌面开箱即用体验对新手而言折腾成本较高,但在服务器、科学计算和高稳定性工作站方面仍是首选。 ## 详细信息 @@ -19,7 +19,7 @@ AlmaLinux与Rocky Linux一样,是RHEL的开源衍生版本。作为 RHEL 的 - MirrorZ: https://mirrors.cernet.edu.cn/almalinux/ - 包管理器:[dnf](../../applications/apps.md#dnf-红帽系) - 更新方式:传统 - - 自动换源:是(镜像列表以 302 跳转自动选源) + - 自动换源:302 - 图形安装界面:是 - 换源教程: - TUNA: 无 diff --git a/docs/distros/rhel/fedora.md b/docs/distros/rhel/fedora.md index a354f02..9887e27 100644 --- a/docs/distros/rhel/fedora.md +++ b/docs/distros/rhel/fedora.md @@ -40,7 +40,7 @@ Fedora是一款前沿、开放的发行版,有着广泛的社区支持,并 - MirrorZ: https://mirrors.cernet.edu.cn/fedora/releases/ - 包管理器:[dnf](../../applications/apps.md#dnf-红帽系) - 更新方式:传统/OSTree - - 自动换源:是(镜像列表以 302 跳转自动选源) + - 自动换源:302 - 图形安装界面:是 - 换源教程: - TUNA: https://mirrors.tuna.tsinghua.edu.cn/help/fedora/ diff --git a/docs/distros/rhel/rocky.md b/docs/distros/rhel/rocky.md index f5c6a54..21ff4c6 100644 --- a/docs/distros/rhel/rocky.md +++ b/docs/distros/rhel/rocky.md @@ -19,7 +19,7 @@ Rocky Linux是RHEL的下游版本。在RedHat宣布停止公开RHEL源代码后 - MirrorZ: https://mirrors.cernet.edu.cn/rocky/ - 包管理器:[dnf](../../applications/apps.md#dnf-红帽系) - 更新方式:传统 - - 自动换源:是(镜像列表以 302 跳转自动选源) + - 自动换源:302 - 图形安装界面:是 - 换源教程: - TUNA: 无 diff --git a/docs/getting-started/common-command.md b/docs/getting-started/common-command.md index 7304c60..6fb1d40 100644 --- a/docs/getting-started/common-command.md +++ b/docs/getting-started/common-command.md @@ -7,7 +7,7 @@ - `$`: 在命令行中表示非root用户的提示符,其后闪动的光标代表等待用户输入。在[Shell](../applications/shell/shell.md)脚本中代表变量名的开始。 - `#`: 在命令行中表示root用户的提示符。在脚本中表示注释,井号后的内容会被自动忽略。 - `~`: 用以代表当前用户目录,如 `~/file`。 -- `*`: 通配符,可代指“全部”,如 `dir1/*` 指 `dir1` 下全部文件、文件夹,`dir1/file*.txt`指 `dir1` 文件夹下所有以 `file` 开头、`.txt` 结尾的文件与文件夹。在zsh下,使用通配符可能需要输入`\*`。 +- `*`: 通配符,可代指“全部”,如 `dir1/*` 指 `dir1` 下全部文件、文件夹,`dir1/file*.txt`指 `dir1` 文件夹下所有以 `file` 开头、`.txt` 结尾的文件与文件夹。在 zsh 下,通配符无匹配时会直接报错:想让它安静地展开为空,可 `setopt NULL_GLOB`;想保持原样传给命令,可给通配符加引号。 ## 常见指令 diff --git a/docs/getting-started/devices/drivers.md b/docs/getting-started/devices/drivers.md index 12687b9..db4d777 100644 --- a/docs/getting-started/devices/drivers.md +++ b/docs/getting-started/devices/drivers.md @@ -36,9 +36,9 @@ AMD不同架构的显卡需要不同驱动,绝大多数情况下使用开源 | RDNA3/RDNA3+ | RX7000系列、Radeon8000系列 | amdgpu | 直接使用系统内置驱动,配合mesa提供最佳游戏/图形性能 | | RDNA2|RX6000系列 | amdgpu | 原生完美支持 | | RDNA/RDNA1 | RX5000系列 | amdgpu | 原生完美支持 | -| GCN5/5.1(Vega) | RXVega56/64,RadeonVII | amdgpu | 需确保内核版本较新以获得最佳支持 | -| GCN1~4 | RX400/500系列,R9Fury|amdgpu | 属于较老架构,默认可能使用老旧的radeon驱动,建议在内核参数中强制启用amdgpu | - |早于GCN1架构 | HD7000系列及更早(如HD5000/6000)| radeon | 已停止维护,仅能使用开源的 radeon 驱动 | +| GCN5/5.1(Vega) | RXVega56/64、RadeonVII | amdgpu | 需确保内核版本较新以获得最佳支持 | +| GCN1~4 | RX400/500系列、R9Fury|amdgpu | 属于较老架构,默认可能使用老旧的radeon驱动,建议在内核参数中强制启用amdgpu | +| 早于GCN1架构 | HD6000 及更早(如 HD5000/6000)| radeon | 已停止维护,仅能使用开源的 radeon 驱动 | ### NVIDIA @@ -50,7 +50,7 @@ AMD不同架构的显卡需要不同驱动,绝大多数情况下使用开源

——Linus Torvalds

-自 2023 年以来,NVIDIA 对 Linux 的驱动支持日渐完善,如今除极个别方面仍有不足外,几乎已经追平 Windows。目前NVIDIA在最新驱动开源部分非关键的内核空间部分,即nvidia-open。但其用户空间工具(如CUDA、DLSS等)依然闭源,即nvidia-utils。 +自 2023 年以来,NVIDIA 对 Linux 的驱动支持日渐完善,如今除极个别方面仍有不足外,几乎已经追平 Windows。目前 NVIDIA 已将内核空间模块开源(Turing 及更新架构),即 nvidia-open。但其用户空间工具(如CUDA、DLSS等)依然闭源,即nvidia-utils。 同样,NVIDIA不同架构的显卡也需要不同的驱动,但是NVIDIA相对AMD更为复杂 @@ -64,14 +64,14 @@ AMD不同架构的显卡需要不同驱动,绝大多数情况下使用开源 NVIDIA显卡在专业用途下可能需要`akmod-nvidia`与`xorg-x11-drv-nvidia-cuda`库。 !!! warning "警告" - 由于NVIDIA坚持使用 EGLStreams,而 KDE KWin、GNOME Mutter 及各类基于 wlroots 的混成器均围绕公版方案 GBM 构建,这导致大量基于 wlroots 的小型项目无法兼容 NVIDIA 显卡——NVIDIA 的 Wayland 实现并非社区推荐的公版方案,许多本应正常的 Wayland 功能在 NVIDIA 显卡下会出现严重问题。 + NVIDIA 长期沿用自家的 EGLStreams,而非社区通用的 GBM,早期驱动下 KDE KWin、GNOME Mutter 及各类基于 wlroots 的混成器对 NVIDIA 支持并不完整。自 495 版驱动起已支持 GBM,555 版起支持显式同步,目前的问题主要集中在旧卡与旧驱动、Xwayland 以及个别合成器的兼容性上。 ***已知存在的问题*** - Hyprland Wayland合成器的显示器缩放问题 - - wlroots未支持NVIDIA + - 旧版驱动下 wlroots 系合成器的兼容性 - Waydroid无法使用NVIDIA - - ...以及各种因为EGLStreams而受影响的软件 + - ...以及各类依赖显式同步(explicit sync)的功能 ## 网卡驱动 @@ -89,9 +89,9 @@ Broadcom(博通)无线网卡在Linux系统下的支持情况因芯片型号 ???+ info "目前的支持情况" - 原生支持芯片(brcmsmac/brcmfmac):大多数较新的Broadcom无线网卡由内核中的开源驱动直接支持,这类网卡通常即插即用。 - - 需要专有驱动的芯片(broadcom-sta/wl):例如BCM4311, BCM4312, BCM4313, BCM43142, BCM4360等。这类设备在主流发行版(如 Ubuntu, Debian, Arch Linux 等)中需要安装broadcom-wl或 bcmwl-kernel-source驱动包。 + - 需要专有驱动的芯片(broadcom-sta/wl):例如 BCM4311、BCM4312、BCM4313、BCM43142、BCM4360 等。这类设备在主流发行版(如 Ubuntu、Debian、Arch Linux 等)中需要安装broadcom-wl或 bcmwl-kernel-source驱动包。 - 极其老旧或部分极新芯片:可能只有 Windows 驱动,Linux 下无法使用无线功能 ### Qualcomm Atheros -Qualcomm Atheros在Linux下的驱动支持是最完美的(没有之一),大多已内置于内核中。Qualcomm Atheros的驱动属于开源项目,完全整合在主流Linux内核中,如ath9k(支持早期的 802.11n 网卡,如AR9287, AR9565等。稳定性极佳,免驱、无需额外固件)、ath10k(支持802.11ac网卡,如QCA9377, QCA6174, QCA9880等,依赖linux-firmware固件,开箱即用)、ath11k/ath12k(支持较新的Wi-Fi 6(802.11ax)与Wi-Fi 7设备。随着新内核发布,断流等性能问题在不断修复)。 \ No newline at end of file +Qualcomm Atheros在Linux下的驱动支持是最完美的(没有之一),大多已内置于内核中。Qualcomm Atheros的驱动属于开源项目,完全整合在主流Linux内核中,如ath9k(支持早期的 802.11n 网卡,如AR9287, AR9565等。稳定性极佳,免驱、无需额外固件)、ath10k(支持802.11ac网卡,如QCA9377, QCA6174, QCA9880等,依赖linux-firmware固件,开箱即用)、ath11k/ath12k(支持较新的Wi-Fi 6(802.11ax)与Wi-Fi 7设备。随着新内核发布,断流等性能问题在不断修复)。 diff --git a/docs/getting-started/devices/others.md b/docs/getting-started/devices/others.md index dad26ef..d073787 100644 --- a/docs/getting-started/devices/others.md +++ b/docs/getting-started/devices/others.md @@ -20,7 +20,7 @@ 在Linux下,蓝牙耳机的音频输出会被分为音频模式与通话模式。在耳机麦克风开启的情况下,系统会自动切换到通话模式,此时耳机的声音会变得浑浊发闷,这是正常现象。若要切换耳机输出模式,您可以进入对应桌面环境设置中的音频页面来切换输出设备。一般来说,“模拟耳机”代表音频模式,而“免提”则为通话模式。 -蓝牙音频的音质取决于所使用的编解码器。PipeWire原生支持SBC、AAC、LDAC 等多种编解码器(其中 AAC、LDAC 等属高清编码),并允许用户通过修改配置文件来调整编解码器的优先级。通过创建或编辑WirePlumber(包名`wireplumber`,PipeWire 的会话管理器)的蓝牙配置文件,可以强制启用高清编码并优化连接体验。 +蓝牙音频的音质取决于所使用的编解码器。PipeWire原生支持SBC、AAC、LDAC 等多种编解码器(其中 LDAC、LHDC 等属高清编码),并允许用户通过修改配置文件来调整编解码器的优先级。通过创建或编辑WirePlumber(包名`wireplumber`,PipeWire 的会话管理器)的蓝牙配置文件,可以强制启用高清编码并优化连接体验。 ```bash mkdir -p ~/.config/wireplumber/bluetooth.lua.d/ diff --git a/docs/getting-started/input-method.md b/docs/getting-started/input-method.md index fd59d07..cae21e7 100644 --- a/docs/getting-started/input-method.md +++ b/docs/getting-started/input-method.md @@ -4,7 +4,7 @@ Linux下的输入法框架主要有以下两种选择: - - Fcitx(包名`fcitx5`,[Flathub (推荐)](https://flathub.org/zh-Hans/apps/org.fcitx.Fcitx5)):轻量,启动快,建议KDE、Sway、Hyprland等用户使用 + - Fcitx(包名`fcitx5`,[Flathub(推荐)](https://flathub.org/zh-Hans/apps/org.fcitx.Fcitx5)):轻量,启动快,建议KDE、Sway、Hyprland等用户使用 - IBus(包名`ibus`):自定义功能有限,但与GNOME深度集成,建议GNOME用户使用 您可以通过您的包管理器安装这两种输入法框架之一。 diff --git a/docs/getting-started/install.md b/docs/getting-started/install.md index 58bc3e9..623cef3 100644 --- a/docs/getting-started/install.md +++ b/docs/getting-started/install.md @@ -1,6 +1,6 @@ # 安装系统 -在烧录好U盘后,请您关机后在要安装的设备上插入U盘,按照前文“开启安全启动”一节进入 BIOS,调整启动顺序(Boot Order),将您的U盘对应引导项调至最上方,保存BIOS并重启。 +在烧录好U盘后,请您关机后在要安装的设备上插入U盘,参照前文“安全启动”一节进入 BIOS(若已开启安全启动,请先关闭),调整启动顺序(Boot Order),将您的U盘对应引导项调至最上方,保存BIOS并重启。 部分BIOS为全英文界面,并且操作方法因机器而异。在此我们依然建议您使用AI辅助操作或搜寻相关资料。 ???+ note "BIOS本地化" diff --git a/docs/getting-started/network.md b/docs/getting-started/network.md index 7b102aa..f27d5b2 100644 --- a/docs/getting-started/network.md +++ b/docs/getting-started/network.md @@ -15,7 +15,7 @@ - https://1ms.run/ - https://xuanyuan.cloud/free -- [南京大学镜像站 (GHCR、GCR等)](https://doc.nju.edu.cn/books/e1654/page/ghcr) +- [南京大学镜像站(GHCR、GCR 等)](https://doc.nju.edu.cn/books/e1654/page/ghcr) ## Steam加速 diff --git a/docs/getting-started/post-installation.md b/docs/getting-started/post-installation.md index 953c0a6..8a37be6 100644 --- a/docs/getting-started/post-installation.md +++ b/docs/getting-started/post-installation.md @@ -16,7 +16,7 @@ 国内主要的开源软件镜像站有以下这些: - [TUNA(清华源)](https://mirrors.tuna.tsinghua.edu.cn/):由清华大学TUNA协会维护,是国内最主流的软件镜像源,以极高的下载速度著称。 - - [USTC(中科大源)](https://mirrors.ustc.edu.cn/) : 由中国科学技术大学(USTC)及其 LUG 服务器维护小组维护,镜像收录十分广泛,收录了 Rocky 等在 TUNA 上没有的镜像。 + - [USTC(中科大源)](https://mirrors.ustc.edu.cn/):由中国科学技术大学(USTC)及其 LUG 服务器维护小组维护,镜像收录十分广泛,收录了 Rocky 等在 TUNA 上没有的镜像。 - [MirrorZ(校园网联合镜像站)](https://mirrors.cernet.edu.cn/):由中国教育和科研计算机网网络中心(CERNET)提供服务,收录了各大高校所创立的开源镜像站,能够自动重定向至地理位置最近的镜像站。 简单来说,TUNA快,USTC广,MirrorZ兜底。您可以任意选择三者中的一个。 @@ -89,7 +89,7 @@ 这是由于Windows采用的时间制是本地时间,也就是BIOS设置中的时间,而Linux默认使用UTC时间(格林尼治标准时间),由于中国属于GMT+8时区,每次切换系统都会导致8个小时的差异。 -要解决这个问题也很简单,请在Windows下以管理员权限启动PowerShell,并执行:`reg add "HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation" /v`。 +要解决这个问题也很简单,请在Windows下以管理员权限启动PowerShell,并执行:`reg add "HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation" /v RealTimeIsUniversal /t REG_DWORD /d 1 /f`。 !!! warning "已知问题" 您也可以在Linux终端中输入:`timedatectl set-local-rtc 1`来解决。 diff --git a/docs/getting-started/purpose.md b/docs/getting-started/purpose.md index b573e67..e883d38 100644 --- a/docs/getting-started/purpose.md +++ b/docs/getting-started/purpose.md @@ -9,7 +9,7 @@ 如果你在实践的过程中发现了不太了解的名词,可以看一看我们编写的“概念”部分来补课。 !!! warning "警告" - 我们不推荐新手跳过前置知识直接安装,**否则可能导致您所使用设备的操作系统产生不稳定性或发生严重损坏!造成的损失不由LinuxCabin组织以及文档贡献者承担!** + 我们不推荐新手跳过前置知识直接安装,**否则可能导致您所使用设备的操作系统产生不稳定性或发生严重损坏。由此造成的损失不由LinuxCabin组织以及文档贡献者承担!** ## 我为什么要使用Linux? @@ -22,7 +22,7 @@ 不过,下面有一些需要您在这之前检查的事情: -1. 我日常所需的软件是否有Linux版本/替代品/兼容选项? +1. 我日常所需的软件是否有Linux版本/替代品/兼容选项? 您可以查阅如下数据库: - [Wine官网数据库(英文)](https://appdb.winehq.org/) - [Can We Tux?](https://tux.red/) @@ -30,9 +30,9 @@ - [Can I Play on Linux?(英文)](https://caniplayonlinux.com/) - [ProtonDB(英文)](https://www.protondb.com/) -2. 我能否忍受可能会带来的不便与学习成本? +2. 我能否忍受可能会带来的不便与学习成本? 这包括可能会和终端打一部分交道,以及可能存在的不稳定性风险。 -3. 我能否完全脱离Windows? +3. 我能否完全脱离Windows? 如果不能,您需要参考“虚拟机”、[Wine](../compatibility/windows/wine/wine.md)等章节。 检查完毕!打开下一章,开始我们的旅途吧! @@ -50,7 +50,7 @@ 欢迎来到自由世界!Linux自创立之初就是自由软件(准确来说是创立之后不久),并且极大地推动了世界自由软件的发展,是兼顾“支持”与“自由”的选择。 ??? question "什么是自由软件?" - 从概念上说,“自由软件”指的是赋予用户自由的软件。自由软件通过开放源代码,允许用户自由地研究、修改和再分发软件及其源代码,从而保证了用户的自由。 + 从概念上说,“自由软件”指的是赋予用户自由的软件。自由软件通过开放源代码,允许用户自由地研究、修改和再分发软件及其源代码,从而保证了用户的自由。 有两种“自由软件”的理念,一种是 [GNU 自由软件理念](https://www.gnu.org/philosophy/free-sw.zh-cn.html),另外一种是 [BSD 开源软件理念](https://opensource.org/license/bsd-2-clause)。 #### 理念 @@ -67,13 +67,13 @@ > 3:用户可以自由地分发该软件修改后的拷贝,将改进后的软件分享给整个社区令他人也从中受益。 (BSD) - > 0:无论用户出于何种目的,必须可以按照用户意愿,完全自由地运行该软件,且没有任何使用场景的限制。 + > 0:无论用户出于何种目的,必须可以按照用户意愿,完全自由地运行该软件,且没有任何使用场景的限制。 - > 1:用户可以自由地学习并修改该软件,必须可以公开访问到该软件的源代码,且原作者不对修改行为作任何审计或干涉。 + > 1:用户可以自由地学习并修改该软件,必须可以公开访问到该软件的源代码,且原作者不对修改行为作任何审计或干涉。 > 2:用户可以自由地分发该软件的原始拷贝或修改后的拷贝,用户可以自由选择以何种许可证分发,只需保留原作者的版权声明即可。 - > 3:用户可以自由地分发该软件修改后的版本,且不承担任何向社区回馈代码的义务。 + > 3:用户可以自由地分发该软件修改后的版本,且不承担任何向社区回馈代码的义务。 #### GNU 和 BSD 的不同 @@ -120,4 +120,3 @@ Flag 如果是这样,我们并不会推荐您使用Linux。众所周知,目前Linux社区“恃才傲物”的问题有很大一部分都是“嘉豪”一类人所造成的。所以,如果您只是单纯想要炫耀自己的技术力,我们不推荐通过Linux而达成这个目的,并且秩序与风气良好的社区是极力反对这种现象的。 当然,如果您依然想要继续,那么则希望您能与其他用户平等交流,少一些炫耀,多一些真才实干,为社区创造一个相对好的氛围。 - -- cgit v1.3