From 47338a57a41708ddc23a5ffa8c710c78b0401494 Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 23 Aug 2026 09:50:43 -0400 Subject: guide on installing debian --- mkdocs.yml | 2 ++ 1 file changed, 2 insertions(+) (limited to 'mkdocs.yml') diff --git a/mkdocs.yml b/mkdocs.yml index 34f55f8..19b671f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -104,6 +104,8 @@ nav: - getting-started/os-basis.md - getting-started/before-installing.md - getting-started/install.md + - 详细安装过程: + - getting-started/installation-by-distro/debian.md - getting-started/post-installation.md - 设备支持: - getting-started/devices/drivers.md -- cgit v1.3 From 809ad1f614b3a6321b1c6eaa2cc1cf9ec2d195df Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Sun, 23 Aug 2026 23:36:03 +0800 Subject: docs: fedora installation --- .../installation-by-distro/debian.md | 8 +-- .../installation-by-distro/fedora.md | 79 +++++++++++++++++++++ .../fedora_installation_full/create_partition.png | Bin 0 -> 115654 bytes docs/img/fedora_installation_full/grub.png | Bin 0 -> 10063 bytes docs/img/fedora_installation_full/install.png | Bin 0 -> 737414 bytes docs/img/fedora_installation_full/lang.png | Bin 0 -> 59123 bytes docs/img/fedora_installation_full/mount.png | Bin 0 -> 105684 bytes docs/img/fedora_installation_full/partition.png | Bin 0 -> 120087 bytes .../fedora_installation_full/partition_manager.png | Bin 0 -> 66269 bytes mkdocs.yml | 1 + 10 files changed, 84 insertions(+), 4 deletions(-) create mode 100644 docs/getting-started/installation-by-distro/fedora.md create mode 100644 docs/img/fedora_installation_full/create_partition.png create mode 100644 docs/img/fedora_installation_full/grub.png create mode 100644 docs/img/fedora_installation_full/install.png create mode 100644 docs/img/fedora_installation_full/lang.png create mode 100644 docs/img/fedora_installation_full/mount.png create mode 100644 docs/img/fedora_installation_full/partition.png create mode 100644 docs/img/fedora_installation_full/partition_manager.png (limited to 'mkdocs.yml') diff --git a/docs/getting-started/installation-by-distro/debian.md b/docs/getting-started/installation-by-distro/debian.md index 529380e..0cd56ec 100644 --- a/docs/getting-started/installation-by-distro/debian.md +++ b/docs/getting-started/installation-by-distro/debian.md @@ -11,12 +11,12 @@ ## 准备 -在开始前,您需要下载 Debian 13 的安装 ISO。上一节中的**“[下载镜像](../../before-installing/#_5)”**中有所叙述。 +在开始前,您需要下载 Debian 13 的安装 ISO。上一节中的**“[下载镜像](../before-installing.md#_5)”**中有所叙述。 -???+ tips "Debian 的安装镜像下载地址..." - [Debian 的详细信息](../../../distros/debian/debian/#_2)中有记录。前往***“镜像下载地址”*项**下面的网页,点击 `current/`,再点击电脑的架构(一般是`amd64/`),再点击 `iso-cd/`,选择 `debian-`...`-netinst. +???+ tip "Debian 的安装镜像下载地址..." + [Debian 的详细信息](../../distros/debian/debian.md#_2)中有记录。前往***“镜像下载地址”*项**下面的网页,点击 `current/`,再点击电脑的架构(一般是`amd64/`),再点击 `iso-cd/`,选择 `debian-`...`-netinst. -下载镜像后,您需要将镜像烧录到U盘(或移动硬盘)中。可以参考上一节中的**“[烧录镜像](../../before-installing/#_6)”**。 +下载镜像后,您需要将镜像烧录到U盘(或移动硬盘)中。可以参考上一节中的**“[烧录镜像](../before-installing.md#_6)”**。 烧录完成后,您需要从烧录完的有安装镜像的U盘(或移动硬盘)中启动。 diff --git a/docs/getting-started/installation-by-distro/fedora.md b/docs/getting-started/installation-by-distro/fedora.md new file mode 100644 index 0000000..dbebef2 --- /dev/null +++ b/docs/getting-started/installation-by-distro/fedora.md @@ -0,0 +1,79 @@ +# Fedora + +Fedora是一款前沿、开放的发行版,有着广泛的社区支持,并且提供多种变体可供选择。 + +以下我们以Fedora Workstation/KDE为例示范如何安装Fedora。 + +## GRUB + +在使用U盘启动之后,您会进入GRUB页面。这时,会提供三个选项可选。 + +- Start Fedora-Workstation-Live: 直接启动LiveISO环境,适合赶时间的用户 +- Test this media & start Fedora-Workstation-Live: 验证并启动LiveISO环境,会校验当前的镜像是否出现损坏,推荐 +- Troubleshooting --> + - Start Fedora-Workstation-Live in basic graphics mode: 用于解决显卡驱动兼容性问题,若前面选项出现黑屏卡死请选这个 + +![grub](../../img/fedora_installation_full/grub.png) + +## 安装器 + +开机之后,会出现弹窗,询问是否要安装Fedora,此处请选择“Install Fedora Linux...”。 + +???+ tip "提示" + 如果您的部分准备工作(如分区)等没有完毕,您可以选择另外一个选项返回桌面,并通过LiveISO的自带应用操作系统。您可以随时按Win键或者将鼠标置于屏幕左上角来打开Dock栏,选择Install to Hard Drive来重新打开安装器。 + +![installer](../../img/fedora_installation_full/install.png) + +## 语言与键盘布局 + +您可以在输入框中输入Chinese来查找并选择简体中文。键盘布局可以默认为US或者改为“Chinese (China)”。 + +![language&keyboard](../../img/fedora_installation_full/lang.png) + + + +## 分区设置 + +在这之后,您会进入分区设置。 + +![partition](../../img/fedora_installation_full/partition.png) + +如果您想要摒弃其他操作系统,只留下Fedora,请选择“使用整个磁盘”。如果您想要与其他系统共存,请选择“挂载点配置”。 + +???+ question "为什么不建议选择“与其他系统共享磁盘”?" + 该选项会无视系统上已有的EFI分区,而是另行创建新的EFI分区,尽管该做法可能规避Windows Update的引导覆盖,但这有可能导致兼容性问题。 + + 此外,该选项默认将根目录挂载的分区初始化为Btrfs文件系统。如果您不知道这是什么,我们极不建议您选择该选项! + +### 手动分区 + +如果您选择了“挂载点配置”,您需要手动创建系统分区。 + +此时,您可以按下Win键呼出操作系统的菜单,搜索并打开桌面自带的分区管理器(一般包含Partition字样)。 + +![partition manager](../../img/fedora_installation_full/partition_manager.png) + +请选中您事先腾出的空白区域,并点击New,在弹出菜单中选择您要初始化的文件系统(建议选择Ext4,请勿选择NTFS!)。点击OK,点击应用上栏中的Apply来应用更改。 + +如果您的EFI空间不足,或是想要单独分区/boot,请在弹出窗口上方的可视化部分拖动分区两侧来留出空间,为创建/boot分区留出空间。在这之后,重复上述的创建操作来创建/boot分区即可。 + +各个桌面环境的分区管理器存在差异,如果您不明白怎么操作,我们建议您寻求他人或AI的帮助。 + +![create partition](../../img/fedora_installation_full/create_partition.png) + +在这之后,返回安装器,为创建好的分区分配挂载点。如果您刚刚没有为`/boot`单独分区,您可以点击右侧的小垃圾桶来删除这个选项。根分区选择刚刚创建的大分区,`/boot/efi`请选择您计算机已有的EFI分区(通常位于列表第一个,大小不大的FAT32分区)。 + +!!! warning "警告" + 如果您的计算机上已经存在了操作系统,请一定不要勾选`/boot/efi`的“重新格式化”!!! + +![mount](../../img/fedora_installation_full/mount.png) + +在这之后,点击下一步。 + +???+ tip "磁盘加密" + 如果您开启了磁盘加密,您会需要在每次开机时输入密码来解锁分区。 + +## 大功告成 + +最后,您可以检查您的分区方案,确认无误后,继续安装即可! diff --git a/docs/img/fedora_installation_full/create_partition.png b/docs/img/fedora_installation_full/create_partition.png new file mode 100644 index 0000000..ec9d66d Binary files /dev/null and b/docs/img/fedora_installation_full/create_partition.png differ diff --git a/docs/img/fedora_installation_full/grub.png b/docs/img/fedora_installation_full/grub.png new file mode 100644 index 0000000..e11350e Binary files /dev/null and b/docs/img/fedora_installation_full/grub.png differ diff --git a/docs/img/fedora_installation_full/install.png b/docs/img/fedora_installation_full/install.png new file mode 100644 index 0000000..edff1c6 Binary files /dev/null and b/docs/img/fedora_installation_full/install.png differ diff --git a/docs/img/fedora_installation_full/lang.png b/docs/img/fedora_installation_full/lang.png new file mode 100644 index 0000000..cce2265 Binary files /dev/null and b/docs/img/fedora_installation_full/lang.png differ diff --git a/docs/img/fedora_installation_full/mount.png b/docs/img/fedora_installation_full/mount.png new file mode 100644 index 0000000..b588bdd Binary files /dev/null and b/docs/img/fedora_installation_full/mount.png differ diff --git a/docs/img/fedora_installation_full/partition.png b/docs/img/fedora_installation_full/partition.png new file mode 100644 index 0000000..d90f4ca Binary files /dev/null and b/docs/img/fedora_installation_full/partition.png differ diff --git a/docs/img/fedora_installation_full/partition_manager.png b/docs/img/fedora_installation_full/partition_manager.png new file mode 100644 index 0000000..5aca5c7 Binary files /dev/null and b/docs/img/fedora_installation_full/partition_manager.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 19b671f..3ad04c1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -106,6 +106,7 @@ nav: - getting-started/install.md - 详细安装过程: - getting-started/installation-by-distro/debian.md + - getting-started/installation-by-distro/fedora.md - getting-started/post-installation.md - 设备支持: - getting-started/devices/drivers.md -- cgit v1.3 From 56fd141a613e406b0701f00ff333828c0477c5f4 Mon Sep 17 00:00:00 2001 From: fanh211 Date: Mon, 24 Aug 2026 13:10:27 +0800 Subject: 添加兼容性/VM章节 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/compatibility/windows/kvm.md | 1 - docs/compatibility/windows/vm.md | 103 ++++++++++++++++++++++++++++++++++++++ mkdocs.yml | 1 + 3 files changed, 104 insertions(+), 1 deletion(-) delete mode 100644 docs/compatibility/windows/kvm.md create mode 100644 docs/compatibility/windows/vm.md (limited to 'mkdocs.yml') diff --git a/docs/compatibility/windows/kvm.md b/docs/compatibility/windows/kvm.md deleted file mode 100644 index b5b2b10..0000000 --- a/docs/compatibility/windows/kvm.md +++ /dev/null @@ -1 +0,0 @@ -# 虚拟机 \ No newline at end of file diff --git a/docs/compatibility/windows/vm.md b/docs/compatibility/windows/vm.md new file mode 100644 index 0000000..894832c --- /dev/null +++ b/docs/compatibility/windows/vm.md @@ -0,0 +1,103 @@ +# 虚拟机 + +## 概述 + +虚拟机(Virtual Machine)指一种特殊的软件,可以在计算机系统中建立一种环境,用户可以基于虚拟机这个软件所建立的特殊环境来运行其它软件。虚拟机通过系统的软件模拟功能具有完整硬件系统功能。 + +简单来说,就是运行在一个完全隔离环境中的完整计算机系统,能提供物理计算机的功能。 + +在Linux中,你可能要使用一些wine无法兼容的Windows独占软件,但当你无法放弃或者没有平替时,又该如何使用?此时,虚拟机便是最好的解决方案。 + +???+info "在Linux上主流的Windows虚拟机方案" + - VirtualBox:图形化最完善,最开箱即用,性能提升需要搭配KVM使用,但KVM支持不够完善 + - VMware:与VirtualBox类似 + - QEMU:最强大,完美支持KVM,支持直通,但需要使用大量CLI,virt-manager逻辑复杂,上手难度大 + - KVM:内核模块,一般不直接使用 + - WinBoat:用容器化完整安装Windows,但暂无图形加速,且项目处于早期阶段 + + 一般情况下,QEMU和VirtualBox是常见选择。 + +--- + +## QEMU方案 + +### 安装 + +Debian系: +```bash +sudo apt install qemu-system qemu-utils +``` + +红帽系: +```bash +sudo dnf install qemu +``` + +Arch系: +```bash +sudo pacman -S qemu-full #或 qemu-base,qemu-desktop +``` + +!!! warning "注意事项" + Debian系: `qemu-system` 包含系统级模拟, `qemu-utils` 包含 `qemu-img` 等磁盘管理工具。若需完整模拟器支持,可安装 `qemu-system-*` 。 + + 红帽系:也可通过安装 `@virtualization` 来一次性安装QEMU、KVM及管理工具。 + + Arch系: `qemu-full` 是功能最全的包, `qemu-base` 是不含GUI的精简版; `qemu-desktop` 默认只包含x86_64模拟。 + +### 使用(CLI) + +首先,在使用QEMU前,我们需要创建一个QEMU磁盘文件 + +```bash +# 此处示例为qcow2格式,64G大小 +qemu-img create -f qcow2 [磁盘文件路径]/windows_disk.qcow2 64G +``` + +然后使用以下参数从iso启动 + +```bash +qemu-system-x86_64 \ # 指定为x86_64的模拟 + -enable-kvm \ # 使用KVM以加速 + -cpu host \ # 将主机的 CPU 型号和特性直接传递给虚拟机,以获得最佳性能 + -smp 4 \ # 分配 4 个 CPU 核心给虚拟机 + -m 4096 \ # 分配4096MB(4GB)内存给虚拟机,可使用参数4G + -device usb-tablet \ # 解决鼠标坐标错位的关键。它模拟一个USB绘图板(或触控屏),使用绝对坐标定位,这样鼠标指针在宿主机和虚拟机内就能完全同步 + -drive file=[磁盘文件路径]/windows_disk.qcow2,if=virtio,format=qcow2 \ # 需指向创建的QEMU磁盘文件路径 + -cdrom [Window镜像路径]/windows.iso \ # 需指向Windows ISO安装文件 + -boot order=d \ # 设置从光驱启动 + -nic user,model=virtio-net-pci \ # 网络,此处使用virt-IO +``` + +安装完成后,可以删去 `-cdrom` 和 `-boot` 行。 + +### 关于更多 + +因本手册专业性限制,建议另寻专门性教程进行学习 + +- [QEMU官方文档(英文)](https://qemu.readthedocs.io/en/master/) + +--- + +## VirtualBox方案 + +### 安装 + +Debian系: +```bash +sudo apt install virtualbox +``` + +红帽系: +```bash + sudo dnf install virtualbox +``` + +Arch系: +```bash +sudo pacman -S virtualbox +``` + +### 使用 + +按照图形化指引进行即可。 diff --git a/mkdocs.yml b/mkdocs.yml index 18accab..ffa5f96 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -150,6 +150,7 @@ nav: - Win & Linux: - compatibility/windows/wine.md - compatibility/windows/steam.md + - compatibility/windows/vm.md - 跨发行版: - compatibility/inter-distros/distrobox.md - 应用与工具: -- cgit v1.3 From 55f9565dcf3f758d990156bd2bd58981911bdcc1 Mon Sep 17 00:00:00 2001 From: Fangcat_Dev Date: Wed, 26 Aug 2026 11:21:27 +0800 Subject: feat: auto color scheme --- mkdocs.yml | 35 +++++++++++++++++++++++------------ 1 file changed, 23 insertions(+), 12 deletions(-) (limited to 'mkdocs.yml') diff --git a/mkdocs.yml b/mkdocs.yml index ffa5f96..3d2c2c2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -16,18 +16,29 @@ theme: custom_dir: overrides language: zh palette: - - scheme: default - primary: teal - accent: green - toggle: - icon: material/brightness-7 - name: 夜间模式 - - scheme: slate - primary: black - accent: teal - toggle: - icon: material/brightness-4 - name: 日间模式 + - media: "(prefers-color-scheme)" + scheme: default + primary: blue + accent: light blue + toggle: + icon: material/brightness-auto + name: 切换亮色模式 + + - media: "(prefers-color-scheme: light)" + scheme: default + primary: blue + accent: light blue + toggle: + icon: material/brightness-7 + name: 切换暗色模式 + + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: blue + accent: light blue + toggle: + icon: material/brightness-4 + name: 切换跟随系统 icon: logo: material/book-open-page-variant repo: fontawesome/brands/github -- cgit v1.3