帮助:笔记本电脑页面指南

本文统一了所有笔记本电脑页面的样式和布局，并引入了指南和标准，以确保笔记本电脑页面保持高质量。这可以防止页面退化为仅包含 lspci 和 lsusb 的输出转储或用户关于其设备的个人笔记。

常规

请为页面添加一个适当的分类，例如 Category:Dell。如果您的供应商没有对应的分类，请创建一个。

页面名称应为“供应商 型号”，例如“Lenovo ThinkPad X1 Carbon”。

请不要创建仅省略供应商名称的重定向，例如“X1 Carbon”或“ThinkPad X1 Carbon”。

提示 如果您不知道页面应该是什么样子的，Dell Latitude 3500 和 Lenovo ThinkPad T14/T14s (Intel) Gen 2 是遵循这些指南的示例页面。

不要重复一般笔记本电脑指南中的内容。仅包含例如“该设备的网络摄像头工作正常”的章节对任何人都没有帮助，因此如果该部件没有特殊说明，请不要添加相关章节。此外，避免提及特定桌面环境或窗口管理器的内容。这也适用于 ArchWiki 中记录的其他事项，例如不要包含如何将 archiso 写入 USB 的说明，只需链接到包含说明的页面即可。这将减少维护需求。

在描述笔记本电脑受到的任何问题时，请务必详尽。请提供其他遇到相同问题的用户报告的链接以及其他适当的来源。

添加硬件信息

警告

• 保持所有行尽可能短，因为宽表格难以阅读且使页面看起来杂乱无章。
• 确保表格位于前言或介绍之上，否则表格的位置会发生变化。

在页面最开始处添加一个 class="wikitable archwiki-table-laptop" 的表格，包含以下列

1. 硬件
   • 它应该包含部件的短名称，例如“蓝牙”或“指纹读取器”。
   • 仅当存在多个相同部件时，才在部件名称后附加供应商名称。一个常见的例子是拥有多个 GPU（见下表）。
   • 考虑运行 hardware probe 以将全部硬件信息提交给 Linux 硬件数据库。
2. PCI/USB ID
   • 如果可用，它应该包含部件的 PCI 或 USB ID。这一点很重要，因为某些笔记本电脑的硬件配置可能有所不同。
   • lsusb 默认显示 USB ID，但 lspci 必须使用 -nn 才能获得设备的 PCI ID——默认情况下它显示 总线:设备.功能。
     • 如果有 PCI/USB ID 但没有名称，请考虑分别向 PCI ID 存储库 或 USB ID 存储库 贡献该部件信息。
   • 如果该设备没有适用的 PCI/USB ID，不要使用 Template:- 或破折号，只需将单元格留空即可。另一种可接受的方案是填入“PS/2”或“I2C”而不带 ID（例如 PS/2 设备无法像 PCI 或 USB 设备那样枚举，ACPI 只报告一个“设备名称”）。
3. 是否工作？
   • 它应该包含 Template:Yes 或 Template:No。如果不适用，请使用 Template:Y 并加上一个合适的、简短的状态描述，如“未经测试”或“部分支持”。
     • 当应用修改后部件仍无法正常工作时，使用“部分支持”。
   • 即使需要安装外部驱动程序，或者通过配置 设备特定 参数增强功能时，也请使用 Template:Yes。

注意 如果任何部件需要特殊说明，鼓励您为该部件添加专门的章节。遗憾的是，使用某些 标准章节 时会使页面变得杂乱，因此请避免使用 已知问题、提示和技巧 以及 故障排除。

内核模块信息

不要将内核模块信息放入表格或为部件单独设置章节。这通常毫无意义，因为该部件通常只有一个模块。如果可以选择不同的驱动程序，则不在此限，但必须在部件的章节中指定，而不是在表格中。

示例表格

以下代码将像右侧的示例一样显示

