docs: update docs

Log:
2023-02-23 11:51:27 +08:00 · 2023-02-23 11:51:27 +08:00 · 228cd41b94
commit 228cd41b94
parent 3e791ebd6a
3 changed files with 287 additions and 0 deletions
--- a/docs/deepin入门教程/2.安装deepin/2.1.安装deepin.md
+++ b/docs/deepin入门教程/2.安装deepin/2.1.安装deepin.md
@ -0,0 +1,147 @@
+# 2.1.安装deepin
+
+## 2.1.1.介绍
+
+* 关于深度操作系统的安装的过程，具体请参考官方社区网站介绍：[如何安装](https://www.deepin.org/installation/)以及[深度安装器](https://www.deepin.org/original/deepin-installer/)项目。
+* 虚拟机安装，客户机类型选：linux debian11 x64
+
+## 2.1.2.下载
+
+**官方镜像**
+
+* 访问deepin社区[下载页面](https://www.deepin.org/download/)，下载深度操作系统系统最新版本的镜像文件（以便您能够体验到最新特性）
+::: warning
+deepin v23 目前处于测试阶段，不建议您在生产环境中使用，也不建议新手用户使用。
+:::
+
+## 2.1.3.MD5校验
+
+* 下载深度操作系统镜像完成后，需要对其进行校验，非官方或不完整的镜像将不能用于深度操作系统的安装：
+
+* Windows系统：下载下面几个工具中的任意一个，校验您下载的镜像的MD5值与[下载页面](https://www.deepin.org/download/)提供的 MD5 值是否一致。( MD5 值在**立即下载**按钮下方)
+
+* <http://www.keir.net/download/hash.zip>
+
+* <http://ftp6.nero.com/NeroMD5Verifier.zip>
+
+* <http://www.slavasoft.com/zip/hashcalc.zip>
+
+* Linux系统：在对应的镜像文件下，打开深度终端，执行`md5sum deepin-20.8-amd64.iso`命令，请确认下载的镜像的 MD5 值与[下载页面](https://www.deepin.org/download/)提供的 MD5 值是否一致。( MD5 值在**立即下载**按钮下方)
+
+    > 说明：deepin-15.6-amd64.iso即为下载的系统镜像文件名，可使用 Tab 键自动补全文件名。
+
+## 2.1.4.制作启动盘
+
+**下载制作工具**
+
+* [深度启动盘制作工具](https://www.deepin.org/original/deepin-boot-maker/)
+* [通用Windows工具](https://github.com/pbatard/rufus)
+* [通用全平台工具](https://github.com/balena-io/etcher)
+
+ 1. 使用深度科技团队开发的[深度启动盘制作工具](https://www.deepin.org/original/deepin-boot-maker/)或[通用Windows工具](https://github.com/pbatard/rufus)或[通用全平台工具](https://github.com/balena-io/etcher)任意一种制作启动U盘.
+
+ 2. 请将U盘插入电脑后，运行深度启动盘制作工具。
+
+ 3. 选择深度操作系统镜像开始制作启动盘，制作期间请不要移除U盘，制作完成请选择重启电脑。
+
+ 4. 若需制作支持 BIOS+UEFI，deepin_Recovery+Win PE 的多功能启动盘，参考[deepin安装U盘制作,支持 BIOS+UEFI，deepin_Recovery+Win PE](https://bbs.deepin.org/forum.php?mod=viewthread&tid=149708&extra=)
+
+## 2.1.5.注意事项
+
+* 制作前请提前转移U盘中重要数据，制作时可能会清除U盘所有数据。
+* 制作前建议将U盘格式化为 FAT32 格式，以提高识别率。
+* 部分U盘实则为移动硬盘，因此无法识别，请更换为正规U盘。
+* U盘容量大小不得小于 2 G，否则无法成功制作启动盘。
+* 制作过程中请不要触碰U盘，以免因为写入不全导致制作失败。
+
+## 2.1.6.安装过程
+
+* 如果您的电脑主板为 UEFI 模式，请在主板设置中关闭[安全启动](http://www.yxswz.com/x64bug.html)，然后重新启动计算机，并在BIOS/UEFI界面下特定键按住"改变启动顺序"键。
+
+* 例如各主板[启动快捷键](http://jingyan.baidu.com/article/a378c9609ace4eb328283005.html)：
+
+  * 台式机一般为：Delete 键
+  * 笔记本一般为：F2 键
+  * 惠普笔记本一般为：F10 键
+  * 联想笔记本一般为：F12 键
+  * 苹果电脑为：C 键
+
+* 深度操作系统的安装的过程具体请参见[如何安装](https://www.deepin.org/installation/)。
+
+## 2.1.7.安装完成
+
+* 根据深度安装器的界面提示，输入和选择对应的信息后，系统会在自动安装过程中，通过幻灯片了解当前系统的特性，直至安装过程完毕。待安装过程完毕，根据提示重启电脑即可进入深度操作系统。
+
+    > 注意：如果安装失败，会出现安装失败相关信息，通过手机端扫描失败的二维码，会自动将失败日志反馈到服务器。
+
+## 2.1.8.常见问题
+
+### 多硬盘时安装 deepin 出现的无法引导的问题
+
+* 如果主板用的是旧的引导方式( Legacy BIOS ), 而不是 UEFI 模式来引导的, 可能会在安装完 deepin 之后, 无法找到这个系统.下面是一个具体的例子:
+
+  * /dev/sda 上面安装了 Windows 系统, 可以正常引导和使用; 又在 /dev/sdb 上面又安装了 deepin 系统. 如果安装完系统重启电脑后, 直接进入到 Windows 系统了, 并没有进入到 deepin 系统, 那就是遇到上面说的问题了.
+
+**有几种解决方法:**
+
+* 在 BIOS 中, 修改硬盘的启动优先级, 优先启动 /dev/sdb (推荐)
+* 重新安装 deepin 系统, 在安装时的分区页面, 切换到 "高级" 模式, 在高级分区页面的左下角, 可以修改 grub 的安装位置, 改为 /dev/sda (第一个硬盘)
+
+### 因主板启动模式导致 deepin 不能安装的情形
+
+**新买的已安装 Windows 系统的品牌机**
+
+* 目前新买品牌机大都已预装 Windows 10 系统，且是 UEFI 模式启动。因此内置硬盘也肯定是 GPT 格式，先腾出适当硬盘空间，再用制作好的 deepin 安装U盘启动安装，一般不会有什么问题。但安装 deepin 前，进入主板BIOS设置，关闭 Secure Boot (安全启动)。
+
+**旧机器**
+
+* 只有传统 BIOS 模式启动的老电脑，安装时一般也不会有问题。
+* 已支持 UEFI 模式的旧电脑，并有传统 BIOS 模式启动的 Windows 系统，硬盘格式为 MBR 格式，安装时可能会有问题。如主板 BIOS 设置中启动模式为自动，则说明既可以 UEFI 启动，也可以 Legacy 启动，支持两种方式启动。用 deepin 安装U盘启动时，会出现两个U盘启动选项（ deepin 安装U盘支持两种格式启动），其中之一有 UEFI 字样。如果是用 UEFI 启动，但硬盘是 MBR 格式，就自然安装不上，出现硬盘格式化警告提示。
+
+> 解决方法： 选择以非 UEFI 方式启动U盘，或主板设置成仅 Legacy boot（如可能）
+
+**新组装机器**
+
+* 新机器新硬盘，这种全新电脑，安装 deepin 也不会有问题。
+* 新机器旧硬盘，旧硬盘上有数据，且是硬盘是 MBR 格式。目前的新主板都支持 UEFI 模式启动，且有的主板上是默认启动方式（UEFI  ONLY）。在这种情况下，要进入主板设置，开启 Legacy  boot（或 CSM Support）。
+
+    这里面不同的主板设置也有所不同，有的可以设置为仅 Legacy  boot，也有的只是开启（支持），就是两种方式都支持。
+
+   如果是设置为仅 Legacy  boot，安装时就类似旧电脑的第一种情形。
+
+   如果是支持双启动模式，类似旧电脑的第二种情形。
+
+### 一些可能出现的问题
+
+* 成功安装在登录界面输入密码后无法进入桌面
+  * 这种情况一般是图形服务（X Window）启动失败，而造成这种问题的原因则是图形驱动，解决方案如下:
+    * 在登录界面按组合键`Ctrl` + `Alt` + `F2`切换到字符界面
+    * 进入字符界面后进行字符界面登录系统
+    * 输入如下指令：
+
+            ```shell
+            sudo rmmod nouveau //删除nouveau驱动模块
+            ```
+
+            ```shell
+            sudo echo "blacklist nouveau" > /etc/modprobe.d/blacklist.nouveau.conf //创建并填充指定屏蔽模块
+            ```
+
+            ```shell
+            sudo update-initramfs -u //更新
+            sudo reboot //重启
+            ```
+
+        > 上述指令执行完后基本上可以解决大部分此类问题
+
+### 启动菜单分辨率不正确
+
+参见：<https://bbs.deepin.org/forum.php?mod=redirect&goto=findpost&ptid=133875&pid=361813&fromuid=4870>
+
+## 社区分享
+
+* [Windows+deepin双系统启动](https://bbs.deepin.org/forum.php?mod=viewthread&tid=44261)
+* [关于windows10与deepin15.2双系统的最佳方案](https://bbs.deepin.org/forum.php?mod=viewthread&tid=42209)
+* [UEFI启动Grub引导多个Windows系统引导菜单独立](https://bbs.deepin.org/forum.php?mod=viewthread&tid=132291)
+* [Windows下手动添加Deepin引导](https://bbs.deepin.org/forum.php?mod=viewthread&tid=133725)
+* [硬盘安装和U盘安装Deepin_最简单iSO启动方法](https://bbs.deepin.org/forum.php?mod=viewthread&tid=135051)
--- a/docs/deepin进阶教程/11.编程开发/11.1.C++编程环境搭建.md
+++ b/docs/deepin进阶教程/11.编程开发/11.1.C++编程环境搭建.md
@ -0,0 +1,121 @@
+# 11.1.C/C++编程环境搭建
+
+## 11.1.1. 基础环境
+
+### 编译器
+
+你首先需要安装一些基础软件包，这些软件包是编译C/C++程序所必须的。
+
+```Shell
+sudo apt install build-essential
+```
+
+build-esential是一个元包，它包含了编译C/C++程序所必须的软件包。包括了gcc、g++、make、libc6-dev|libc-dev.
+
+当然你也可以安装llvm，它也是一个C/C++编译器，它的优势是可以编译C/C++以外的语言，比如Rust、Go、Swift等。
+
+```Shell
+sudo apt install llvm # llvm后端编译器
+sudo apt install clang # clang前端编译器
+```
+
+### 调试工具
+
+调试工具是编程的必备工具，它可以帮助我们快速定位程序的错误，提高程序的运行效率。
+
+```Shell
+sudo apt install gdb  # gdb调试器
+sudo apt install valgrind  # valgrind内存检查工具
+```
+
+### 静态分析工具
+
+静态分析工具可以帮助我们检查程序的错误，比如内存泄漏、空指针访问等。
+
+```Shell
+sudo apt install cppcheck  # cppcheck静态分析工具
+sudo apt install clang-tidy  # clang-tidy静态分析工具
+```
+
+### 代码格式化工具
+
+代码格式化工具可以帮助我们格式化代码，使得代码风格统一，提高代码的可读性。
+
+```Shell
+sudo apt install clang-format  # clang-format代码格式化工具
+```
+
+clang-format可以使用配置文件进行配置，deepin社区提供一份符合deepin代码风格的配置文件，你可以在[这里](https://github.com/linuxdeepin/deepin-styleguide）
+找到，不过建议不要依靠这个配置文件，因为这个配置文件是根据deepin的代码风格来的，如果你的代码风格不是deepin的，那么这个配置文件就不适合你。
+
+拥有一个好的代码风格是非常重要的，它可以提高代码可读性，可维护性，可扩展性，可复用性，可测试性等等，所以你应该自己制定一套代码风格，然后使用clang-format来格式化你的代码。
+
+不过你还是不要太过于依赖工具，因为工具是人类的延伸，而不是人类的替代。当clang-format不能满足你的需求时，你应该自己去修改代码。
+
+`.clang-format`配置文件详见[官方文档](https://clang.llvm.org/docs/ClangFormatStyleOptions.html)
+
+### 代码检查工具
+
+代码检查工具可以帮助我们检查代码的错误，比如变量未使用、变量未初始化等。
+
+```Shell
+sudo apt install clang-check  # clang-check代码检查工具
+```
+
+### 代码覆盖率工具
+
+代码覆盖率工具可以帮助我们检查代码的覆盖率，比如哪些代码没有被测试到。
+
+```Shell
+sudo apt install lcov  # lcov代码覆盖率工具
+```
+
+### 代码压缩工具
+
+代码压缩工具可以帮助我们压缩代码，使得代码占用的空间更小。
+
+```Shell
+sudo apt install upx  # upx代码压缩工具
+```
+
+### 构建工具
+
+构建工具可以帮助我们构建项目，比如编译、链接、安装等。
+
+```Shell
+sudo apt install cmake  # cmake构建工具
+sudo apt install meson  # meson构建工具
+sudo apt install ninja-build  # ninja构建工具
+```
+
+## 11.1.2. 文本编辑器
+
+其实当上方的软件包都安装了之后，你就可以开始编写C/C++程序了，但是你还需要一个文本编辑器，这个文本编辑器可以是任意的，比如gedit、vim、emacs等。
+这里作为推荐，我推荐几款文本编辑器
+
+### vim
+
+vim是一款非常强大的文本编辑器，它的功能非常强大，但是它的学习曲线也非常陡峭，所以如果你是初学者，我不建议你使用vim。
+
+```Shell
+sudo apt install vim
+```
+
+### emacs
+
+emacs是一款非常强大的文本编辑器，它的功能非常强大，但是它的学习曲线也非常陡峭，所以如果你是初学者，我不建议你使用emacs。
+
+```Shell
+sudo apt install emacs
+```
+
+### vscode
+
+vscode是微软出品的一款文本编辑器，它的功能非常强大，而且它的学习曲线也不是很陡峭，所以如果你是初学者，我建议你使用vscode。
+
+根据vscode的开源协议，deepin不能在源中提供vscode的安装包，所以你需要去官网下载安装包，然后手动安装。
+或者（推荐）在应用商店中搜索vscode，然后安装。（这种方式会添加vscode官方的软件源，所以以后更新vscode会方便很多）
+
+### notepad--
+
+notepad--是
--- a/docs/deepin进阶教程/11.编程开发/11.2.golang编程环境搭建.md
+++ b/docs/deepin进阶教程/11.编程开发/11.2.golang编程环境搭建.md
@ -0,0 +1,19 @@
+# 11.2. golang编程环境搭建
+
+## 11.2.1. 软件包
+
+### golang
+
+golang是一款非常强大的编程语言。
+
+```Shell
+sudo apt install golang
+```
+
+### goland
+
+goland是一款非常强大的golang开发工具，它的功能非常强大，而且它的学习曲线也不是很陡峭，所以如果你是初学者，我建议你使用goland。
+
+```Shell
+sudo apt install goland
+```œ