From ac89c2855217c8d44ab9a585cb36ef1885bf7369 Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Fri, 31 Jul 2026 14:33:20 +0800 Subject: Merge #16, migrate Actions to GIthub --- docs/applications/vim.md | 72 ++++++++++++++++++++++++++---------------------- 1 file changed, 39 insertions(+), 33 deletions(-) (limited to 'docs') diff --git a/docs/applications/vim.md b/docs/applications/vim.md index a87b99e..1641317 100644 --- a/docs/applications/vim.md +++ b/docs/applications/vim.md @@ -1,11 +1,12 @@ -# vim +# Vim -`vim` 是一款终端文本编辑器, 几乎所有的Linux发行版都会预装 -第一次使用vim的人,最大的感受一定是: 反人类 -vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的) +`vim` 是一款终端文本编辑器, 几乎所有的Linux发行版都会预装。 -话虽如此,在终端用vim 改个配置文件依旧是很多Linux玩家的日常 -所以我们有必要稍微学习一下如何使用vim完成以下基础的操作 +第一次使用vim的人,最大的感受一定是: 反人类。 +Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的)。 + +话虽如此,在终端用Vim改个配置文件依旧是很多Linux玩家的日常 +所以我们有必要稍微学习一下如何使用Vim完成以下基础的操作。 --- @@ -31,11 +32,11 @@ vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接 ## 模式的转换 -我们可以将 **NORMAL** 视作 vim 模式的中心枢纽 -因为**所有的模式下,按esc键都能变成普通模式** -并且 普通模式 只需要按一个键就可以切换到各种模式 +我们可以将 **NORMAL** 视作 vim 模式的中心枢纽。 +因为**所有的模式下,按esc键都能变成普通模式**。 +并且 普通模式 只需要按一个键就可以切换到各种模式。 -所以我们只需要记住下面的内容即可 (对于新手来说) +所以我们只需要记住下面的内容即可 (对于新手来说): 当你处于非普通模式的时候: @@ -46,40 +47,45 @@ vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接 - i -> 进入插入模式 - : -> 进入命令模式(没错这里就是打个冒号) ---- - ## 一般流程 - 打开文件 -```bash -# 使用 vim 打开你需要编辑的文件 -# 语法是 vim 路径 -vim /path/to/file -``` + ```bash + # 使用 vim 打开你需要编辑的文件 + # 语法是 vim 路径 + vim /path/to/file + ``` -打开之后就是普通模式 + 打开之后就是普通模式。 - 移动 -这个时候如果不是空的文件,你一般需要移动 -可以直接使用方向键 -或者用这个**超人类语法** -> h j k l (分别对应 左 下 右 上 的方向键) + 这个时候如果不是空的文件,你一般需要移动。 + + 可以直接使用方向键,或者用这个**超人类语法** -> h j k l (分别对应 左 下 右 上 的方向键)。 - 进入插入模式进行编辑 -按下 `i` 键, **看到左下角出现INSERT** -然后就是正常的编辑工作 + + 按下 `i` 键, **看到左下角出现INSERT**,然后就是正常的编辑工作 - 保存修改 -我们需要使用命令模式保存修改,所以第一步是先按 Esc 回到普通模式 -这个时候你会发现左下角的INSERT消失了 -然后按 `:` 进入命令模式 -> 你会看到左下角出现 冒号 -输入 `w` (表示我要将修改写入文件, 也就是 write) -回车 (这个时候你已经保存了修改) -输入 `q` (表示我要退出vim, 也就是quit) -回车 -这个时候你已经成功使用 vim 完成了编辑工作 + 我们需要使用命令模式保存修改,所以第一步是先按 Esc 回到普通模式。 + + 这个时候你会发现左下角的INSERT消失了, + + 然后按 `:` 进入命令模式 -> 你会看到左下角出现冒号 + + 输入 `w` (表示我要将修改写入文件, 也就是 write) + + 回车 (这个时候你已经保存了修改) + + 输入 `q` (表示我要退出vim, 也就是quit) + + 回车 + + 这个时候你已经成功使用 vim 完成了编辑工作 -> 当然命令模式是可以一次执行多个命令的, 可以直接 `:wq` 表示保存并退出文件 + > 当然命令模式是可以一次执行多个命令的, 可以直接 `:wq` 表示保存并退出文件 --- @@ -87,4 +93,4 @@ vim /path/to/file > 这里补充一些教程,但是入门的话使用当前的文档足矣 -[蛋老师bilibili教程](https://www.bilibili.com/video/BV13t4y1t7Wg?t=87.5) +[蛋老师Bilibili教程](https://www.bilibili.com/video/BV13t4y1t7Wg?t=87.5) -- cgit v1.3 From 3702b4a322403f062c3e47ea15c35a503586245a Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Fri, 31 Jul 2026 15:54:41 +0800 Subject: Update contact --- docs/about.md | 4 ++-- docs/applications/vim.md | 14 +++++++------- 2 files changed, 9 insertions(+), 9 deletions(-) (limited to 'docs') diff --git a/docs/about.md b/docs/about.md index fc1e8ae..48d5ff7 100644 --- a/docs/about.md +++ b/docs/about.md @@ -10,7 +10,7 @@ LinuxCabin是由[@Fangcat_Dev](https://space.bilibili.com/588672425)与[@13-trix QQ: 2950966704 -Matrix: @fangcat-dev:fedora.im +Matrix: [@fangcat_dev:mozilla.org](https://matrix.to/#/@fangcat_dev:mozilla.org) E-Mail: [f20091219@outlook.com](mailto:f20091219@outlook.com) @@ -20,7 +20,7 @@ BiliBili: [Fangcat_Dev](https://space.bilibili.com/588672425) QQ: 1513463007 -Matrix: @13-trixie:matrix.org +Matrix: [@13-trixie:matrix.org](https://matrix.to/#/@13-trixie:matrix.org) - Outlook Main E-Mail(recommended): [HFhaofan@outlook.com](mailto:HFhaofan@outlook.com) - Google E-Mail(recommended): [breezearch11@gmail.com](mailto:breezearch11@gmail.com) diff --git a/docs/applications/vim.md b/docs/applications/vim.md index 1641317..e9f0815 100644 --- a/docs/applications/vim.md +++ b/docs/applications/vim.md @@ -16,17 +16,17 @@ Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接 对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是 - **INSERT** -> 插入模式 - - 插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式 - - 当你处于插入模式的时候, **左下角会出现 INSERT** + - 插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式 + - 当你处于插入模式的时候, **左下角会出现 INSERT** - **NORMAL** -> 普通模式 - - 普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改** - - 当你处于普通模式的时候, **左下角是空的**,普通是默认的模式 + - 普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改** + - 当你处于普通模式的时候, **左下角是空的**,普通是默认的模式 - **COMMAND** -> 命令模式 - - 命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端** - - 当然这个模式也是可以批量处理文本的(比如说替换之类的操作) - - 当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中** + - 命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端** + - 当然这个模式也是可以批量处理文本的(比如说替换之类的操作) + - 当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中** --- -- cgit v1.3 From 4371742df7c3478a2968d5c671f1651eb701dbeb Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Fri, 31 Jul 2026 16:20:10 +0800 Subject: Admonitions --- docs/concepts/desktop/de.md | 2 +- docs/concepts/desktop/desktop_shell.md | 2 +- docs/concepts/linux/shell.md | 2 +- docs/concepts/operating_system/file_system.md | 2 +- docs/getting-started/before-installing.md | 18 +++++++++--------- mkdocs.yml | 1 + 6 files changed, 14 insertions(+), 13 deletions(-) (limited to 'docs') diff --git a/docs/concepts/desktop/de.md b/docs/concepts/desktop/de.md index cebce59..ac0f1a8 100644 --- a/docs/concepts/desktop/de.md +++ b/docs/concepts/desktop/de.md @@ -6,7 +6,7 @@ 桌面环境(有时称为桌面管理器)是对图形化桌面的实现。通常由多个软件组成。一个桌面环境中的软件共享同一个图形用户界面。在一个典型的桌面环境中,这些软件提供给计算机用户窗口,文件夹,工具栏,壁纸、图标以及像拖放等图形化服务。不同桌面环境在设计和功能上的特性和理念,会赋予其与众不同的外观和使用体验。 -???+ note "一些常见的DE" +???+ example "一些常见的DE" - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 ![KDE](https://fedoraproject.org/assets/images/kde-edition/background_plasma.png) - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) diff --git a/docs/concepts/desktop/desktop_shell.md b/docs/concepts/desktop/desktop_shell.md index 8aff196..0f8e4fc 100644 --- a/docs/concepts/desktop/desktop_shell.md +++ b/docs/concepts/desktop/desktop_shell.md @@ -6,7 +6,7 @@ 狭义来看,桌面外壳是指在**平铺窗口管理器**中,提供用户界面的应用套件。 -???+ note "常见的桌面外壳" +???+ example "常见的桌面外壳" - DMS (Dank Material Shell): 目前最广为人知的桌面外壳,采用Material You设计理念,现代而优雅。 ![DMS](https://danklinux.com/img/desktoplight.png) ??? info "安装教程" diff --git a/docs/concepts/linux/shell.md b/docs/concepts/linux/shell.md index 9eeb82c..9701057 100644 --- a/docs/concepts/linux/shell.md +++ b/docs/concepts/linux/shell.md @@ -11,7 +11,7 @@ Shell是用户与Linux内核直接对话的“窗口”,你可以将它理解 !!! warning "消歧义" 终端是Shell的图形化呈现。尽管有Ptyxis、Konsole等等终端,但其所调用、运行的依然是诸如Bash等等的Shell。 -??? note "常见的Linux Shell" +???+ example "常见的Linux Shell" - Bash: 大多数Linux发行版预装的Shell,兼容性强,支持广 - Zsh: 自定义性强,有强大的自动补全功能,并兼容Bash语法 - Fish: 用户友好,人性化设计,易配置 \ No newline at end of file diff --git a/docs/concepts/operating_system/file_system.md b/docs/concepts/operating_system/file_system.md index 7dfcab4..7380e30 100644 --- a/docs/concepts/operating_system/file_system.md +++ b/docs/concepts/operating_system/file_system.md @@ -6,7 +6,7 @@ 文件系统是一种存储和组织计算机数据(如txt文件)的方法,它使得对存储设备(如硬盘、U盘)访问和查找变得容易,文件系统使用文件和目录的抽象高级概念代替了硬盘和光盘等物理设备使用数据块的概念,就像油画和照片的区别,不同的文件系统可以理解为不同的画派。 -???+ note "常见的文件系统" +???+ example "常见的文件系统" - Ext3 (Linux可用,已基本废弃) - Ext4 (Linux常用,推荐使用) - Brtfs (Linux可用,有众多高级特性,但不建议新手涉足) diff --git a/docs/getting-started/before-installing.md b/docs/getting-started/before-installing.md index e0796eb..b8f5be1 100644 --- a/docs/getting-started/before-installing.md +++ b/docs/getting-started/before-installing.md @@ -30,16 +30,16 @@ 难易度 激进度 - 激进 - 偏激进 - 偏保守 - 保守 + 前沿 + 偏前沿 + 偏稳定 + 稳定 困难 - Arch Linux / Artix Linux / NixOS Unstable + Arch Linux / Artix Linux / NixOS Unstable Guix Linux - Gentoo Linux / NixOS Stable + Gentoo Linux / NixOS Stable LFS (Linux From Scratch) @@ -104,13 +104,13 @@ 我们建议您选择最新,并且预装您所需要的桌面环境的版本。 -???+ note "一些常见的发行版标签" +???+ example "一些常见的发行版标签" - x86-64/amd64: 大多数PC(一般选这个) - arm64/aarch64/armv8l/armv8a: 树莓派、IoT等设备 - desktop: 带桌面环境的系统(推荐) - server: 服务器用系统,无桌面环境 -???+ note "一些桌面环境/窗口管理器" +???+ example "一些桌面环境/窗口管理器" - [KDE](../desktop/de/kde.md) (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 ![KDE](https://fedoraproject.org/assets/images/kde-edition/background_plasma.png) - [GNOME](../desktop/de/gnome.md): 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得较好的桌面体验) @@ -125,7 +125,7 @@ ## 烧录镜像 在下载对应镜像后,您需要下载对应的烧录软件来将系统镜像烧录到U盘中。 -???+ note "一些比较热门的烧录软件" +???+ example "一些比较热门的烧录软件" - [Ventoy](https://www.ventoy.net/cn/download.html)(推荐) ??? note "Ventoy使用指南" 在开始本教程之前,请准备一个**足够大**的 U 盘。足够大意味着**可以保存您要使用的的全部系统镜像。**请注意,**这将清除 U 盘上的所有数据**。 diff --git a/mkdocs.yml b/mkdocs.yml index ec2e3b6..72cbf3f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -63,6 +63,7 @@ markdown_extensions: - attr_list - tables - footnotes + - md_in_html - toc: permalink: true -- cgit v1.3 From 7c05232eed9724d8057aad62ce5e7a0388369693 Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Fri, 31 Jul 2026 16:52:29 +0800 Subject: Interesting quotes --- docs/distros/arch/archlinux.md | 15 +++++++++++++++ docs/distros/debian/ubuntu.md | 7 +++++++ docs/distros/rhel/fedora.md | 21 +++++++++++++++++++++ docs/getting-started/before-installing.md | 11 +++++++++-- docs/getting-started/devices/drivers.md | 9 ++++++++- 5 files changed, 60 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/distros/arch/archlinux.md b/docs/distros/arch/archlinux.md index 0688061..b3a8f69 100644 --- a/docs/distros/arch/archlinux.md +++ b/docs/distros/arch/archlinux.md @@ -6,6 +6,21 @@ Arch Linux 是 Linux 社区中最受欢迎的独立滚动更新(Rolling Release)发行版之一。它秉承 KISS(Keep It Simple, Stupid)哲学,不预装繁杂的软件和默认桌面,将系统的完全掌控权交还给用户。虽然其全命令行安装的方式对新手门槛较高,但它拥有所有GNU/Linux发行版中最强大的知识库 Arch Wiki、极度丰富的 AUR 软件仓库以及“一次安装,终身更新”的特性,是极客和深度 Linux 爱好者的不二之选。 +???+ quote "名人名言" + And at the same time, there are the really tech oriented ones where you compile your own, everything you compile your own distro. And again, that was not geared for me. + + ... + + I want a distro that just installs and just works. + + *另一方面,也有那种特别“技术向”的发行版,那种什么都要自己编译,从零搞起的发行版,同样也不适合我。* + + *...* + + *我想要的是开箱即用的发行版。* + +

