From 460ac2fd40b91d9badeab034d9fbaf9b72106987 Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Sat, 11 Jul 2026 23:57:52 +0800 Subject: Update CONTRIBUTION.md, more content --- CONTRIBUTE.md | 68 +++++++++++++++++---- docs/concepts/linux/de.md | 19 ++++++ docs/concepts/linux/distro.md | 9 +++ docs/concepts/operating_system/file_systems.md | 11 ++-- docs/distros/arch/archlinux.md | 3 +- docs/distros/debian/ubuntu.md | 3 +- docs/distros/rhel/fedora.md | 9 ++- docs/getting-started/before-installing.md | 81 ++++++++++++++++---------- docs/getting-started/install.md | 3 +- docs/getting-started/purpose.md | 8 ++- mkdocs.yml | 8 +++ 11 files changed, 164 insertions(+), 58 deletions(-) create mode 100644 docs/concepts/linux/de.md create mode 100644 docs/concepts/linux/distro.md diff --git a/CONTRIBUTE.md b/CONTRIBUTE.md index 4cb2abc..50ef5c5 100644 --- a/CONTRIBUTE.md +++ b/CONTRIBUTE.md @@ -1,18 +1,66 @@ 贡献者,你好! -首先,我们感谢您对本项目做出的支持!不过,在贡献之前,还请您遵守以下规定: +感谢您对本项目做出的支持!以下是一些注意事项。 -## 总体 +## 在哪里贡献? -1. 所有内容**必须符合中华人民共和国法律**,不得出现涉政、色情、赌毒等内容 -2. 部分内容需按照templates下的**模板**进行填写,允许在下方追加内容 -3. 媒体资源建议引用**中国大陆用户能够正常访问**的资源 -4. 我们建议引用链接为**简体中文官方内容** +您可以通过提Issues,或者发起PR (Pull Request) 的方式来贡献。在贡献时,我们建议您将负责人设置为LinuxCabin的一位管理成员以更快处理您的请求。 -## 发行版 +下面是一个可供参考的模板: -1. 请不要将多个发行版合并到一篇文章中 -2. 衍生发行版不应被置于父发行版的“风味”部分,而应单开一页 -3. 请确保镜像源以及换源教程地址存在 +``` +我希望增加内容的标题: The Title +这个内容应被放置/追加在:Chapter-Another Chapter章节 + +章节内容: + +xxxxxx + +``` + + +若您的内容被退回,建议您仔细阅读退回原因。如果经过修改没有问题,我们允许您再次提交。 + +### 我们不建议您贡献的内容 + + - 与Linux无关的内容 + - 专业性过高的内容 + - 偏颇/太过不常见的内容(如果值得商讨您也可以贡献) + - 由AIGC生成的内容(经由人工审定除外) + +## PR贡献的工作流? + +请确保您的电脑已经安装了最新版的Python,并被添加到PATH中。 + +在clone仓库后,请您执行来安装必要的库: + +``` +pip install -r requirements.txt +``` + +我们的文章全部位于/docs目录下。如果您添加了之前不存在的章节,请您修改`mkdocs.yml`下的`nav`(照葫芦画瓢就行)来使得您的内容显示在侧边栏导航。 + +如果您要预览内容,我们建议您执行以下指令来查看网页显示效果: + +``` +mkdocs serve +``` + + +## 贡献时要符合什么规定? + +### 总体 + +1. 所有内容**必须符合中华人民共和国法律**,不得出现涉政、色情、赌毒等内容。 +2. 部分内容需按照templates下的**模板**进行填写,允许在下方追加内容。 +3. 媒体资源建议引用**中国大陆用户能够正常访问**的资源。 +4. 我们建议引用链接为**简体中文官方内容**。 +5. 我们建议所有内容用尽可能简单的语言进行阐释。 + +### 发行版 + +1. 请不要将多个发行版合并到一篇文章中。 +2. 衍生发行版不应被置于父发行版的“风味”部分,而应单开一页。 +3. **请确保镜像源以及换源教程地址存在。** 再次感谢您的理解! \ No newline at end of file diff --git a/docs/concepts/linux/de.md b/docs/concepts/linux/de.md new file mode 100644 index 0000000..0ade6a5 --- /dev/null +++ b/docs/concepts/linux/de.md @@ -0,0 +1,19 @@ +# 桌面环境 + +英文:Desktop Environment (DE) + +## 解释 + +桌面环境指您日常与操作系统交互的桌面,是决定用户体验与外观的最重要因素。 + +???+ note "一些常见的DE" + - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 + ![KDE](https://fedoraproject.org/assets/images/kde-edition/background_plasma.png) + - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) + ![GNOME](https://fedoraproject.org/assets/images/workstation_framework.webp) + - COSMIC: 拥有优秀的窗口管理机制,自定义性强 + ![COSMIC](https://fedoraproject.org/assets/images/spins/screenshot-cosmic.jpg) + - Hyprland: 平铺窗口管理器,具有炫酷的视觉效果,并拥有Wayland的最新特性,不过配置复杂,并且只建议在Arch Linux上获得最佳体验 + ![Hyprland](https://hypr.land/ricing_competitions/1/flicko.webp) + - Niri: 滚动窗口管理器,比Hyprland更适合生产环境与触控板逻辑,同样配置复杂,但发行版覆盖范围广 + ![Niri](https://www.phoronix.net/image.php?id=2026&image=niri_2604_2) diff --git a/docs/concepts/linux/distro.md b/docs/concepts/linux/distro.md new file mode 100644 index 0000000..754d39e --- /dev/null +++ b/docs/concepts/linux/distro.md @@ -0,0 +1,9 @@ +# 发行版 + +英文:Distro + +## 解释 + +发行版是建立在Linux内核基础上,为应用提供服务的架构。发行版的差别主要在包管理与二进制执行两方面,部分发行版会具有一些特性,例如“不可变”,“CPU性能优化”等等。 + +您可以参考我们提供的“发行版”章节来选择。 \ No newline at end of file diff --git a/docs/concepts/operating_system/file_systems.md b/docs/concepts/operating_system/file_systems.md index 886655c..e908d2c 100644 --- a/docs/concepts/operating_system/file_systems.md +++ b/docs/concepts/operating_system/file_systems.md @@ -6,9 +6,8 @@ 文件系统用于组织分区中文件的结构,可以理解为分区的不同类型。 -常见的文件系统有以下几种: - - - Ext3 (Linux常用,旧) - - Ext4 (Linux常用) - - Brtfs (Linux可用,但不建议新手涉足) - - NTFS (Windows常用) \ No newline at end of file +???+ note "常见的文件系统" + - Ext3 (Linux常用,旧) + - Ext4 (Linux常用) + - Brtfs (Linux可用,但不建议新手涉足) + - NTFS (Windows常用) \ No newline at end of file diff --git a/docs/distros/arch/archlinux.md b/docs/distros/arch/archlinux.md index baf36d5..050160d 100644 --- a/docs/distros/arch/archlinux.md +++ b/docs/distros/arch/archlinux.md @@ -18,7 +18,8 @@ Arch Linux 是 Linux 社区中最受欢迎的独立滚动更新(Rolling Releas - - USTC: https://mirrors.ustc.edu.cn/archlinux/iso/ - - CERNET: https://mirrors.cernet.edu.cn/archlinux/iso/ - 包管理器:pacman - > 注意!Arch 严禁“部分升级”(Partial Upgrade)。请勿在未同步升级全系统的情况下单独安装或更新某个软件,否则极易导致系统依赖断裂造成所谓的 **“滚挂”** !此外,推荐配置 **AUR (Arch User Repository)** 并配合 yay 或 paru 等助手使用。 +!!! warning "警告" + 注意!Arch 严禁“部分升级”(Partial Upgrade)。请勿在未同步升级全系统的情况下单独安装或更新某个软件,否则极易导致系统依赖断裂造成所谓的 **“滚挂”** !此外,推荐配置 **AUR (Arch User Repository)** 并配合 yay 或 paru 等助手使用。 - 更新方式:传统 - 换源教程: - - TUNA: https://mirrors.tuna.tsinghua.edu.cn/help/archlinux/ diff --git a/docs/distros/debian/ubuntu.md b/docs/distros/debian/ubuntu.md index 2979287..c73d2af 100644 --- a/docs/distros/debian/ubuntu.md +++ b/docs/distros/debian/ubuntu.md @@ -18,7 +18,8 @@ Ubuntu是当今最受认可的Linux发行版,也是中国国家操作系统基 - - USTC: https://mirrors.ustc.edu.cn/ubuntu-cdimage/ - - CERNET: https://mirrors.cernet.edu.cn/ubuntu-cdimage/ - 包管理器:apt - > 注意!使用apt安装部分软件时可能[被Snap劫持](https://www.zhihu.com/question/47659130)! +!!! warning "警告" + 注意!使用apt安装部分软件时可能[被Snap劫持](https://www.zhihu.com/question/47659130)! - 更新方式:传统 - 换源教程: - - TUNA: https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu-ports/ diff --git a/docs/distros/rhel/fedora.md b/docs/distros/rhel/fedora.md index b87e855..468ab2d 100644 --- a/docs/distros/rhel/fedora.md +++ b/docs/distros/rhel/fedora.md @@ -74,10 +74,9 @@ Fedora是一款前沿、开放的发行版,有着广泛的社区支持,并 Fedora由于版权限制,无法内置H264/H265编解码器,因此需要手动添加源来安装。 -镜像源: - - - TUNA: https://mirrors.tuna.tsinghua.edu.cn/help/rpmfusion/ - - USTC: https://mirrors.ustc.edu.cn/help/rpmfusion.html - - CERNET: https://help.mirrors.cernet.edu.cn/rpmfusion/ +???+ info "镜像源帮助" + - TUNA: https://mirrors.tuna.tsinghua.edu.cn/help/rpmfusion/ + - USTC: https://mirrors.ustc.edu.cn/help/rpmfusion.html + - CERNET: https://help.mirrors.cernet.edu.cn/rpmfusion/ 在添加源后,请在终端运行`sudo dnf group install Multimedia`来安装编解码器。 \ No newline at end of file diff --git a/docs/getting-started/before-installing.md b/docs/getting-started/before-installing.md index 0d95994..0f12742 100644 --- a/docs/getting-started/before-installing.md +++ b/docs/getting-started/before-installing.md @@ -10,16 +10,20 @@ 各品牌、型号电脑关闭安全启动的方法不同,如果与提供的路径不同,我们建议您使用AI辅助或搜索具体解决方案。 -**BIOS是电脑的核心配置部分,如果您没有经验,我们建议您寻求AI或他人帮助,而不是自行修改!!!** +!!! warning "警告" + BIOS是电脑的核心配置部分,如果您没有经验,我们建议您寻求AI或他人帮助,而不是自行修改!!! ## 选择发行版 发行版选择至关重要,这会从根本上决定您的日常使用体验。我们建议您参考网络资料与用户评价进行选择。 -如果您初入Linux,我们建议您选择Debian系或红帽系发行版试水。**我们不建议任何新手用户直接使用Arch Linux!!!** +!!! warning "警告" + 如果您初入Linux,我们建议您选择Debian系或红帽系发行版试水。**我们不建议任何新手用户直接使用Arch Linux!!!** 下面是一些由我们排序的发行版,这里仅仅是一个简单难易度和激进程度的对比,具体的其他优势请查阅其他资料,您也可以点开各自的链接来**了解并比较**。 +**我们建议您在安装前与安装后查看所选择发行版的“注意事项”一节。** +
@@ -64,48 +68,63 @@ 或者,你也可以试试我们制作的[趣味测试](https://lati-fun.pages.dev/),虽然只是个demo版本。 (部署于Cloudflare Pages,访问可能缓慢) -## 调配分区 -我们建议您通过专业的分区工具(如[DiskGenius](https://www.diskgenius.cn/)和Windows的磁盘管理单元)进行分区。您需要用分区工具在电脑硬盘上腾出60GB以上(建议值)的**空闲**空间。我们不建议直接创建分区,而是在安装时由安装程序进行创建,这可以保证系统的稳定性和分区一致性。 +???+ note "发行版=外观?" -**请不要将Linux安装到任何NTFS文件系统的分区,这将导致你的系统完全无法启动!Linux对NTFS的支持尚不完善!我们不建议使用Linux来调整NTFS分区!!!** + 请注意:**如果您的想法是“这个发行版很漂亮,我选这个”**,那么您可能听信了某些传教士的“一面之词”。 -**任何分区操作都存在风险,请您在操作之前确保已经备份了重要数据!!!** + **桌面外观不由发行版本身决定,而是由您所安装的桌面环境决定。** -## 下载镜像 + 我用某个发行版并不代表我必须使用某个桌面环境。与Windows不同,Linux的组件之间具有极其高的耦合度!您完全可以选用更加简单的发行版来体验您心仪的桌面环境。 + + 在继续之前,我们建议您阅读并**分辨**以下概念章节: + + - 发行版 + - 桌面环境 -您需要先到各发行版介绍中找到“镜像下载链接”下载系统镜像,我们建议您选择最新,并且预装您所需要的桌面环境的版本。 -以下是一些常见的发行版标签: +## 调配分区 - - x86-64/amd64: 大多数PC(一般选这个) - - arm64/aarch64: 树莓派、IoT等设备 - - desktop: 带桌面环境的系统(推荐) - - server: 服务器用系统,无桌面环境 +我们建议您通过专业的分区工具(如[DiskGenius](https://www.diskgenius.cn/)和Windows的磁盘管理单元)进行分区。您需要用分区工具在电脑硬盘上腾出60GB以上(建议值)的**空闲**空间。我们不建议直接创建分区,而是在安装时由安装程序进行创建,这可以保证系统的稳定性和分区一致性。 -一些桌面环境(您也可以在“桌面环境”(WIP)一章中进行比较): +!!! warning "警告" + 请不要将Linux安装到任何NTFS文件系统的分区,这将导致你的系统完全无法启动!Linux对NTFS的支持尚不完善!我们不建议使用Linux来调整NTFS分区!!! + + 任何分区操作都存在风险,请您在操作之前确保已经备份了重要数据!!! - - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 - ![KDE](https://fedoraproject.org/assets/images/kde-edition/background_plasma.png) - - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) - ![GNOME](https://fedoraproject.org/assets/images/workstation_framework.webp) - - COSMIC: 拥有优秀的窗口管理机制,自定义性强 - ![COSMIC](https://fedoraproject.org/assets/images/spins/screenshot-cosmic.jpg) - - Hyprland: 平铺窗口管理器,具有炫酷的视觉效果,并拥有Wayland的最新特性,不过配置复杂,并且只建议在Arch Linux上获得最佳体验 - ![Hyprland](https://hypr.land/ricing_competitions/1/flicko.webp) - - Niri: 滚动窗口管理器,比Hyprland更适合生产环境与触控板逻辑,同样配置复杂,但发行版覆盖范围广 - ![Niri](https://www.phoronix.net/image.php?id=2026&image=niri_2604_2) +## 下载镜像 -## 烧录镜像 +您需要先到各发行版介绍中找到“镜像下载链接”下载系统镜像,我们建议您选择最新,并且预装您所需要的桌面环境的版本。 + +???+ note "一些常见的发行版标签" + - x86-64/amd64: 大多数PC(一般选这个) + - arm64/aarch64: 树莓派、IoT等设备 + - desktop: 带桌面环境的系统(推荐) + - server: 服务器用系统,无桌面环境 + +???+ note "一些桌面环境" + - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 + ![KDE](https://fedoraproject.org/assets/images/kde-edition/background_plasma.png) + - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) + ![GNOME](https://fedoraproject.org/assets/images/workstation_framework.webp) + - COSMIC: 拥有优秀的窗口管理机制,自定义性强 + ![COSMIC](https://fedoraproject.org/assets/images/spins/screenshot-cosmic.jpg) + - Hyprland: 平铺窗口管理器,具有炫酷的视觉效果,并拥有Wayland的最新特性,不过配置复杂,并且只建议在Arch Linux上获得最佳体验 + ![Hyprland](https://hypr.land/ricing_competitions/1/flicko.webp) + - Niri: 滚动窗口管理器,比Hyprland更适合生产环境与触控板逻辑,同样配置复杂,但发行版覆盖范围广 + ![Niri](https://www.phoronix.net/image.php?id=2026&image=niri_2604_2) -在下载对应镜像后,您需要下载对应的烧录软件来将系统镜像烧录到U盘中。下面是一些比较热门的烧录软件。 +## 烧录镜像 - - [Ventoy](https://www.ventoy.net/cn/download.html) - - [Rufus](https://rufus.ie/zh/) - - [balenaEtcher](https://etcher.balena.io/) - - [Raspberry Pi Imager](https://www.raspberrypi.com/software/) +在下载对应镜像后,您需要下载对应的烧录软件来将系统镜像烧录到U盘中。 +???+ note "一些比较热门的烧录软件" + - [Ventoy](https://www.ventoy.net/cn/download.html) + - [Rufus](https://rufus.ie/zh/) + - [balenaEtcher](https://etcher.balena.io/) + - [Raspberry Pi Imager](https://www.raspberrypi.com/software/) -**在烧录前,请确保您的U盘中没有重要资料!U盘的所有文件将被清空且几乎不可逆!!!** +!!! warning "警告" + 在烧录前,请确保您的U盘中没有重要资料!U盘的所有文件将被清空且几乎不可逆!!! --- 好的,一切准备工作完成!打开下一章,开始踏入Linux吧! diff --git a/docs/getting-started/install.md b/docs/getting-started/install.md index 1079447..39a5c66 100644 --- a/docs/getting-started/install.md +++ b/docs/getting-started/install.md @@ -4,7 +4,8 @@ 大部分BIOS为全英文界面,并且操作方法因机器而异。在此我们依然建议您使用AI辅助操作或搜寻相关资料。 -**BIOS是电脑的核心配置部分,如果您没有经验,我们建议您寻求AI或他人帮助,而不是自行修改!!!** +!!! warning "警告" + BIOS是电脑的核心配置部分,如果您没有经验,我们建议您寻求AI或他人帮助,而不是自行修改!!! ## 引导系统 diff --git a/docs/getting-started/purpose.md b/docs/getting-started/purpose.md index f408ec9..5f428f6 100644 --- a/docs/getting-started/purpose.md +++ b/docs/getting-started/purpose.md @@ -6,9 +6,11 @@ 此处的“知识”主要是指诸如分区,引导以及操作系统相关知识等等基本概念,不需要像高中课程那样深入了解。 -如果你还不太了解,可以看一看我们编写的“概念”部分(WIP)来补课。我们不推荐小白跳过这一部分,**否则可能导致您所使用设备的操作系统产生不稳定性或发生严重损坏!!!造成的损失不由LinuxCabin以及文档贡献者承担!!!** +如果你在实践的过程中发现了太了解的名词,可以看一看我们编写的“概念”部分来补课。 + +!!! warning "警告" + 我们不推荐小白跳过理解直接无脑干,**否则可能导致您所使用设备的操作系统产生不稳定性或发生严重损坏!!!造成的损失不由LinuxCabin以及文档贡献者承担!!!** -如果你已经能够熟练运用了,您可以继续向下阅读。 ## 我为什么要使用Linux? @@ -57,7 +59,7 @@ 并且,您一定要明辨下面的几个概念: - - 桌面环境 (DDE) + - 桌面环境 (DE) - 发行版 - 滚动更新 diff --git a/mkdocs.yml b/mkdocs.yml index bfec0cf..6e0c509 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -11,6 +11,12 @@ theme: - navigation.footer +markdown_extensions: + - admonition + - pymdownx.details + - pymdownx.highlight + - pymdownx.inlinehilite + plugins: - search @@ -27,6 +33,8 @@ nav: - 概念: - Linux基础: - concepts/linux/free_software.md + - concepts/linux/distro.md + - concepts/linux/de.md - 操作系统: - concepts/operating_system/partition.md - concepts/operating_system/file_systems.md -- cgit v1.3