{| class="wikitable archwiki-table-laptop" ! Hardware !! PCI/USB ID !! Working? |- | Wi-Fi || {{ic|14e4:1aaa}} || {{Yes}} |- | Bluetooth || {{ic|8087:2bbb}} || {{Yes}} |- | Webcam || {{ic|046d:3ccc}} || {{No}} |- | GPU (Intel) || {{ic|8086:4ddd}} || {{Yes}} |- | GPU (NVIDIA) || {{ic|10de:5eee}} || {{No}} |- | Other part || {{ic|056a:6fff}} || {{Y|Untested}} |}

硬件 PCI/USB ID 是否工作？ Wi-Fi 14e4:1aaa 是 蓝牙 8087:2bbb 是 摄像头 046d:3ccc 否 GPU (Intel) 8086:4ddd 是 GPU (NVIDIA) 10de:5eee 否 其他部件 056a:6fff 未测试

常见部件列表

• Wi-Fi
• 蓝牙
• 摄像头
• 以太网
• GPU
• 触控板
• 键盘
• TPM
• 指纹识别器
• SD 卡读卡器
• 扬声器
• 麦克风
• 环境光传感器

注

• 如果任何端口（USB、HDMI、以太网）或关键硬件（如风扇控制）不能“开箱即用”，请为其添加一个章节并将其添加到表格中。确保不包含任何特定于桌面环境/窗口管理器的说明。这些章节应放在“固件”和“功能键”章节之间。
• 不要将“Fn 键”、“挂起/休眠”或“电源管理”放入表格中。

相关文章

由于所有笔记本电脑页面都应包含一个右侧浮动的硬件表格，因此 Help:Style#Related articles box 中描述的 Template:Related 的使用将被仅使用 “参见”章节 或相关章节内的直接链接所取代，以避免右浮动元素相互冲突。

“安装”章节

本章节应包含在此设备上安装 Arch Linux 所必需的信息。这包括但不限于：

• 内核参数
• 重要的固件设置（另请参阅 #"固件"章节）
  • 这不包括更改启动设备等显而易见的设置。
  • 鼓励链接到论坛中相关的帖子，例如这个专注于 Dell 设备问题的示例帖子。
• 如果设备安装需要特殊固件，例如用于网络连接的 AUR 包，请突出显示该要求。

如果没有需要处理的特殊情况，请省略此章节。

“辅助功能”章节

警告 在笔记本电脑页面中添加此章节是强制性的。它不是可选的，因为对于残障用户来说，这些信息至关重要，能帮助他们判断是否可以在没有帮助的情况下在该设备上安装 Arch Linux。

为了帮助残障用户在该设备上安装 Arch Linux，请添加一些辅助功能信息。这包括但不限于：

• 固件的外观。考虑启动官方 Arch Linux 安装介质所需的设置。
  • 较新的固件界面可能更难被盲人用户常用的手机 OCR 软件解析。如果有选项可以将默认设计恢复为“经典”设计，请添加说明。
  • 某些固件甚至需要使用鼠标和/或过于复杂。如果不具备视力就无法更改设置，请添加说明。例如：
    注意： 盲人用户应寻求视力正常者的帮助来更改固件设置。
  • 某些固件界面可能大量使用单选按钮和紧密排列的菜单，这可能会阻碍帕金森病患者更改某些设置。
• 参考您的设备官方手册（参见 #"参见"章节）中相关的章节，其中包含导航固件和触发某些操作（如更改启动设备）所需的所有快捷键列表。
  • 如果不存在此类手册，您可以改为在本节中添加列表。
• 某些设备可能带有诊断 LED，可以可视化显示蜂鸣码。这对于听障用户很有用。
  • 如果只有诊断 LED 而没有蜂鸣码，请添加注释。

提示 如果您不知道该章节应该是什么样子的，请参考以下良好示例：

• Framework Desktop#Accessibility
• System76 Oryx Pro#Accessibility

“固件”章节

页面应包含一个关于该设备 fwupd 支持情况的简短说明。

当存在用户应注意的特殊行为时，页面应包含固件章节。这包括但不限于以下内容：