——Linus Torvalds

+ ## 详细信息 - 派系:Arch系 diff --git a/docs/distros/debian/ubuntu.md b/docs/distros/debian/ubuntu.md index 0f56452..8c133f6 100644 --- a/docs/distros/debian/ubuntu.md +++ b/docs/distros/debian/ubuntu.md @@ -6,6 +6,13 @@ Ubuntu是当今最受认可的Linux发行版,也是中国国家操作系统基准架构。它用户支持广泛,兼容性强,并且有优秀的开箱即用体验。不过近年来的商业化操作令Linux社区对它嗤之以鼻。 +???+ quote "名人名言" + Ubuntu very much wanted to be like a consumer oriented thing. And in the process, when I tried it many, many years ago, they literally made it hard for me to upgrade the kernel because that was not their target audience. + + *Ubuntu就很想做成面向消费者的系统。结果我很多很多年前试的时候,他们把升级内核搞得非常麻烦,因为我们根本不是他们针对的用户。* + +

——Linus Torvalds

+ ## 详细信息 - 派系:Debian系 diff --git a/docs/distros/rhel/fedora.md b/docs/distros/rhel/fedora.md index d8d02fc..a43f104 100644 --- a/docs/distros/rhel/fedora.md +++ b/docs/distros/rhel/fedora.md @@ -6,6 +6,27 @@ Fedora是一款前沿、开放的发行版,有着广泛的社区支持,并且提供多种变体可供选择。 +???+ quote "名人名言" + They've been very closely aligned to kernel developers. They make things easier. + + *他们和内核开发者的关系很紧密,很多事做起来更顺。* + +

