diff options
| -rw-r--r-- | docs/applications/programming/cpp.md (renamed from pending/cpp_compile_beginner/cpp_compile_beginner.md) | 47 | ||||
| -rw-r--r-- | docs/applications/programming/miniconda.md (renamed from docs/applications/miniconda.md) | 2 | ||||
| -rw-r--r-- | docs/applications/programming/python.md | 93 | ||||
| -rw-r--r-- | mkdocs.yml | 6 | ||||
| -rw-r--r-- | pending/README.md | 0 | ||||
| -rw-r--r-- | pending/python_beginner/python_begginer.md | 64 |
6 files changed, 123 insertions, 89 deletions
diff --git a/pending/cpp_compile_beginner/cpp_compile_beginner.md b/docs/applications/programming/cpp.md index 118a1c4..e5d01b7 100644 --- a/pending/cpp_compile_beginner/cpp_compile_beginner.md +++ b/docs/applications/programming/cpp.md @@ -1,32 +1,36 @@ -# 在 Linux 上运行 cpp 代码 +# C++ ## Windows 的配置灾难 -众所周知,在windows上安装vscode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情 -因为 windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利 +众所周知,在windows上安装VSCode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情。 +因为 Windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利。 -如果你选择了 Linux 那么恭喜你将获得一个非常便利而自然的开发环境 -接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译 - ---- +如果你选择了 Linux ,那么恭喜你将获得一个非常便利而自然的开发环境。 +接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译。 ## g++ 安装 -g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来) -安装非常简单,取决于你使用什么包管理器 +g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)。 +安装非常简单,取决于你使用什么包管理器。 -- Debian 系列(ubuntu, mint, debian) +- Debian 系(Ubuntu, Mint, Debian) ```bash sudo apt install g++ -y ``` -- RHEL 系列(fedora, rhel, rocky) +- 红帽系(Fedora, rhel, rocky) ```bash sudo dnf install g++ -y ``` +- Arch系 + +```bash +sudo pacman -S g++ -y +``` + - 查看版本 ```bash @@ -50,7 +54,6 @@ Supported LTO compression algorithms: zlib zstd gcc version 16.1.1 20260725 (GCC) ``` ---- ## 编写一个程序 @@ -88,9 +91,9 @@ g++ hello.cpp -o hello ``` > -o <file> Place the output into <file>. -这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名 +这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名。 -写法是 g++ 源文件路径 -o 二进制文件 +写法是 g++ 源文件路径 -o 二进制文件。 - 运行程序 @@ -98,15 +101,13 @@ g++ hello.cpp -o hello ./hello # ./ 表示当前目录, 后面直接跟上文件名, 表示运行该二进制文件 ``` -这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个cpp程序 - ---- +这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个C++程序。 ## 多文件编译 -当我们的源文件不止一个的时候, 我们需要在编译的时候把所有用到的源文件都写上(当然仅限于自己写的那些源文件,标准库就不需要了) +当我们的源文件不止一个的时候, 我们需要在编译的时候把所有用到的源文件都写上(当然仅限于自己写的那些源文件,标准库就不需要了)。 -比如说这个项目 +比如说这个项目: ```bash ❯ tree @@ -148,7 +149,7 @@ g++ hello.cpp -o hello │ └── simdutf.cpp ``` -不要看有这么多文件, 但是这个明显是一个 header only 的项目, 只有 src/ 目录里面有两个cpp 文件,所以我们只需要编译的时候指定这两个即可 +不要看有这么多文件, 但是这个明显是一个 header only 的项目, 只有 src/ 目录里面有两个cpp 文件,所以我们只需要编译的时候指定这两个即可。 ```bash # 创建一个 bin 目录放产物 如果你还没有的话 @@ -160,7 +161,7 @@ g++ src/simdutf.cpp src/main.cpp -o bin/main # 直接使用通配符编译所有的cpp文件 ``` -这里给个建议就是将cpp源文件和hpp头文件分开,这样方便管理 +这里给个建议就是将cpp源文件和hpp头文件分开,这样方便管理。 -现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了 -祝贺你 +现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了。 +祝贺你。 diff --git a/docs/applications/miniconda.md b/docs/applications/programming/miniconda.md index de77859..cd445af 100644 --- a/docs/applications/miniconda.md +++ b/docs/applications/programming/miniconda.md @@ -20,7 +20,7 @@ Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,比å¦ 选择 Linux,选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)。 - + - 使用bash执行脚本 diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md new file mode 100644 index 0000000..1180d39 --- /dev/null +++ b/docs/applications/programming/python.md @@ -0,0 +1,93 @@ +# Python + +## 安装 Python + +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 +``` + +- 写入内容 + +```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 @@ -9,6 +9,7 @@ validation: nav: omitted_files: info +strict: true theme: name: material @@ -162,5 +163,8 @@ nav: # - 跨发行版: - 应用: - applications/openclaw.md - - applications/miniconda.md + - 开发相关: + - applications/programming/cpp.md + - applications/programming/python.md + - applications/programming/miniconda.md - 关于: about.md
\ No newline at end of file diff --git a/pending/README.md b/pending/README.md new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/pending/README.md diff --git a/pending/python_beginner/python_begginer.md b/pending/python_beginner/python_begginer.md deleted file mode 100644 index 39c61be..0000000 --- a/pending/python_beginner/python_begginer.md +++ /dev/null @@ -1,64 +0,0 @@ -# 在 Linux 上运行第一个 Python 程序 - -## 安装 Python - -Linux 上装Python还是非常轻松的 -因为不用装,自带 - -Linux 里面一般都是 python3 -如果你想要用 python 这个命令, 可以装一个 python-is-python3, 来用软链接骗过操作系统(开个玩笑) - -```bash -sudo apt install python-is-python3 -y - -# 如果你是 rhel 系列 -# sudo dnf install python-is-python3 -y -``` - -## 编写第一个脚本 - -- 创建一个脚本 - -```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) |
