aboutsummaryrefslogtreecommitdiff
path: root/docs/applications
diff options
context:
space:
mode:
authorhf_trixie <HFhaofan@outlook.com>2026-08-14 17:18:51 +0000
committerhf_trixie <HFhaofan@outlook.com>2026-08-14 17:43:18 +0000
commitba7b6fdec5962eaba5292a002d14251a65f0070e (patch)
treeccfcffef505677c56183403b4c4619522448d512 /docs/applications
parentfix: forgejo workflow (diff)
审查并修改_1
Diffstat (limited to 'docs/applications')
-rw-r--r--docs/applications/git.md49
-rw-r--r--docs/applications/openclaw.md4
-rw-r--r--docs/applications/programming/cpp.md88
-rw-r--r--docs/applications/programming/miniconda.md67
-rw-r--r--docs/applications/programming/python.md93
-rw-r--r--docs/applications/vim.md4
6 files changed, 55 insertions, 250 deletions
diff --git a/docs/applications/git.md b/docs/applications/git.md
index 8b8bf98..fa96b99 100644
--- a/docs/applications/git.md
+++ b/docs/applications/git.md
@@ -4,75 +4,76 @@
[官网](https://git-scm.com/)
-## 什么是Git
+## 概述
Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择。
-## Git的诞生
-自从Linus于1991年发布Linux的第一个版本并且公开源代码开始,每天都有来自全世界的程序员给Linux贡献代码,这就产生了一个问题,如果新添加的代码存在问题该如何回退到之前的版本,如何管理代码,如何决定那些代码进入最终版本,也就是版本控制的问题。在1991~2001年期间,Linux的维护工作的大量时间都花在了提交补丁和保存归档的繁琐事务上。
+## 使用方法
-在2002年Linux使用BitKeeper来管理版本,BitKeeper是一个闭源付费的软件,但其开发公司与Linux团队达成了协议,让Linux团队免费使用BitKeeper,但Linux的开发社区依旧对BitKeeper不满,所以社区试图破解BitKeeper的协议。被发现后,BitKeeper的开发公司收回了Linux团队的免费使用权,Linus在此情况下自己写出了Git并公开源代码发布。
+克隆仓库
-有趣的是,BitKeeper在2016以Apache2.0协议开源,不过其已经停止开发。
-
-## Git的使用
-
-**由于本文档面向新手所以只介绍Git的本地仓库版本管理,不涉及远程仓库的使用**
+```
+git clone http://example.com/example.git
+```
-- 使用以下命令创建初始化一个Git仓库
+创建初始化一个Git仓库
```
-#mkdir用于创建文件夹
+# mkdir用于创建文件夹
mkdir 文件夹名称
-#cd用于切换目录
+# cd用于切换目录
cd 文件夹名称
git init
```
-- 使用以下命令将修改的文件推送到本地仓库创建一个版本
+将修改的文件推送到仓库创建一个版本
```
-#git add命令会把文件放入暂存区
+# git add命令会把文件放入暂存区
git add 修改的文件
-#您可以不加-m参数,Git会打开一个图形界面让您填写信息
-#git commit 将缓存区的文件放入本地仓库
+# 您可以不加-m参数,Git会打开一个图形界面让您填写信息
+# git commit 将缓存区的文件放入本地仓库
git commit -m "这一次提交的介绍"
```
-- 使用使用以下命令查看所有版本
+查看所有版本
```
git log
-#如果您想要一个更加简洁的界面
+# 如果您想要一个更加简洁的界面
git log --oneline
```
-- 使用以下命令回退版本
+回退版本
```
-#哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的
-#git reflog可以查看您所有的操作,包括您删除的版本的哈希值
-#git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件
-#更推荐您使用默认参数
+# 哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的
+# git reflog可以查看您所有的操作,包括您删除的版本的哈希值
+# git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件
+# 更推荐您使用默认参数
git reset 版本的哈希值
```
-## 视频教程
+## 关于更多
+
+由于我们的专门性限制,我们建议您去其他专门教程深入的的学习git。
+[Pro Git Book](https://git-scm.com/book/zh/v2)
+[菜鸟教程](https://www.runoob.com/git/git-tutorial.html)
[一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/)
[蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/)
[Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/)
diff --git a/docs/applications/openclaw.md b/docs/applications/openclaw.md
index 726da6c..b6ce94e 100644
--- a/docs/applications/openclaw.md
+++ b/docs/applications/openclaw.md
@@ -1,5 +1,7 @@
# OpenClaw
+## 概述
+
[OpenClaw](https://openclaws.io/zh/)是一个开源的AI智能体框架,相当于一只“大手”,能够帮助使用者完成具体任务。
## 安装
@@ -44,4 +46,4 @@ npm i -g openclaw
pnpm add -g openclaw
```
-之后,运行`openclaw onboard`来配置即可。 \ No newline at end of file
+之后,运行`openclaw onboard`来配置即可。
diff --git a/docs/applications/programming/cpp.md b/docs/applications/programming/cpp.md
index 22b0b0f..5f99a01 100644
--- a/docs/applications/programming/cpp.md
+++ b/docs/applications/programming/cpp.md
@@ -1,17 +1,12 @@
-# C++
+# C++开发套件
-## Windows 的配置灾难
+## g++
-众所周知,在windows上安装VSCode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情。
-因为 Windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利。
+### 概述
-如果你选择了 Linux ,那么恭喜你将获得一个非常便利而自然的开发环境。
-接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译。
+g++是GNU项目开发的C++编译器,属于GNU编译器套件(GCC)的核心组成部分。它通过命令行运行,能把C++源代码文件编译、链接并转换成计算机可以直接运行的二进制可执行程序。
-## g++ 安装
-
-g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)。
-安装非常简单,取决于你使用什么包管理器。
+### 安装
- Debian 系(Ubuntu, Mint, Debian)
@@ -31,77 +26,8 @@ sudo dnf install g++ -y
sudo pacman -S g++ -y
```
-- 查看版本
-
-```bash
-g++ -v
-```
-
-参考输出:
-❯ g++ -v
-
-```shell
-Using built-in specs.
-COLLECT_GCC=g++
-COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-pc-linux-gnu/16/lto-wrapper
-Target: x86_64-pc-linux-gnu
-Configured with: ../gcc/configure --enable-languages=ada,c,c++,d,fortran,go,lto,m2,objc,obj-c++,rust,cobol --enable-bootstrap --prefix=/usr --libdir=/usr/lib --libexecdir=/usr/lib --mandir=/usr/share/man --infodi
-r=/usr/share/info --with-bugurl=https://gitlab.archlinux.org/archlinux/packaging/packages/gcc/-/issues --with-build-config=bootstrap-lto --with-gcc-major-version-only --with-linker-hash-style=gnu --with-system-zl
-ib --enable-cet=auto --enable-checking=release --enable-clocale=gnu --enable-default-pie --enable-default-ssp --enable-gnu-indirect-function --enable-gnu-unique-object --enable-libstdcxx-backtrace --enable-link-s
-erialization=1 --enable-linker-build-id --enable-lto --enable-multilib --enable-plugin --enable-shared --enable-threads=posix --disable-fixincludes --disable-libssp --disable-libstdcxx-pch --disable-werror
-Thread model: posix
-Supported LTO compression algorithms: zlib zstd
-gcc version 16.1.1 20260725 (GCC)
-```
-
+### 使用
-## 编写一个程序
-
-- 创建一个cpp文件(以cpp为后缀)
-
-```bash
-touch hello.cpp
-```
-
-- 使用你喜欢的编辑器打开
-
-```bash
-vim hello.cpp
-# 如果你不会用 vim 就用nano
-# nano hello.cpp
-```
-
-- 写入下面的内容
-
-```cpp
-#include <iostream>
-
-int main() {
- std::cout << "hello world" << std::endl;
- return 0;
-}
-```
-
-- 保存并退出
-
-- 编译成二进制文件
-
-```bash
-g++ hello.cpp -o hello
-```
-
-> -o <file> Place the output into <file>.
-这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名。
-
-写法是 g++ 源文件路径 -o 二进制文件。
-
-- 运行程序
-
-```bash
-./hello # ./ 表示当前目录, 后面直接跟上文件名, 表示运行该二进制文件
-```
+请参考`man g++`。
-这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个C++程序。
-现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了。
-祝贺你。
diff --git a/docs/applications/programming/miniconda.md b/docs/applications/programming/miniconda.md
index 72ba4f9..a256a8d 100644
--- a/docs/applications/programming/miniconda.md
+++ b/docs/applications/programming/miniconda.md
@@ -1,84 +1,41 @@
# Miniconda
-## 什么是Miniconda
+## 概述
-相信不少人是因为自己需要学习人工智能,跑云端训练才学Linux
-所以我在这里写了相关的内容,希望可以帮助到大家。
+Miniconda的上游Anaconda是一个**Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。但Anaconda过于臃肿,因此官方也推出了最小化版本,也就是Miniconda。
-Anaconda 是一个 **Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。
-但是 Anaconda 预装太多东西,甚至达到几个G的体积,所以官方也推出了mini版 —— Miniconda。
+Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,让用户按需安装。
-Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,比如numpy之类的。
-它的设计理念就是让用户按需安装,我是比较同意这个理念的,个人也一直在用Miniconda。
+## 安装
-**下面的教程适用于Linux环境(包括原生Linux,WSL,虚拟机等)**
-
-## 安装步骤
-
-- 下载官方安装脚本
-访问官方下载链接(<https://www.anaconda.com/download/success)>
-
-选择 Linux,选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)。
+下载官方安装脚本,访问[官方下载链接](https://www.anaconda.com/download/success),选择 Linux,选择右边Miniconda,架构请自行查询,一般情况为x86。
![Anaconda安装脚本下载](../../img/miniconda/pic1.png)
-- 使用bash执行脚本
+使用bash执行脚本
```bash
-# 首先需要把你的 Miniconda脚本放到Linux系统可以访问的地方
-
-# 然后执行这个安装脚本
bash Miniconda3-latest-Linux-x86_64.sh
```
-然后中间有引导,保持默认即可,叫你输yes你就yes回车。安装完之后重启终端或者使用下面的命令重新加载环境变量。
+选项保持默认即可。安装完之后重启终端或者使用下面的命令重新加载环境变量。
```bash
source ~/.bashrc
```
-- 配置镜像源
-
-很多同志连官方源不太流畅,推荐换成中科大。
+## 镜像源
-访问这个链接进行配置即可: <https://mirrors.ustc.edu.cn/help/anaconda.html>
+访问这个链接进行配置即可(中科大源): <https://mirrors.ustc.edu.cn/help/anaconda.html>
-一般是创建一个 ~/.condarc 文件然后把 channels 开头的那些东西复制粘贴进去即可。
+创建一个`~/.condarc`文件然后把channels开头的文本复制粘贴进去即可。
```bash
# 创建配置文件
touch ~/.condarc
-# 然后编辑
+# 编辑配置文件
nano ~/.condarc
```
-- 配置pip源
+此外,还需要配置pip源,建议访问这个网址进行配置(中科大源) <https://mirrors.ustc.edu.cn/help/pypi.html>
-我们很多时候还是使用 pip 来安装的,所以这里也需要配置一下pip的镜像源
-
-访问这个网址进行配置 <https://mirrors.ustc.edu.cn/help/pypi.html>
-**只需要执行设为默认的命令即可**, 剩下的不需要配置。
-
-- 创建环境测试
-
-```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/docs/applications/programming/python.md b/docs/applications/programming/python.md
index 1180d39..bbc0af9 100644
--- a/docs/applications/programming/python.md
+++ b/docs/applications/programming/python.md
@@ -1,93 +1,10 @@
-# Python
+# Python开发套件
-## 安装 Python
+## Python3
-Linux 上装Python还是非常轻松的,因为不用装,大部分发行版自带。
+### 安装
-Linux 里面一般都是 `python3`。
-如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。
+无须安装,发行版自带。
-- Debian: `sudo apt install python-is-python3 -y`
-- Fedora: `sudo dnf install python-is-python3 -y`
+Linux里面一般以`python3`命令使用Python。
-## 编写第一个脚本
-
-- 创建一个脚本
-
-```bash
-touch hello.py
-```
-
-- 写入内容
-
-```bash
-echo "print('hello python')" > hello.py
-```
-
-- 查看内容
-
-```bash
-cat hello.py
-
-# 会输出
-# print('hello python')
-```
-
-## 运行
-
-有很多Windows来的同志不知道怎么运行,但实际上非常简单。
-
-用法:
-
-```bash
-# python <要运行的脚本路径>
-
-python hello.py
-```
-
-这样你就成功运行起 Python 脚本了。
-实际上就是给 Python 指定需要运行的文件, 就这么简单。
-
-恭喜你在Linux上成功运行了Python脚本。
-
-## 编辑器
-
-- 如果你使用WSL, 推荐使用 VSCode 的 WSL 插件来连接写代码, 当然勇敢牛牛可以尝试 LazyVim 写代码
-- 如果你使用原生 Linux, 还是这两种推荐haha
-
-VSCode 资料很多, 我也用的比较少,可以直接上Bilibili搜索VSCode Python环境搭建
-[LazyVim入坑视频](https://www.bilibili.com/video/BV1TJCvYFE2T?t=286.5)
-
-## 库
-
-Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。但在Linux下,`pip`不一定会随着Python预装,因此需要使用包管理器安装。
-
-- Debian: `sudo apt install python3-pip`
-- Fedora: `sudo dnf install python3-pip`
-- Arch: `sudo pacman -S python-pip`
-
-!!! warning "系统依赖"
- 使用Pip安装部分库时,可能会出现如下警告:
- ```
- error: externally-managed-environment
-
- × This environment is externally managed
- ╰─> To install Python packages system-wide, try 'pacman -S
- python-xyz', where xyz is the package you are trying to
- install.
-
- If you wish to install a non-Arch-packaged Python package,
- create a virtual environment using 'python -m venv path/to/venv'.
- Then use path/to/venv/bin/python and path/to/venv/bin/pip.
-
- If you wish to install a non-Arch packaged Python application,
- it may be easiest to use 'pipx install xyz', which will manage a
- virtual environment for you. Make sure you have python-pipx
- installed via pacman.
-
- note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
- hint: See PEP 668 for the detailed specification.
- ```
- 由于系统的部分组件依赖Python的依赖,因而外来库可能破坏系统本身的依赖关系。
-
- 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。 \ No newline at end of file
diff --git a/docs/applications/vim.md b/docs/applications/vim.md
index cd494cf..99c68f2 100644
--- a/docs/applications/vim.md
+++ b/docs/applications/vim.md
@@ -1,6 +1,8 @@
# Vim
-`vim` 是一款终端文本编辑器, 几乎所有的Linux发行版都会预装。
+## 概述
+
+`vim` 是一款i轻量高效的终端文本编辑器, 几乎所有的Linux发行版都会预装。
第一次使用vim的人,最大的感受一定是: 反人类。
Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的)。