——Linus Torvalds

+ + ??? quote "玩笑" + + Linus: When I'm emperor and king of the world... + + Elijah: It will be Fedora? + + Linus: That will be. + + *Linus: 等我当了世界皇帝的时候...* + + *Elijah: 就只许用Fedora了?* + + *Linus: 就只许用它了。* + ## 详细信息 - 派系:红帽系 diff --git a/docs/getting-started/before-installing.md b/docs/getting-started/before-installing.md index b8f5be1..6a3d752 100644 --- a/docs/getting-started/before-installing.md +++ b/docs/getting-started/before-installing.md @@ -17,6 +17,14 @@ [发行版](../concepts/linux/distro.md)选择至关重要,这会从根本上决定您的日常使用体验。我们建议您参考网络资料与用户评价进行选择,或者被其他人“带师”。 +???+ quote "名人名言" + I mean, I think the fragmentation has been a huge disadvantage over the years. + + *我觉得这种碎片化,近年来确实是一个巨大的劣势。* + +

——Linus Torvalds

+ + !!! warning "警告" 如果您初入Linux,我们建议您选择Debian系或红帽系发行版试水。**我们不建议任何新手用户直接使用Arch Linux!!!** @@ -69,7 +77,7 @@ 或者,你也可以试试[Distrochooser(英文)](https://distrochooser.de/)或是我们制作的[趣味测试](https://lati-fun.pages.dev/),虽然只是个demo版本。 (部署于Cloudflare Pages,访问可能缓慢) -???+ note "发行版=外观?" +???+ question "发行版=外观?" 请注意:**如果您的想法是“这个发行版很漂亮,我选这个”**,那么您可能听信了某些传教士的“一面之词”。 @@ -84,7 +92,6 @@ - [窗口管理器](../concepts/desktop/wm.md) - [平铺式桌面](../concepts/desktop/tiling_desktop.md) - ## 调配分区 我们建议您通过专业的[分区](../concepts/operating_system/partition.md)工具——如[DiskGenius](https://www.diskgenius.cn/)([教程](https://www.diskgenius.cn/help/partresizing.php))和Windows的磁盘管理单元([教程](https://freeswzhcn.codeberg.page/site/posts/%E4%B8%BA%20GNU-Linux%20%E5%87%86%E5%A4%87%E5%8F%8C%E5%90%AF%E5%8A%A8%E5%88%86%E5%8C%BA%E2%80%94%E2%80%94Microsoft%20Windows/))——进行分区。您需要用分区工具在电脑硬盘上腾出60GB以上(建议值)的**空闲**空间。我们不建议直接在DiskGenius等WIndows下软件创建分区,而是在安装时由安装程序进行创建,这可以保证系统的稳定性和分区一致性。 diff --git a/docs/getting-started/devices/drivers.md b/docs/getting-started/devices/drivers.md index fbe726a..93eea91 100644 --- a/docs/getting-started/devices/drivers.md +++ b/docs/getting-started/devices/drivers.md @@ -42,6 +42,13 @@ AMD不同架构的显卡需要不同驱动,但大多数使用`amdgpu`(专有 ### NVIDIA +???+ quote "名人名言" + So NVIDIA, fuck you. + + *所以,英伟达,去你妈的。* + +

——Linus Torvalds

+ NVIDIA对Linux用户的驱动在23年以来,支持日渐完善,NVIDIA显卡目前在极个别方面不足外,几乎已经追平Windows。目前NVIDIA在最新驱动开源部分非关键的内核空间部分,即nvidia-open。但其用户空间工具(如CUDA,DLSS等)依然闭源,即nvidia-utils。 同样,NVIDIA不同架构的显卡也需要不同的驱动,但是NVIDIA相对AMD更为复杂 @@ -79,7 +86,7 @@ Intel网卡在Linux系统下享有业界相对顶级的原生支持。绝大多 Broadcom(博通)无线网卡在Linux系统下的支持情况因芯片型号而异。部分网卡已原生集成于内核中,开箱即用,而大部分老旧或特定型号(如BCM43142等)需手动安装专属闭源驱动(broadcom-sta)或配置固件。 -???+info "目前的支持情况" +???+ info "目前的支持情况" - 原生支持芯片(brcmsmac/brcmfmac):大多数较新的Broadcom无线网卡由内核中的开源驱动直接支持,这类网卡通常即插即用。 - 需要专有驱动的芯片(broadcom-sta/wl):例如BCM4311, BCM4312, BCM4313, BCM43142, BCM4360等。这类设备在主流发行版(如 Ubuntu, Debian, Arch Linux 等)中需要安装broadcom-wl或 bcmwl-kernel-source驱动包。 - 极其老旧或部分极新芯片:可能仅有Windows驱动 -- cgit v1.3 From c6d36bf37ffb2acdef131f6fd30df311ace63f5d Mon Sep 17 00:00:00 2001 From: FangcatChina Date: Sat, 1 Aug 2026 14:15:00 +0800 Subject: Fix Format --- docs/distros/arch/archlinux.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/distros/arch/archlinux.md b/docs/distros/arch/archlinux.md index b3a8f69..8075007 100644 --- a/docs/distros/arch/archlinux.md +++ b/docs/distros/arch/archlinux.md @@ -33,10 +33,12 @@ Arch Linux 是 Linux 社区中最受欢迎的独立滚动更新(Rolling Releas - USTC: https://mirrors.ustc.edu.cn/archlinux/iso/ - MirrorZ: https://mirrors.cernet.edu.cn/archlinux/iso/ - 包管理器:[pacman](../../concepts/package_managers/pacman.md) + !!! warning "警告" - Arch 严禁“部分升级”(Partial Upgrade)。请勿在未同步升级全系统的情况下单独安装或更新某个软件,否则极易导致系统依赖断裂造成所谓的 **“滚挂”** ! - - 在每次更新系统时,请一定阅读Arch Linux官网新闻,以查阅是否需要手动干预的软件包。 + Arch 严禁“部分升级”(Partial Upgrade)。请勿在未同步升级全系统的情况下单独安装或更新某个软件,否则极易导致系统依赖断裂造成所谓的 **“滚挂”** ! + + 在每次更新系统时,请一定阅读Arch Linux官网新闻,以查阅是否需要手动干预的软件包。 + - 更新方式:滚动 - 自动换源:是 - 图形安装界面:否 -- cgit v1.3