aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFangcat <f20091219@outlook.com>2026-07-28 10:54:06 +0000
committerGitHub <noreply@github.com>2026-07-28 10:54:06 +0000
commitfb06a5d9e6d988e3738eb0ab735fb0fbe249def0 (patch)
tree8991c44be019e485b683b15bdec2bb45508c6437
parent微调 (diff)
parentAdd the package manual installation guidance (diff)
Merge pull request #12 from IridiumNan/main
Add Two Post and provide manual install software guidance
-rw-r--r--CONTRIBUTE.md11
-rw-r--r--docs/getting-started/applications.md25
-rw-r--r--pending/fedora_repo/fedora_repo.md73
-rw-r--r--pending/fedora_repo/pic1.pngbin0 -> 32868 bytes
-rw-r--r--pending/fedora_repo/pic2.pngbin0 -> 185318 bytes
-rw-r--r--pending/fedora_repo/pic3.pngbin0 -> 183701 bytes
-rw-r--r--pending/fedora_repo/pic4.pngbin0 -> 129201 bytes
-rw-r--r--pending/miniconda_config/miniconda.md85
-rw-r--r--pending/miniconda_config/pic1.pngbin0 -> 94185 bytes
9 files changed, 189 insertions, 5 deletions
diff --git a/CONTRIBUTE.md b/CONTRIBUTE.md
index 5578537..4380585 100644
--- a/CONTRIBUTE.md
+++ b/CONTRIBUTE.md
@@ -18,15 +18,14 @@ xxxxxx
```
-
若您的内容被退回,建议您仔细阅读退回原因。如果经过修改没有问题,我们允许您再次提交。
### 我们不建议您贡献的内容
- - 与Linux无关的内容
- - 专业性过高的内容
- - 偏颇/太过不常见的内容(如果值得商讨您也可以贡献)
- - 由AIGC生成的内容(经由人工审核且确认无误的情况除外)
+- 与Linux无关的内容
+- 专业性过高的内容
+- 偏颇/太过不常见的内容(如果值得商讨您也可以贡献)
+- 由AIGC生成的内容(经由人工审核且确认无误的情况除外)
## PR贡献的工作流?
@@ -37,6 +36,7 @@ xxxxxx
```
pip install -r requirements.txt
```
+
(注:为防止python3安装的依赖污染系统环境导致系统不稳定,建议创建venv虚拟环境)
我们的文章全部位于/docs目录下。如果您添加了之前不存在的章节,请您修改`mkdocs.yml`下的`nav`(照葫芦画瓢就行)来使得您的内容显示在侧边栏导航。
@@ -47,6 +47,7 @@ pip install -r requirements.txt
mkdocs serve
```
+> 或者你可以直接在 `pending` 目录下新建一个目录,然后存放你的文档,管理员会将它放到正确的地方(如果审核通过的话)
## 贡献时要符合什么规定?
diff --git a/docs/getting-started/applications.md b/docs/getting-started/applications.md
index b329ac3..9d22aa1 100644
--- a/docs/getting-started/applications.md
+++ b/docs/getting-started/applications.md
@@ -4,6 +4,31 @@
或者,您也可以通过发行版自带应用商店或第三方应用商店(如[星火应用商店](https://www.spark-app.store/))进行下载。
+## 安装注意事项
+
+> [!TIP]
+> 请选择适用于你的发行版的软件安装包
+> Debian 系列: debian, mint, ubuntu, kubuntu等 => `deb包`
+> RHEL 系列: rhel, fedora, rocky等 => `rpm包`
+>
+> 某些发行版支持双击安装包进行安装, 使用文件管理器和鼠标即可
+
+- Debian 系列命令行安装
+apt 装 deb 包
+
+```bash
+# 这里比如说我下载了一个 Wechat
+sudo apt install ./WeChatLinux_x86_64.deb -y
+# 必须要写 ./ 说明是当前目录的
+```
+
+- RHEL 系列命令行安装
+dnf 装 rpm 包
+
+```bash
+sudo dnf install ./WeChatLinux_x86_64.rpm -y
+```
+
## 聊天应用
### QQ
diff --git a/pending/fedora_repo/fedora_repo.md b/pending/fedora_repo/fedora_repo.md
new file mode 100644
index 0000000..471fe72
--- /dev/null
+++ b/pending/fedora_repo/fedora_repo.md
@@ -0,0 +1,73 @@
+# fedora 换镜像源教程
+
+对于新手来说,镜像源一直都是一个绕不开的话题,因为没有人教我们:
+
+- 什么是镜像源 ?
+- 为什么要换源 ?
+- 别人给我一个镜像站网址, 我怎么换源 ?
+
+所以接下来我希望简单谈谈我的理解,并教大家如何配置fedora的国内镜像源
+
+---
+
+## 什么是镜像源
+
+Linux 的软件管理依托于**包管理器**(package manager)。
+当你使用 `apt`, `dnf`, `pacman` 之类的包管理器下载软件的时候,就是包管理器向存储核心软件包的服务器发送请求,之后将所需的软件包返回给你(也就是客户端)
+所以过程就是, 你 敲下 `sudo apt install htop -y` 之后, 包管理器向服务器发送请求要 htop 的 deb 包。然后包管理器拿到包之后进行安装软件.
+
+而一般而言,每一个发行版都有自己的软件包服务器,这些官方服务器的软件是经过测试人员测试然后放到仓库当中供使用者下载。
+但是,几乎所有的官方服务器,都在国外(我不知道有没有国内的, 但是印象中应该没有).
+这个时候由于某些原因,**很多地方都无法正常通过官方服务器下载软件。**
+这个时候就有人提议将这些软件仓库复制到各个地区的服务器,来解决下载不顺利的问题。
+
+也就是说,**镜像源就是一些定期同步复制官方源的,用于解决下载问题的软件源**
+
+---
+
+## 为什么要换源
+
+最大的原因就是网络问题,因为我们有国家级别的防火墙。
+导致我们连接国外服务器要么超时,要么速度像乌龟在爬
+
+所以**选用可靠的国内镜像源是必须的**(如果你没有魔法的话)
+
+---
+
+## 怎么换
+
+这里举fedora的例子,我们使用 [TUNA](https://mirrors.tuna.tsinghua.edu.cn/) (也就是清华维护的镜像站)
+
+- **访问镜像站**
+ 首先打开镜像站, 也就是访问 => <https://mirrors.tuna.tsinghua.edu.cn/>
+
+- **搜索发行版**
+ 这个时候我们在搜索框里面输入 fedora
+
+然后就会出现筛选结果, 这个时候我们不要直接点fedora, 而是点旁边的那个 `?` (也就是tuna给的换源官方手册)
+
+![tuna搜索界面](./pic1.png)
+
+- **命令替换**
+
+之后我们直接复制命令替换的那个内容
+
+![命令替换](./pic2.png)
+
+注意我们这里复制的是使用 root 进行操作的指令
+如果直接用,大概率会有 Permission denied 的报错
+
+这个时候我们别慌, 在前面先加上一个 `sudo` (记得是 sudo 然后空一个再粘贴命令)就可以了, 当然tuna也考虑到了这一点, 所以你直接打开上面的 是否使用sudo的开关然后再复制也可以
+
+- 预先打勾sudo(**如果你使用上面的方法手动加了跳过这个步骤**)
+ ![启动sudo](./pic3.png)
+
+> 顺便说一下, sudo 的意思是 super user do, 就是用超级管理员执行这个命令
+
+替换完成之后, 我们可以直接进行系统的**软件更新,见证魔法** => 我刚开始用的时候,也感觉直接更新所有软件是一个很酷的事情
+
+```bash
+sudo dnf update # 检查并更新
+```
+
+ok恭喜你学会了如何换源,同样的方法可以用在其他的发行版上,也是搜发行版的名字然后点问号进去换
diff --git a/pending/fedora_repo/pic1.png b/pending/fedora_repo/pic1.png
new file mode 100644
index 0000000..05cb2b8
--- /dev/null
+++ b/pending/fedora_repo/pic1.png
Binary files differ
diff --git a/pending/fedora_repo/pic2.png b/pending/fedora_repo/pic2.png
new file mode 100644
index 0000000..94c8fc4
--- /dev/null
+++ b/pending/fedora_repo/pic2.png
Binary files differ
diff --git a/pending/fedora_repo/pic3.png b/pending/fedora_repo/pic3.png
new file mode 100644
index 0000000..8c8d821
--- /dev/null
+++ b/pending/fedora_repo/pic3.png
Binary files differ
diff --git a/pending/fedora_repo/pic4.png b/pending/fedora_repo/pic4.png
new file mode 100644
index 0000000..91904b2
--- /dev/null
+++ b/pending/fedora_repo/pic4.png
Binary files differ
diff --git a/pending/miniconda_config/miniconda.md b/pending/miniconda_config/miniconda.md
new file mode 100644
index 0000000..f65a3be
--- /dev/null
+++ b/pending/miniconda_config/miniconda.md
@@ -0,0 +1,85 @@
+# Miniconda 在 Linux 下的安装和配置
+
+## 什么是Miniconda
+
+相信不少人是因为自己需要学习人工智能,跑云端训练才学linux
+所以我在这里写了相关的内容,希望可以帮助到大家
+
+Anaconda 是一个 **python的管理器** => 让你在同一个操作系统上**拥有多个共存的python环境,按需使用和激活**
+但是 Anaconda 预装太多东西,甚至达到几个G的体积,所以官方也推出了mini版 => miniconda
+
+miniconda 跟anaconda的最大区别就是砍掉了很多预装的东西,比如numpy之类的
+它的设计理念就是让用户按需安装,我是比较同意这个理念的,个人也一直在用miniconda
+
+**下面的教程适用于Linux环境(包括原生Linux,wsl,虚拟机等)**
+
+## 安装步骤
+
+- 下载官方安装脚本
+访问官方下载链接 => <https://www.anaconda.com/download/success>
+
+选择 Linux
+选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)
+
+![anaconda安装脚本下载](./pic1.png)
+
+- 使用bash执行脚本
+
+```bash
+# 首先需要把你的 Miniconda脚本放到Linux系统可以访问的地方
+
+# 然后执行这个安装脚本
+bash Miniconda3-latest-Linux-x86_64.sh
+```
+
+然后中间有引导,保持默认即可,叫你输yes你就yes回车
+安装完之后重启终端或者使用下面的命令重新加载环境变量
+
+```bash
+source ~/.bashrc
+```
+
+- 配置镜像源
+很多同志连官方源不太流畅,推荐换成清华镜像源
+
+访问这个链接进行配置即可 => <https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/>
+
+一般是创建一个 ~/.condarc 文件然后把 channels 开头的那些东西复制粘贴进去即可
+
+```bash
+# 创建配置文件
+touch ~/.condarc
+# 然后编辑
+nano ~/.condarc
+```
+
+- 配置pip源
+
+我们很多时候还是使用 pip 来安装的,所以这里也需要配置一下pip的镜像源
+
+访问这个网址进行配置 => <https://mirrors.tuna.tsinghua.edu.cn/help/pypi/>
+**只需要执行设为默认的命令即可**, 剩下的不需要配置
+
+- 创建环境测试
+
+```bash
+# 这边的 -n 后面的是虚拟环境名, 这里既是 test-env. 然后后面可以指定python版本,根据实验需要来
+conda create -n test-env python=3.12
+```
+
+- pip安装测试
+
+```bash
+# 先激活刚才创建的虚拟环境
+conda activate test-env
+
+# 然后装个 numpy 试试
+pip install numpy
+```
+
+- 查看当前环境
+
+```bash
+conda env list
+# 列出所有环境, 如果是当前的环境, 会标有 *
+```
diff --git a/pending/miniconda_config/pic1.png b/pending/miniconda_config/pic1.png
new file mode 100644
index 0000000..57d2f14
--- /dev/null
+++ b/pending/miniconda_config/pic1.png
Binary files differ