• 可以增强该设备兼容性的特定可选固件设置
• 可能影响安装的固件特性（quirks）
• 缺少 UEFI。设备使用什么启动方法，是否可以将 UEFI 添加到现有的启动过程中？
• 安全启动 (Secure Boot) 信息
  • 自定义密钥在此设备上工作正常吗？
  • 是否有任何特殊的固件设置需要为此更改？
  • 是否有用户应该注意的其他特殊事项？
• 固件是否将恢复映像或日志存储在特殊路径中？在选择 EFI 系统分区 大小时，这一点很重要。
• 有时更新固件至关重要，因为它可以修复关键错误。如果存在任何重要的固件更新，请在此章节中提及。
• 缺少 ACPI 或 Linux 不支持该 ACPI。

“功能键”章节

注意 可能存在未标记的键绑定。在最坏的情况下，您可能会按下一个发送 XF86Sleep 的未标记键，导致设备挂起，这可能会让您因为屏幕突然变黑而感到惊慌；或者按下发送 XF86RFKill 的键。这两种可能性都会造成轻微干扰，但并不危险。

按住 Fn 并按下键盘上的每个键，同时按照 #捕获功能键 中的说明捕获结果。

添加一个包含以下列的表格：

注意 请记住遵循 键盘按键的样式指南。

1. 按键
   • 需要按下的键。它们通常以 Fn 开头。
2. 可见？
   • 根据 xev 等工具是否能看到此键，使用 Template:Yes 或 Template:No。
3. 有标记？
   • 根据物理按键上是否有描述其功能的符号，使用 Template:Yes 或 Template:No。
4. 效果
   • 通常，功能键会发出一个键码，或者按下按键时固件会执行某些操作。
   • 当按下键时，指定 X 键盘扩展符号，例如 XF86MonBrightnessDown。
   • 按键可能具有特殊效果，应予以提及，例如网络设备的硬阻断。
   • 不要添加特定于桌面环境或窗口管理器的说明。
   • 有些键默认会被 systemd-logind 绑定，这些键应该被标记——参见下面的 示例表格。

捕获功能键

可以使用 xev (xorg-xev) 或 wev (wev) 来捕获功能键。还有 libinput debug-events，但由于许多 Wayland 合成器使用 xkbcommon，首选 Xorg 特定的名称。

桌面环境 甚至一些 窗口管理器 可能带有默认配置，该配置会自行处理所有功能键并将其吞没。如果遇到这种情况，请临时使用像 Openbox 这样的最小化窗口管理器来捕获这些按键。

某些功能键（例如 XF86Sleep）可能绑定到了 systemd-logind，这意味着它们默认无法被任何工具捕获。请使用 systemd-inhibit 暂时挂起这些键的处理：

# systemd-inhibit --what=handle-suspend-key sleep 1h

只要此命令在运行，systemd-logind 就会忽略这些按键操作，从而可以正确捕获按键。

注意 如果按键仍然不可见，它可能是固件绑定的，或者是内核模块在处理它。

示例表格

按键	可见？1	有标记？2	效果
Fn+Esc	否	是	切换 Fn 锁定
Fn+F1	是	是	XF86AudioMute
Fn+F2	是	是	XF86AudioLowerVolume
Fn+F3	是3	是	XF86Sleep
...	否	否	合适的描述

1. 该键对 xev 及类似工具可见。
2. 物理按键上有描述其功能的符号。
3. systemd-logind 默认处理此项。

“参见”章节

本章节应包含有用的链接，包括但不限于以下内容：

• 相关的其他外部维基页面，例如 ThinkWiki。
• Ubuntu 认证目录中页面的链接，它可以作为 PCI/USB ID 和硬件变体的重要参考来源。
• 硬件探测结果的链接，在 Linux 硬件数据库上搜索相关型号，该数据库提供了关于兼容性和 PCI/USB ID 的信息。
• 制造商提供的官方手册页面，有助于调试固件问题。