diff options
| -rw-r--r-- | CODE_OF_CONDUCT.md | 14 | ||||
| -rw-r--r-- | docs/applications/nano.md | 0 | ||||
| -rw-r--r-- | docs/applications/nvim.md | 0 | ||||
| -rw-r--r-- | docs/concepts/desktop/de.md | 19 | ||||
| -rw-r--r-- | docs/concepts/desktop/desktop_shell.md | 23 | ||||
| -rw-r--r-- | docs/concepts/desktop/dotfiles.md | 12 | ||||
| -rw-r--r-- | docs/concepts/desktop/tiling_desktop.md | 11 | ||||
| -rw-r--r-- | docs/concepts/desktop/wm.md | 12 | ||||
| -rw-r--r-- | docs/desktop/de/xfce.md | 2 | ||||
| -rw-r--r-- | docs/desktop/desktop.md | 64 | ||||
| -rw-r--r-- | docs/desktop/wm/hyprland.md | 4 | ||||
| -rw-r--r-- | docs/desktop/wm/niri.md | 4 | ||||
| -rw-r--r-- | docs/getting-started/before-installing.md | 7 | ||||
| -rw-r--r-- | docs/getting-started/purpose.md | 7 | ||||
| -rw-r--r-- | mkdocs.yml | 6 |
15 files changed, 73 insertions, 112 deletions
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 5dd281d..2909a7e 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -7,13 +7,13 @@ ## 内容 -1. 对于常见问题,不得纳入冷门、小众的内容(如某机型特定驱动修复、CLOVER引导配置等),一切问题必须是常见的,广泛的,可复现的。 -2. 对于教程,不得出现不常见的或不相关的内容(如C++编译、Synapse搭建方法)。 -3. 对于概念,不得过度涉及系统底层(如PAM、管道)。 -4. 尽可能采用简单的语言阐释,如类比等。 -5. 仅有分离困难或相关性极大的内容允许被合并(如BIOS/UEFI允许,Deepin/统信UOS、Enterprise Linux三巨头不允许)。 -6. 不得出现个人文笔色彩强烈的内容。 -7. 项目尽量遵循J4W原则,即Just4Work,指文档必须在必须的,无法避免的,影响日常的且新手需要的,可以理解的方面撰写。 +1. 项目尽量遵循J4W原则,即Just for Work,指文档应在必须的,无法避免的,影响日常的且新手需要的,可以理解的方面撰写。对于能够显著改善使用体验的内容,我们欢迎贡献。 +2. 对于常见问题,不得纳入冷门、小众的内容(如某机型特定驱动修复、CLOVER引导配置等),一切问题必须是常见的,广泛的,可复现的。 +3. 对于教程,不得出现不常见的或不相关的内容(如C++编译、Synapse搭建方法)。 +4. 对于概念,不得过度涉及系统底层(如PAM、管道)。非必要尽量少地添加新概念。 +5. 尽可能采用简单的语言阐释,如类比等。 +6. 仅有分离困难或相关性极大的内容允许被合并(如BIOS/UEFI允许,Deepin/统信UOS、Enterprise Linux三巨头不允许)。 +7. 不得出现个人文笔色彩强烈的内容。 8. 除笔误、拼写错误相关外,所有提交必须经过PR与审查流程,由Reviewers审查。 9. 允许AI生成内容,但必须经过人工实机核查。 diff --git a/docs/applications/nano.md b/docs/applications/nano.md deleted file mode 100644 index e69de29..0000000 --- a/docs/applications/nano.md +++ /dev/null diff --git a/docs/applications/nvim.md b/docs/applications/nvim.md deleted file mode 100644 index e69de29..0000000 --- a/docs/applications/nvim.md +++ /dev/null diff --git a/docs/concepts/desktop/de.md b/docs/concepts/desktop/de.md deleted file mode 100644 index ac0f1a8..0000000 --- a/docs/concepts/desktop/de.md +++ /dev/null @@ -1,19 +0,0 @@ -# 桌面环境 - -英文:Desktop Environment (DE) - -## 概述 - -桌面环境(有时称为桌面管理器)是对图形化桌面的实现。通常由多个软件组成。一个桌面环境中的软件共享同一个图形用户界面。在一个典型的桌面环境中,这些软件提供给计算机用户窗口,文件夹,工具栏,壁纸、图标以及像拖放等图形化服务。不同桌面环境在设计和功能上的特性和理念,会赋予其与众不同的外观和使用体验。 - -???+ example "一些常见的DE" - - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 -  - - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) -  - - COSMIC: 拥有优秀的窗口管理机制,自定义性强 -  - - **Hyprland与Niri不是桌面环境,而是窗口管理器。** - - **DMS与Noctalia不是桌面环境,而是桌面外壳。** diff --git a/docs/concepts/desktop/desktop_shell.md b/docs/concepts/desktop/desktop_shell.md deleted file mode 100644 index 0f8e4fc..0000000 --- a/docs/concepts/desktop/desktop_shell.md +++ /dev/null @@ -1,23 +0,0 @@ -# 桌面外壳 - -英文: Desktop Shell - -## 概述 - -狭义来看,桌面外壳是指在**平铺窗口管理器**中,提供用户界面的应用套件。 - -???+ example "常见的桌面外壳" - - DMS (Dank Material Shell): 目前最广为人知的桌面外壳,采用Material You设计理念,现代而优雅。 -  - ??? info "安装教程" - 我们建议您使用[DankInstall](https://danklinux.com/docs/dankinstall),即其一键脚本。该脚本不仅提供了桌面外壳的安装,还内置了Hyprland/Niri的安装功能,省心省力。 - - ```bash - sudo -v && curl -fsSL https://install.danklinux.com | sh -s -- \ - -c hyprland -t kitty --include-deps dms-greeter --replace-configs-all -y - ``` - - - Noctalia: 操作顺滑,可自定义性高。 -  - [安装教程(英文)](https://docs.noctalia.dev/v5/getting-started/installation) - ...
\ No newline at end of file diff --git a/docs/concepts/desktop/dotfiles.md b/docs/concepts/desktop/dotfiles.md deleted file mode 100644 index ce4e2bb..0000000 --- a/docs/concepts/desktop/dotfiles.md +++ /dev/null @@ -1,12 +0,0 @@ -# WM Dotfiles - -???+info "特别注意" - 此处的dotfiles特指一种窗口管理器的配置集合,如end-4,dms等类似的配置集 - -## 概述 - -### 为什么你可能需要他 - -与DE不同,WM通常不会给出一个默认的开箱即用配置,通常为了满足审美和操作便捷程度,就需要自定义WM的配置文件,然而,这并不是一个很小的工作量,甚至要求一定的bash和lua基础。而部分人本着贡献社区的理念,开源了他们调整好的WM配置文件,这就是dotfiles。dotfiles可以大大减少配置WM的工作量,并且获得一个相对不错的主题效果。 - -目前,较有名的dotfiles有dms、end-4、ml4w,关于他们的详细信息,请参考desktop部分。
\ No newline at end of file diff --git a/docs/concepts/desktop/tiling_desktop.md b/docs/concepts/desktop/tiling_desktop.md deleted file mode 100644 index d4ebbb5..0000000 --- a/docs/concepts/desktop/tiling_desktop.md +++ /dev/null @@ -1,11 +0,0 @@ -# 平铺桌面 - -英文: Tiling Desktop - -## 概述 - -平铺桌面简单来说就是不允许窗口堆叠(如下图),只允许窗口铺展开摆放。 - - - - diff --git a/docs/concepts/desktop/wm.md b/docs/concepts/desktop/wm.md deleted file mode 100644 index 72bf0eb..0000000 --- a/docs/concepts/desktop/wm.md +++ /dev/null @@ -1,12 +0,0 @@ -# 窗口管理器 - -英文:Window Manager (WM) - -## 概述 - -窗口管理器是在图形用户界面中,控制窗口位置与外观的软件(管理窗口的放置、配色等等)。 许多窗口管理器是为了桌面环境编写,与桌面环境一同发布的,例如被GNOME使用的Mutter。同时也存在不少独立的窗口管理器,如Openbox、Awesome等。大部分窗口管理器是针对Linux、BSD等操作系统设计编写的,用户可以通过选择窗口管理器更改电脑的图形用户界面外观和使用方式。 - -???+note "消歧义" - **Hyprland与Niri不是桌面环境,而是窗口管理器。** - -传送门:[ArchWiki](https://wiki.archlinuxcn.org/wiki/%E7%AA%97%E5%8F%A3%E7%AE%A1%E7%90%86%E5%99%A8)
\ No newline at end of file diff --git a/docs/desktop/de/xfce.md b/docs/desktop/de/xfce.md index 085e7df..35bb745 100644 --- a/docs/desktop/de/xfce.md +++ b/docs/desktop/de/xfce.md @@ -8,7 +8,7 @@ ## 概述 -Xfce是一个轻量级的[桌面环境](../concepts/desktop/de.md),Xfce用着快速且轻便易于使用的优点,Xfce开机占有的内存大约只有700M,Xfce一开始使用X11显示协议,自从4.20版本开始提供了实验性的Wayland支持。 +Xfce是一个轻量级的[桌面环境](../desktop.md#_2),Xfce用着快速且轻便易于使用的优点,Xfce开机占有的内存大约只有700M,Xfce一开始使用X11显示协议,自从4.20版本开始提供了实验性的Wayland支持。 ## 安装 diff --git a/docs/desktop/desktop.md b/docs/desktop/desktop.md index d1cbd9a..28e103a 100644 --- a/docs/desktop/desktop.md +++ b/docs/desktop/desktop.md @@ -1,10 +1,64 @@ -# 欢迎来到“桌面” +# 分类 欢迎来到桌面页面,我们在这里整理了主流的桌面环境,窗口管理器,dotfiles,旨在帮助您选择最适合你的图形化环境。 -当前主流Linux桌面配置可以分为以下两类: +当前主流Linux桌面配置可以分为以下两类。 -- 传统桌面: 参考“桌面环境”一节 -- [平铺桌面](../concepts/desktop/tiling_desktop.md): 参考“窗口管理器”与“Dotfiles”(WIP) +## 传统桌面 -有关于[桌面环境](../concepts/desktop/de.md)、[窗口管理器](../concepts/desktop/wm.md)、[dotfiles](../concepts/desktop/dotfiles.md),请跳转“概念”部分。
\ No newline at end of file +桌面环境(有时称为桌面管理器)是对图形化桌面的实现。通常由多个软件组成。一个桌面环境中的软件共享同一个图形用户界面。在一个典型的桌面环境中,这些软件提供给计算机用户窗口,文件夹,工具栏,壁纸、图标以及像拖放等图形化服务。不同桌面环境在设计和功能上的特性和理念,会赋予其与众不同的外观和使用体验。 + +???+ example "一些常见的DE" + - KDE (K Desktop Environment): 贴近Windows操作逻辑,有高度的自定义性与丰富主题 +  + - GNOME: 贴近macOS界面,优雅、简洁,有多样的扩展(可能需要安装某些扩展、软件包来获得正常桌面体验) +  + - COSMIC: 拥有优秀的窗口管理机制,自定义性强 +  + +## 平铺桌面 + +平铺桌面简单来说就是不允许窗口堆叠(如下图),只允许窗口铺展开摆放。 + + + +一套完整的平铺桌面主要由以下三部分组成。 + +### 窗口管理器 + +英文:Window Manager (WM) + +窗口管理器是在图形用户界面中,控制窗口位置与外观的软件(管理窗口的放置、配色等等)。 许多窗口管理器是为了桌面环境编写,与桌面环境一同发布的,例如被GNOME使用的Mutter。同时也存在不少独立的窗口管理器,如Openbox、Awesome等。大部分窗口管理器是针对Linux、BSD等操作系统设计编写的,用户可以通过选择窗口管理器更改电脑的图形用户界面外观和使用方式。 + +传送门:[ArchWiki](https://wiki.archlinuxcn.org/wiki/%E7%AA%97%E5%8F%A3%E7%AE%A1%E7%90%86%E5%99%A8) + +### 桌面外壳 + +英文: Desktop Shell + +狭义来看,桌面外壳是指在**平铺窗口管理器**中,提供用户界面的应用套件(例如GNOME预装应用等)。 + +???+ example "常见的桌面外壳" + - DMS (Dank Material Shell): 目前最广为人知的桌面外壳,采用Material You设计理念,现代而优雅。 +  + ??? info "安装教程" + 我们建议您使用[DankInstall](https://danklinux.com/docs/dankinstall),即其一键脚本。该脚本不仅提供了桌面外壳的安装,还内置了Hyprland/Niri的安装功能,省心省力。 + + ```bash + sudo -v && curl -fsSL https://install.danklinux.com | sh -s -- \ + -c hyprland -t kitty --include-deps dms-greeter --replace-configs-all -y + ``` + + - Noctalia: 操作顺滑,可自定义性高。 +  + [安装教程(英文)](https://docs.noctalia.dev/v5/getting-started/installation) + ... + +### Dotfiles + +???+info "特别注意" + 此处的dotfiles特指一种窗口管理器的配置集合,如end-4,dms等类似的配置集 + +与DE(桌面环境)不同,WM(窗口管理器)通常不会给出一个默认的开箱即用配置,通常为了满足审美和操作便捷程度,就需要自定义WM的配置文件,然而,这并不是一个很小的工作量,甚至要求一定的bash和lua基础。而部分人本着贡献社区的理念,开源了他们调整好的WM配置文件,这就是dotfiles。dotfiles可以大大减少配置WM的工作量,并且获得一个相对不错的主题效果。 + +目前,较有名的dotfiles有dms、end-4、ml4w。 diff --git a/docs/desktop/wm/hyprland.md b/docs/desktop/wm/hyprland.md index f879e24..dce537d 100644 --- a/docs/desktop/wm/hyprland.md +++ b/docs/desktop/wm/hyprland.md @@ -24,9 +24,9 @@ Hyprland拥有相对惊艳的视觉效果,并支持动态平铺窗口,能够 ## 安装 -在安装之前,我们建议您首先选择好适合的[桌面外壳](../../concepts/desktop/desktop_shell.md)。 +在安装之前,我们建议您首先选择好适合的桌面外壳。 我们建议您参照[Hyprland的官方Wiki(英文)](https://wiki.hypr.land/Getting-Started/Installation/)进行安装。在安装Hyprland后,您需要一并安装好桌面外壳。 ???+ tip "DMS福利" - 如果您选择DMS作为桌面外壳,您可以直接通过其一键脚本连带安装Hyprland。详情见[桌面外壳](../../concepts/desktop/desktop_shell.md)。
\ No newline at end of file + 如果您选择DMS作为桌面外壳,您可以直接通过其一键脚本连带安装Hyprland。详情见[桌面外壳](../desktop.md#_5)。
\ No newline at end of file diff --git a/docs/desktop/wm/niri.md b/docs/desktop/wm/niri.md index a040fd6..6d57101 100644 --- a/docs/desktop/wm/niri.md +++ b/docs/desktop/wm/niri.md @@ -15,12 +15,12 @@ Niri是一个以滚动平铺为核心理念的Wayland合成器。它用Rust编å† ## 安装 -在安装之前,我们建议您首先选择好适合的[桌面外壳](../../concepts/desktop/desktop_shell.md)。 +在安装之前,我们建议您首先选择好适合的桌面外壳。 具体安装步骤,请参考[Niri的快速入门](该指南中默认使用DMS作为桌面外壳,若您想要更换,请将其指令中的`dms`替换为其他选择)。 ???+ tip "DMS福利" - 如果您选择DMS作为桌面外壳,您也可以直接通过其一键脚本连带安装Niri。详情见[桌面外壳](../../concepts/desktop/desktop_shell.md)。 + 如果您选择DMS作为桌面外壳,您也可以直接通过其一键脚本连带安装Niri。详情见[桌面外壳](../desktop.md#_5)。 在安装Niri之后会出现一系列快捷键,我们建议您截图或拍照保存。由于Niri管理的窗口不适于直接使用鼠标拖动,因而您需要记忆一些关键快捷键来管理布局(当然,如果您有触控板,通过多指手势操作,不会部分快捷键也无妨)。 diff --git a/docs/getting-started/before-installing.md b/docs/getting-started/before-installing.md index 6a3d752..454d176 100644 --- a/docs/getting-started/before-installing.md +++ b/docs/getting-started/before-installing.md @@ -85,12 +85,7 @@ 我用某个发行版并不代表我必须使用某个桌面环境。与Windows不同,Linux的组件之间具有极其高的耦合度!您完全可以选用更加简单的发行版来体验您心仪的桌面环境。 - 在继续之前,我们建议您阅读并**分辨**以下概念章节: - - - [发行版](../concepts/linux/distro.md) - - [桌面环境](../concepts/desktop/de.md) - - [窗口管理器](../concepts/desktop/wm.md) - - [平铺式桌面](../concepts/desktop/tiling_desktop.md) + 在继续之前,我们建议您首先阅读[桌面](../desktop/desktop.md)章节。 ## 调配分区 diff --git a/docs/getting-started/purpose.md b/docs/getting-started/purpose.md index 56da430..314799f 100644 --- a/docs/getting-started/purpose.md +++ b/docs/getting-started/purpose.md @@ -63,12 +63,7 @@ 2. 你的配置效果很有可能不尽人意 3. 我们的教程并不全面,只是为入坑而写,如果需要更深入的知识推荐去[Arch Wiki](https://wiki.archlinux.org/title/Main_page) | [Arch Wiki 中文版](https://wiki.archlinuxcn.org/wiki/%E9%A6%96%E9%A1%B5)深造 -并且,您一定要明辨下面的几个概念: - - - [桌面环境 (DE)](../concepts/desktop/de.md) - - [发行版](../concepts/linux/distro.md) - - [窗口管理器 (WM)](../concepts/desktop/wm.md) - - 更新模式 +在继续之前,我们建议您首先阅读[桌面](../desktop/desktop.md)章节。 好啦,既然你已经准备好了,那我们就向下继续吧! @@ -132,12 +132,6 @@ nav: - concepts/package_managers/pacman.md - concepts/package_managers/flatpak.md - concepts/package_managers/appimage.md - - 桌面: - - concepts/desktop/de.md - - concepts/desktop/tiling_desktop.md - - concepts/desktop/wm.md - - concepts/desktop/desktop_shell.md - - concepts/desktop/dotfiles.md - 发行版: - distros/distro.md - Debian系: |
