diff options
| author | Fangcat_Dev <f20091219@outlook.com> | 2026-08-15 07:28:58 +0000 |
|---|---|---|
| committer | Fangcat_Dev <f20091219@outlook.com> | 2026-08-15 07:28:58 +0000 |
| commit | b90296180a70c510c00ef81106d4141e567f80ff (patch) | |
| tree | 9bbf0f1d28cc9dcdcda056734242c6c86508d013 | |
| parent | Merge pull request 'docs: advanced' (#8) from Fangcat_Dev/linux-handbook:main into main (diff) | |
| parent | Merge branch 'main' into 审查修改部分越界内容 (diff) | |
Merge pull request '审查修改部分越界内容' (#6) from 审查修改部分越界内容 into main
Reviewed-on: https://codeberg.org/LinuxCabin/linux-handbook/pulls/6
Reviewed-by: Fangcat_Dev <f20091219@outlook.com>
| -rw-r--r-- | docs/applications/emacs.md | 85 | ||||
| -rw-r--r-- | docs/applications/fish.md | 89 | ||||
| -rw-r--r-- | docs/applications/git.md | 92 | ||||
| -rw-r--r-- | docs/applications/openclaw.md | 4 | ||||
| -rw-r--r-- | docs/applications/programming/cpp.md | 88 | ||||
| -rw-r--r-- | docs/applications/programming/miniconda.md | 68 | ||||
| -rw-r--r-- | docs/applications/programming/python.md | 69 | ||||
| -rw-r--r-- | docs/applications/ssh.md | 128 | ||||
| -rw-r--r-- | docs/applications/vim.md | 103 | ||||
| -rw-r--r-- | docs/applications/zsh.md | 22 |
10 files changed, 260 insertions, 488 deletions
diff --git a/docs/applications/emacs.md b/docs/applications/emacs.md index f78df2b..e5a39b7 100644 --- a/docs/applications/emacs.md +++ b/docs/applications/emacs.md @@ -2,23 +2,26 @@  -[官方文档](https://www.gnu.org/software/emacs/manual/emacs.html) - -[官网](https://www.gnu.org/software/emacs/) - -**Emacs的配置文件位于`~/.emacs.d/`或`~/.config/emacs`(更老的Emacs版本使用`~/.emacs`作为配置目录),其名称为init.el,使用Elisp作为配置语言**。 - -## 梗概 +## 概述 Emacs是一个[自由](https://www.gnu.org/philosophy/free-sw.html)的编辑器,采用[GPL-v3](https://www.gnu.org/licenses/gpl-3.0.en.html)发布,采用Elisp作为配置语言,Emacs功能强大(包括但不限于发邮件,使用irc聊天,阅读新闻和RSS订阅,玩俄罗斯方块),常被与vim/nvim比较,最早由Richard Stallman编写发布,Emacs是[自由软件运动](https://www.gnu.org/)的一部分。 -**注:本文档使用Emacs编辑**。 - ## 安装 -- Debian系: `sudo apt install emacs` -- 红帽系: `sudo dnf install emacs` -- Arch系: `sudo pacman -S emacs` +Debian系: +```bash +sudo apt install emacs +``` + +红帽系: +```bash +sudo dnf install emacs +``` + +Arch系: +```bash +sudo pacman -S emacs +``` ## 使用(默认快捷键) @@ -26,39 +29,31 @@ Emacs是一个[自由](https://www.gnu.org/philosophy/free-sw.html)的编辑器, **由于Emacs的功能关于繁杂无法将所有快捷键列出,强烈建议您阅读官方文档**。 -- C-x C-c 退出Emacs -- M-x 输入命令 -- C-x C-s 保存文件 -- C-s 搜索关键词 -- C-p/n/b/f 使光标上下左右的移动 -- C-a/e 移动到行头或行尾 -- M-</> 移动到文件头或文件尾 -- C-k 删除光标后面的所有文本 -- C-/ 撤销操作(C-x u和C-_也可已,详情见官方文档9.4) -- C-x C-f 跳转到另一个文件(旧文件会被放入一个buffer中) -- C-x b 切换到另一个Buffer -- C-x C-b 打开Buffer列表(?获得帮助) -- C-x o 切换到另一个Window -- C-x 0 关闭Window -- C-x k 关闭一个Buffer -- C-h C-f Emacs常见问题解答 -- C-h r 官方手册(需要安装info) -- C-h t 官方快速指南 - -## 配置 - -**由于Emacs的配置过于纷杂繁复,不适合Linux新手,所以只做文档与视频的推荐**。 - -1.[Emacs轻奢之路](https://www.bilibili.com/video/BV1T64y1R7EL/) -2.[21天学会Emacs 2022年版本](https://www.bilibili.com/video/BV12P4y1j7EL/) -3.[Emacs高手修炼手册](https://www.bilibili.com/video/BV13g4y167Zn/) -4.[专业 Emacs 入门教程](https://www.zhihu.com/column/c_1440829147212279808) - -## 尾言 +`C-x C-c` 退出Emacs +`M-x` 输入命令 +`C-x C-s` 保存文件 +`C-s` 搜索关键词 +`C-p/n/b/f` 使光标上下左右的移动 +`C-a/e` 移动到行头或行尾 +`M-</>` 移动到文件头或文件尾 +`C-k` 删除光标后面的所有文本 +`C-/` 撤销操作(C-x u和C-_也可已,详情见官方文档9.4) +`C-x C-f` 跳转到另一个文件(旧文件会被放入一个buffer中) +`C-x b` 切换到另一个Buffer +`C-x C-b` 打开Buffer列表(?获得帮助) +`C-x o` 切换到另一个Window +`C-x 0` 关闭Window +`C-x k` 关闭一个Buffer +`C-h C-f` Emacs常见问题解答 +`C-h r` 官方手册(需要安装info) +`C-h t` 官方快速指南 -Emacs的上手并不简单,但当您上手并习惯它后它将是您最好的编程伙伴,在您上手后我推荐您尝试使用[Org-mode](https://orgmode.org/)编写文档管理日程安排,也推荐您使用Emacs的更多功能,愿Emacs可以成为您一生的编辑器。 +## 关于更多 -## 相关网站 +受限于我们的专门性,我们建议您到其他专门性教程进行学习。 -- [Emacs-china](https://emacs-china.org/) -- [Emacs官网](https://www.gnu.org/software/emacs/)
\ No newline at end of file +1. [Emacs轻奢之路](https://www.bilibili.com/video/BV1T64y1R7EL/) +2. [21天学会Emacs 2022年版本](https://www.bilibili.com/video/BV12P4y1j7EL/) +3. [Emacs高手修炼手册](https://www.bilibili.com/video/BV13g4y167Zn/) +4. [专业 Emacs 入门教程](https://www.zhihu.com/column/c_1440829147212279808) +5. [官方文档](https://www.gnu.org/software/emacs/manual/emacs.html) diff --git a/docs/applications/fish.md b/docs/applications/fish.md index dd47f9f..1b31ff1 100644 --- a/docs/applications/fish.md +++ b/docs/applications/fish.md @@ -2,73 +2,74 @@  -[官网](https://fishshell.com/) - -[官方文档](https://fishshell.com/docs/current/index.html) - -[Fish语言教程](https://fishshell.com/docs/current/tutorial.html) - -**默认配置文件在`~/.config/fish`下,其名称为`config.fish`** - ## 概述 -Fish是一个[Shell](https://hb.linuxcabin.top/concepts/linux/shell/),它有着功能丰富,开箱即用,脚本编写简便的特点。 +Fish是一个[Shell](../concepts/linux/shell.md),它有着功能丰富,开箱即用,脚本编写简便的特点。 **但它不兼容[POSIX标准](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html),这意味着Bash无法运行Fish的脚本,反之亦然**。 ## 安装 -- Debian系: `sudo apt install fish` -- 红帽系: `sudo dnf install fish` -- Arch系: `sudo pacman -S fish` +- Debian系: +```bash +sudo apt install fish +``` -## 使用 +- 红帽系: +```bash +sudo dnf install fish +``` -- 进入Fish: - - `fish` +- Arch系: +```bash +sudo pacman -S fish +``` -- 退出fish - - `exit` +## 使用 + +将Fish作为默认Shell -- 将Fish作为默认Shell - - 1.将Fish加入Slhel列表 - - `command -v fish | sudo tee -a /etc/shells` - - 2.更改默认Shell - - `chsh -s "$(command -v fish)"` +```bash +# 将Fish加入Shell列表 +command -v fish | sudo tee -a /etc/shells -- 当您在Fish输入命令时,光标后会有一个暗灰色建议,如果您同意这个建议,您可以按右方向键或`ctrl-f` +# 更改默认Shell +chsh -s "$(command -v fish)" +``` +当您在Fish输入命令时,光标后会有一个暗灰色建议,如果您同意这个建议,您可以按右方向键或`ctrl-f` -- 当您在Fish输入命令时,您可以按Tab键列出所有选项,您可以使用方向键选择选项,使用回车键补全 +当您在Fish输入命令时,您可以按Tab键列出所有选项,您可以使用方向键选择选项,使用回车键补全 -- 使用`ctrl-a`或`ctrl-e`移动到命令的头部或尾部 +使用`ctrl-a`或`ctrl-e`移动到命令的头部或尾部 -- 使用`ctrl-k`删除光标后的所有内容 +使用`ctrl-k`删除光标后的所有内容 -- 使用`ctrl-c`中断命令 +使用`ctrl-c`中断命令 -- 使用`alt-c`将光标后面的第一个字母大写 +使用`alt-c`将光标后面的第一个字母大写 -- 使用`alt-u`将光标后面的所有字母大写 +使用`alt-u`将光标后面的所有字母大写 **Fish默认使用Emacs快捷键,您可以使用`fish_vi_key_bindings`切换到vi模式,使用`fish_default_key_bindings`,切换回去**。 ## 配置 -- 您可以在config-fish添加以下文本关闭Fish的欢迎信息: - - `set -U fish_greeting` +您可以在config-fish添加以下文本关闭Fish的欢迎信息: +```bash +set -U fish_greeting +``` + +您可以使用以下语法设置别名 +```bash +alias 别名="原本的命令" +abbr -a 别名="原本的命令" +``` + +## 关于更多 + +受限于我们的专门性,建议选择这些更专门的教程或文档学习 -- 您可以使用以下语法设置别名 - - `alias 别名="原本的命令"` - - `abbr -a 别名="原本的命令"` - +- [官方文档](https://fishshell.com/docs/current/index.html) +- [Fish语言教程](https://fishshell.com/docs/current/tutorial.html) diff --git a/docs/applications/git.md b/docs/applications/git.md index 8b8bf98..ad481a6 100644 --- a/docs/applications/git.md +++ b/docs/applications/git.md @@ -4,77 +4,93 @@ [官网](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 clone http://example.com/example.git +``` -**由于本文档面向新手所以只介绍Git的本地仓库版本管理,不涉及远程仓库的使用** +### 创建初始化一个Git仓库 -- 使用以下命令创建初始化一个Git仓库 +#### 从空的目录创建 ``` -#mkdir用于创建文件夹 +mkdir 文件夹名称 +cd 文件夹名称 +git init +``` -mkdir 文件夹名称 +> `mkdir 文件夹名称` 用于创建文件夹 +> +> `cd 文件夹名称` 进入您刚刚创建的文件夹 -#cd用于切换目录 -cd 文件夹名称 +#### 在已有项目中创建 -git init +> 确保您当前位于您的项目目录中 (使用`pwd`命令确认,`cd`命令用于进入一个文件夹) ``` +git init +``` -- 使用以下命令将修改的文件推送到本地仓库创建一个版本 +### 将修改的文件推送到仓库创建一个版本 -``` -#git add命令会把文件放入暂存区 +#### 加入暂存区 +``` git add 修改的文件 +``` -#您可以不加-m参数,Git会打开一个图形界面让您填写信息 -#git commit 将缓存区的文件放入本地仓库 +> `add`意为`添加`,用于将文件加入暂存区 -git commit -m "这一次提交的介绍" +#### 提交暂存区 ``` +git commit -m "这一次提交的介绍" +``` -- 使用使用以下命令查看所有版本 +???+ tip "不带`-m`参数" + 您可以不加`-m`参数,Git会根据您当前的`EDITOR`环境变量打开一个编辑器让您填写信息 -``` -git log + 您可以使用`echo $EDITOR`得知当前编辑器是什么 -#如果您想要一个更加简洁的界面 + `git commit` 将缓存区的文件放入本地仓库 -git log --oneline +> `commit`意为`提交` +### 查看所有版本 + +``` +git log ``` -- 使用以下命令回退版本 +???+ tip "如果您想要一个更加简洁的界面" + `git log --oneline` -``` -#哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的 -#git reflog可以查看您所有的操作,包括您删除的版本的哈希值 -#git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件 -#更推荐您使用默认参数 +### 回退版本 -git reset 版本的哈希值 +- `git log` 查看commit历史,每一个提交都具有一个独一无二的哈希值 +- `git reflog` 可以查看您所有的操作,包括您删除的版本的哈希值 +- `git reset --mixed` 这是默认使用参数,会删除本地仓库和缓存区的文件 +- `git reset --hard` 会删除本地仓库和缓存区和工作区的文件 +- `git reset --soft` 只删除本地仓库的文件 -``` +> 更推荐您使用默认参数 +> +> `git reset 版本的哈希值` -## 视频教程 -[一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) -[蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) -[Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) +## 关于更多 +由于我们的专门性限制,我们建议您去其他专门教程深入的的学习git。 +1. [Pro Git Book](https://git-scm.com/book/zh/v2) +2. [菜鸟教程](https://www.runoob.com/git/git-tutorial.html) +3. [一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) +4. [蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) +5. [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..ba1d605 100644 --- a/docs/applications/programming/miniconda.md +++ b/docs/applications/programming/miniconda.md @@ -1,84 +1,40 @@ # 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。  -- 使用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 来安装的,所以这里也需要配置一下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 -# 列出所有环境, 如果是当前的环境, 会标有 * -``` +此外,还需要配置pip源,建议访问[中科大源](https://mirrors.ustc.edu.cn/help/pypi.html)进行配置 diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md index 1180d39..29ad315 100644 --- a/docs/applications/programming/python.md +++ b/docs/applications/programming/python.md @@ -1,62 +1,25 @@ -# 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` - -## 编写第一个脚本 - -- 创建一个脚本 - -```bash -touch hello.py -``` - -- 写入内容 +除个别极简发行版外(如Arch),大多数发行版已自带。 +Arch系: ```bash -echo "print('hello python')" > hello.py +sudo pacman -S python ``` -- 查看内容 - -```bash -cat hello.py - -# 会输出 -# print('hello python') -``` +### 使用 -## 运行 +Linux里面一般以`python3`命令使用Python。 -有很多Windows来的同志不知道怎么运行,但实际上非常简单。 +???+ tip "通过`python`使用" + 如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。 -用法: - -```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) + - Debian: `sudo apt install python-is-python3 -y` + - Fedora: `sudo dnf install python-is-python3 -y` ## 库 @@ -75,11 +38,11 @@ Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。ä½ ╰─> 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 @@ -89,5 +52,5 @@ Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。ä½ hint: See PEP 668 for the detailed specification. ``` 由于系统的部分组件依赖Python的依赖,因而外来库可能破坏系统本身的依赖关系。 - - 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。
\ No newline at end of file + + 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。 diff --git a/docs/applications/ssh.md b/docs/applications/ssh.md index c26fa72..9b05a55 100644 --- a/docs/applications/ssh.md +++ b/docs/applications/ssh.md @@ -1,133 +1,29 @@ # SSH -在 Linux 中, 远程操控服务器是基本操作,这个时候,就需要使用 `ssh` 这个工具。 +???+info "注意!" + SSH指ssh协议,也指ssh的客户端/服务端,且SSH实现种类较多,此处特指ssh客户端/服务端,且以最普及的openSSH为示例 -具体的概念和介绍参考[百度百科](https://baike.baidu.com/item/%E5%AE%89%E5%85%A8%E5%A4%96%E5%A3%B3%E5%8D%8F%E8%AE%AE)或[Wikipedia](https://zh.wikipedia.org/zh-hans/Secure_Shell)。 +## 概述 -很多 Windows 用户可能有**连接 Linux 虚拟机**进行实验的需求, -以及人工智能专业的同学可能需要 **使用云端服务器来进行模型的训练** - -所以我在这里简单介绍一下如何在 Windows 下使用 ssh 命令远程连接虚拟机或者服务器。 - -## 前置条件 - -Windows客户端和被连接的Linux**必须满足下面的条件之一**: - -- 处于同一个网络下(内网穿透也可) -- Linux 服务器有公网ip,并且windows可以正常上网 - -> 一般虚拟机就是在宿主机拉起的虚拟网络中, 所以可以直接连接。 +OpenSSH是SSH(Secure Shell)协议的免费开源实现。它通过对所有传输流量进行加密,为不安全的网络提供安全的远程登录、命令执行、文件传输及TCP端口转发(隧道),是跨平台管理远程系统的核心工具。 ## 安装 -- 首先使用 win + r , 然后输入cmd -- 按住 ctrl + shift 然后回车打开管理员的命令提示符 - -- 之后使用 `winget` 来安装 ssh 客户端 - -```cmd -winget install Microsoft.OpenSSH.Beta -``` - -- 检验是否安装成功 - -```cmd -ssh -V -``` - -## 查看Linux端信息 - -如果你是虚拟机,打开虚拟机内部的终端 (一般叫做Terminal): +大多数情况下,ssh已经被系统自带。 -```bash -user@hostname:~$ -# 开启之后会看到这个, 叫做命令提示符, @ 前面的就是用户名 -# 然后你输入的命令会出现在 $ 右侧 -``` +## 使用 -查看 `ip` 地址: +**示例**:以example账户连接到10.0.0.1。 ```bash -ip a - -``` - -参考输出讲解: - -```bash -1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000 - link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 - inet 127.0.0.1/8 scope host lo - valid_lft forever preferred_lft forever - inet6 ::1/128 scope host noprefixroute - valid_lft forever preferred_lft forever -2: enp1s0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000 - link/ether 52:54:00:0d:46:77 brd ff:ff:ff:ff:ff:ff - altname enx5254000d4677 -3: enp7s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000 - link/ether 52:54:00:21:7d:76 brd ff:ff:ff:ff:ff:ff - altname enx525400217d76 - inet 192.168.200.2/24 brd 192.168.200.255 scope global enp7s0 - valid_lft forever preferred_lft forever - inet6 fe80::5054:ff:fe21:7d76/64 scope link proto kernel_ll - valid_lft forever preferred_lft forever -``` - -我们先找到**状态为UP**的网卡, 也就是显示 state UP 的卡, 这里是 `lo` 以及 `enp7s0` - -- `lo`: 本地回环, 用于这个机器内部自己的通信, 无法跟外界通信,所以我们不使用这个网络接口连接 -- `enp7s0`: 有线网卡,可以与同一网络下的机器通信,我们将使用这个接口进行 ssh 连接 - -下一步是找到我们目标网卡的 inet 这一行,在这里的例子中是: - -``` -inet 192.168.200.2/24 brd 192.168.200.255 scope global enp7s0 -``` - -这里的 192.168.200.2 就是对应的ip地址, 至于后面的 /24 表示子网掩码,这里不需要管。 - -然后我们记住这个ip地址(当然你可以后面返回来看)。 - -???+ note "环境" - 文章演示环境为内网环境。所使用的是内网ip。由于IPv4资源紧张与NAT的存在,大部分家用计算机并不会被分配公网IPv4,所使用的也是经过NAT转发的公网地址。当然,您也可以尝试配置公网IPv6。 - -## 进行连接 - -下面的操作就是在你的 cmd 或者 powershell 当中运行(也就是windows) -我们刚才已经拿到了两个信息: - -- 用户名: 也就是 @ 前面的那个 -- ip地址: 也就是 3 个点分割的ipv4 (一般 192开头) - -我们现在使用这两个信息进行ssh连接,语法是: - -```shell -ssh 用户名@ip地址 -``` - -举个例子: - -```shell -ssh cabin@192.168.200.2 +ssh example@10.0.0.1 ``` -表示我要使用ssh登陆 192.168.200.2 对应的主机的 cabin 这个账户。 - -## 测试 - -当你看到出现了类似这种提示符, 就代表连接成功了。 - -```shell -cabin@linux-handbook:~$ -``` - -接下来你可以试着跟linux打个招呼。 - +**示例**:systemd环境下启动ssh服务。 ```bash -echo hello linux -# 输出 hello linux +sudo systemctl start ssh # 个别发行版为sshd ``` -然后如果需要推出的话, 可以使用 `exit` 命令。 +## 关于更多 -当然Windows用户更习惯关掉命令行, 因为不常用haha。
\ No newline at end of file +请根据`man ssh`中的信息进行专门性学习。 diff --git a/docs/applications/vim.md b/docs/applications/vim.md index cd494cf..7c5eece 100644 --- a/docs/applications/vim.md +++ b/docs/applications/vim.md @@ -1,6 +1,8 @@ # Vim -`vim` 是一款终端文本编辑器, 几乎所有的Linux发行版都会预装。 +## 概述 + +`vim` 是一款轻量高效的终端文本编辑器, 几乎所有的Linux发行版都会预装。 第一次使用vim的人,最大的感受一定是: 反人类。 Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的)。 @@ -8,27 +10,41 @@ Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接å� 话虽如此,在终端用Vim改个配置文件依旧是很多Linux玩家的日常 所以我们有必要稍微学习一下如何使用Vim完成以下基础的操作。 ---- +## 安装 + +Debian系: +```bash +sudo apt install vim +``` + +红帽系: +```bash +sudo dnf install vim +``` + +Arch系 +``` +sudo pacman -S vim +``` ## 模式 -模式是vim中最具特色的概念,我们只需要看编辑器的左下角就可以分别当前的模式 -对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是 +模式是vim中最具特色的概念,我们只需要看编辑器的左下角就可以分别当前的模式,对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是。 - **INSERT** -> 插入模式 - - 插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式 - - 当你处于插入模式的时候, **左下角会出现 INSERT** + +插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式。 +当你处于插入模式的时候, **左下角会出现 INSERT**。 - **NORMAL** -> 普通模式 - - 普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改** - - 当你处于普通模式的时候, **左下角是空的**,普通是默认的模式 + +普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**。 +当你处于普通模式的时候, **左下角是空的**,普通是默认的模式。 - **COMMAND** -> 命令模式 - - 命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端** - - 当然这个模式也是可以批量处理文本的(比如说替换之类的操作) - - 当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中** ---- +命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**。 +这个模式也是可以批量处理文本的(比如说替换之类的操作),当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中**。 ## 模式的转换 @@ -36,63 +52,50 @@ Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接å� 因为**所有的模式下,按esc键都能变成普通模式**。 并且 普通模式 只需要按一个键就可以切换到各种模式。 -所以我们只需要记住下面的内容即可 (对于新手来说): +所以我们作为基础使用者只需要记住下面的内容即可: 当你处于非普通模式的时候: -- Esc (键盘最左上角的键) -> 回到普通模式 +- `Esc` 回到普通模式 当你处于普通模式的时候: -- i -> 进入插入模式 -- : -> 进入命令模式(没错这里就是打个冒号) - -## 一般流程 - -- 打开文件 - - ```bash - # 使用 vim 打开你需要编辑的文件 - # 语法是 vim 路径 - vim /path/to/file - ``` - - 打开之后就是普通模式。 - -- 移动 - -这个时候如果不是空的文件,你一般需要移动 -可以直接使用方向键 -或者用这个**超人类语法** -> h j k l (分别对应 左 下 上 右 的方向键) +- `i` 进入插入模式 +- `:` 进入命令模式 +## 使用 -- 进入插入模式进行编辑 +打开文件 +```bash +# 使用 vim 打开你需要编辑的文件 +# 语法是 vim 路径 +vim /path/to/file +``` - 按下 `i` 键, **看到左下角出现INSERT**,然后就是正常的编辑工作 +打开之后就是普通模式。 -- 保存修改 - 我们需要使用命令模式保存修改,所以第一步是先按 Esc 回到普通模式。 +移动 - 这个时候你会发现左下角的INSERT消失了, +- 使用方向键或`h` `j` `k` `j`,对应为上下左右。 - 然后按 `:` 进入命令模式 -> 你会看到左下角出现冒号 +保存 - 输入 `w` (表示我要将修改写入文件, 也就是 write) +- 在COMMAND模式下输入`:w` - 回车 (这个时候你已经保存了修改) +退出 - 输入 `q` (表示我要退出vim, 也就是quit) +- 在COMMAND模式下输入`:q` - 回车 +强制退出 - 这个时候你已经成功使用 vim 完成了编辑工作 +- 在COMMAND模式下输入`:q!` - > 当然命令模式是可以一次执行多个命令的, 可以直接 `:wq` 表示保存并退出文件 +保存并退出 ---- +- 在COMMAND模式下输入`:wq` -## 教程补充 +## 关于更多 -> 这里补充一些教程,但是入门的话使用当前的文档足矣 +受限于我们的专门性,建议通过其他专门性教程学习vim。 -[蛋老师Bilibili教程](https://www.bilibili.com/video/BV13t4y1t7Wg?t=87.5) +- [菜鸟教程](https://www.runoob.com/linux/linux-vim.html) diff --git a/docs/applications/zsh.md b/docs/applications/zsh.md index f99c5c1..bb8928a 100644 --- a/docs/applications/zsh.md +++ b/docs/applications/zsh.md @@ -1,5 +1,7 @@ # Zsh +## 概述 + Zsh是一款拥有高度自定义性的[Shell](../concepts/linux/shell.md),它具有强大的自动补全、语法高亮,并且由于Oh My Zsh的支持,拥有海量主题与插件,特别适合用于美化。 ## 安装 @@ -8,13 +10,25 @@ Zsh是一款拥有高度自定义性的[Shell](../concepts/linux/shell.md),它 以下命令用于安装Zsh与部分推荐扩展。 -- Debian: `sudo apt install zsh zsh-autosuggestions zsh-syntax-highlighting` -- Fedora: `sudo dnf install zsh zsh-autosuggestions zsh-syntax-highlighting` -- Arch: `sudo pacman -S zsh zsh-completions zsh-autosuggestions zsh-syntax-highlighting` +Debian系: +```bash +sudo apt install zsh zsh-autosuggestions zsh-syntax-highlighting +``` + +红帽系 +```bash +sudo dnf install zsh zsh-autosuggestions zsh-syntax-highlighting +``` + +Arch系 +```bash +sudo pacman -S zsh zsh-autosuggestions zsh-syntax-highlighting +``` 安装好后,您可以运行`chsh -s /bin/zsh`来设置Zsh为默认终端。 -部分发行版源的`zsh`包,在初次运行`zsh`时,会询问您想要如何配置`.zshrc`(Zsh的配置文件)。我们建议您输入2来选择`(2) Populate your ~/.zshrc with the configuration recommended by the system administrator and exit (you will need to edit the file by hand, if so desired).`(默认推荐配置)。 +???+info "注意" + 部分发行版源的`zsh`包,在初次运行`zsh`时,会询问您想要如何配置`.zshrc`(Zsh的配置文件)。我们建议您输入2来选择`(2) Populate your ~/.zshrc with the configuration recommended by the system administrator and exit (you will need to edit the file by hand, if so desired).`(默认推荐配置)。 ### Oh My Zsh |
