aboutsummaryrefslogtreecommitdiff
path: root/docs/getting-started
diff options
context:
space:
mode:
authorShinKouyo <me@0x0f.dev>2026-11-20 13:18:36 +0000
committerShinKouyo <me@0x0f.dev>2026-11-20 13:18:36 +0000
commitad9b4ec7d58187fd3daf0e816dd382fcbd294a17 (patch)
tree1f16a64313951b42f69d172a1fc041a24b3bb75d /docs/getting-started
parentdocs(fix): 修复失效的锚点链接 (diff)
docs(fix): 修正命令错误与过时描述
Assisted-by: DeepSeek-V4.1-Flash-1017 Signed-off-by: ShinKouyo <me@0x0f.dev>
Diffstat (limited to '')
-rw-r--r--docs/getting-started/common-command.md2
-rw-r--r--docs/getting-started/devices/drivers.md18
-rw-r--r--docs/getting-started/devices/others.md2
-rw-r--r--docs/getting-started/input-method.md2
-rw-r--r--docs/getting-started/install.md2
-rw-r--r--docs/getting-started/network.md2
-rw-r--r--docs/getting-started/post-installation.md4
-rw-r--r--docs/getting-started/purpose.md17
8 files changed, 24 insertions, 25 deletions
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不同架构的显卡需要不同驱动,绝大多数情况下使用开源çš
<p align="right">——Linus Torvalds</p>
-自 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而达成这个目的,并且秩序与风气良好的社区是极力反对这种现象的。
当然,如果您依然想要继续,那么则希望您能与其他用户平等交流,少一些炫耀,多一些真才实干,为社区创造一个相对好的氛围。
-