From 3042be9d1f65152978021ded3b83feacc8273f37 Mon Sep 17 00:00:00 2001
From: MarkLi <1060470524@qq.com>
Date: Thu, 23 Nov 2023 22:28:50 +0800
Subject: [PATCH] docs: add ubuntukylin help

---
 docs/ubuntukylin.md | 92 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 docs/ubuntukylin.md

diff --git a/docs/ubuntukylin.md b/docs/ubuntukylin.md
new file mode 100644
index 0000000..3d67d66
--- /dev/null
+++ b/docs/ubuntukylin.md
@@ -0,0 +1,92 @@
+---
+title: UbuntuKylin 镜像使用帮助
+sidebar_label: UbuntuKylin
+---
+
+## UbuntuKylin 简介与软件管理
+
+Ubuntu Kylin 是一款针对中文用户的 Linux 发行版，基于 Ubuntu 开发。它的目标是提供用户友好的界面以及满足特定需求的应用程序，并与国际开源社区合作开发。Ubuntu Kylin 自诞生以来已经历了多次版本更新，并且在中国及其他国家和地区拥有相当数量的支持者。这款操作系统集成了许多流行的应用程序和服务，包括 WPS Office 办公套件、搜狗输入法等，并且兼容大部分 Windows 应用程序。
+
+UbuntuKylin 使用软件包管理工具 `APT` 来管理 DEB 软件包。具体来说，Ubuntu Kylin通过修改 `/etc/apt/sources.list` 配置文件来管理系统软件源。一般情况下，用户可直接将该配置文件中的默认源地址 <http://archive.ubuntukylin.com/> 替换为本软件镜像站。
+
+## UbuntuKylin 软件源替换
+
+:::caution
+**为了及时地获得安全更新，防止因软件源更新而导致的安全补丁滞后问题，我们推荐直接使用官方安全更新软件源。**
+:::
+
+:::caution
+**为避免软件源配置文件替换后产生问题，请先将系统自带的软件源配置文件进行备份，然后进行下列操作。**
+:::
+
+1. 通过以下操作备份软件源配置文件
+
+```shell varcode
+[ ] (root) 是否为 root 用户
+---
+const SUDO = !root ? 'sudo ' : '';
+---
+${SUDO} cp /etc/apt/sources.list /etc/apt/sources.list.bak
+```
+
+2. 根据个人喜欢做出选择，并将如下软件源配置内容拷贝至 `/etc/apt/sources.list`，并进行保存。
+
+```bash varcode
+[ ] (version) { jammy:22.04 LTS, lunar:23.04, Mantic:23.10, focal:20.04 LTS} UbuntuKylin 版本
+[ ] (src) 启用源码镜像
+---
+const SRC_PREFIX = src ? "" : "# ";
+---
+deb ${_http}://${_domain}/ubuntukylin/ ${version} main restricted universe multiverse
+${SRC_PREFIX}deb-src ${_http}://${_domain}/ubuntukylin/ ${version} main restricted universe multiverse
+deb ${_http}://${_domain}/ubuntukylin/ ${version}-updates main restricted universe multiverse
+${SRC_PREFIX}deb-src ${_http}://${_domain}/ubuntukylin/ ${version}-updates main restricted universe multiverse
+
+```
+
+3. 通过如下命令更新软件。
+
+```shell varcode
+[ ] (root) 是否为 root 用户
+---
+const SUDO = !root ? 'sudo ' : '';
+---
+${SUDO}apt update
+```
+
+## 一键换源
+
+:::caution
+本方法仅适用于从官方源更换到本站源，如果您已经换过了源，请勿使用下列命令。
+:::
+
+使用 `sed` 命令将软件源配置文件中的默认源地址 <http://archive.ubuntukylin.com/> 直接替换为当前镜像源站。
+
+```shell varcode
+[ ] (root) 是否为 root 用户
+---
+const SUDO = !root ? 'sudo ' : '';
+---
+${SUDO}sed -i.bak 's|http://archive.ubuntukylin.com|${_http}://${_domain}|g' /etc/apt/sources.list
+${SUDO}apt update
+```
+
+<!-- 本方法没有替换 security 源，如果想要替换 security 源可以执行以下命令：
+```shell varcode
+[ ] (root) 是否为 root 用户
+---
+const SUDO = !root ? 'sudo ' : '';
+---
+${SUDO}sed -i.bak 's/security.ubuntu.com/${_domain}/g' /etc/apt/sources.list
+``` 
+
+## 注意事项
+
+- 软件包架构说明
+
+本镜像仅包含 x86 与 x64 架构处理器的软件包，在 ARM(arm64, armhf)、PowerPC(ppc64el)、RISC-V(riscv64) 以及 s390x 等架构的设备上，请使用 ubuntu-ports 镜像。
+
+## 引用
+
+[^1] [中科大镜像源使用帮助](https://mirrors.ustc.edu.cn/help/ubuntu.html)  
+-->
\ No newline at end of file
-- 
Gitee