dev merge to main

.gitignore

@@ -32,4 +32,6 @@
 *.app
 
 build/
-.vscode/
+
+.vscode/*
+!.vscode/tasks.json

.vscode/tasks.json

@@ -0,0 +1,20 @@
+{
+	// See https://go.microsoft.com/fwlink/?LinkId=733558
+	// for the documentation about the tasks.json format
+	"version": "2.0.0",
+	"tasks": [
+	  {
+		"type": "shell",
+		"label": "C/C++: clang++ build active file",
+		"command": "mingw32-make html",
+		"options": {
+		  "cwd": "${workspaceFolder}"
+		},
+		"group": {
+		  "kind": "build",
+		  "isDefault": true
+		},
+		"detail": "Task generated by Debugger."
+	  }
+	]
+  }

source/Changelog.md

@@ -4,6 +4,11 @@
 此更新日志为纵览更新，对于具体文章的更新位于每个文章的开头的 `更新记录` 中。
 ```
 
+## 2024/8/29
+
+>* 更新`欢迎来到 Vulkan 入门精要`文档
+>* 更新`开始于 Vulkan SDK`文档
+
 ## 2024/5/21
 
 >* 更新`资源与内存`文档

source/StartFromVulkanSDK.rst

@@ -24,6 +24,8 @@
    * 2023/6/29 更新 ``安装 Vulkan SDK`` 章节，改成 ``Tab`` 标签呈现
    * 2023/7/10 增加 ``查看 Vulkan 所有相关信息`` 章节
    * 2024/1/2 更新 ``Vulkan的库`` 章节。修正不推荐使用 ``vulkan-1.lib`` 的跳转说明链接。
+   * 2024/8/29 增加 ``Vulkan 三角形`` 章节。
+   * 2024/8/29 增加 ``编译`` 章节。
 
 ``Khronos`` 这次推出了 ``Vulkan`` 官方的软件开发工具包 `Vulkan SDK <https://vulkan.lunarg.com/home/welcome>`_ ，这避免了像 ``OpenGL`` 开发环境混乱的情形再次上演。
 
@@ -601,4 +603,25 @@ Vulkan SDK 最佳实践
 .. admonition:: 不使用 ``Vulkan SDK``
    :class: caution
 
-   理论上来说是不需要依赖 ``Vulkan SDK`` 的，但是如果使用一些第三方库，这些第三方库可能会依赖  ``Vulkan SDK`` ，比如 `VulkanMemoryAllocator <https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator>`_ 。此时 ``Vulkan SDK`` 还是需要的。
+   理论上来说是不需要依赖 ``Vulkan SDK`` 的，但是如果使用一些第三方库，这些第三方库可能会依赖  ``Vulkan SDK`` ，比如 `VulkanMemoryAllocator <https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator>`_ 。此时 ``Vulkan SDK`` 还是需要的。
+
+Vulkan 三角形
+######################
+
+对于 ``Vulkan`` 来说，想要绘制一个三角形需要学习各种前置知识，才能够整理出一个简单三角形的绘制流程 ，且代码量往往比较大，而很多新入门小伙伴对 ``Vulkan`` 绘制一个三角形的具体代码为何样很感兴趣。在这里提供一个完整的 ``Vulkan`` 绘制三角形的示例代码：
+
+.. card:: VulkanTriangle.rar
+   :link: ./_static/VulkanTriangle.rar
+   :shadow: md
+   :text-align: center
+
+   点击下载
+
+编译
+******
+
+1. 下载解压
+2. 找到 ``README.md`` 文件，在 ``README.md`` 同级目录中新建 ``build`` 文件夹
+3. 在 ``build`` 文件夹目录下打开 ``命令行`` 程序
+4. 输入 ``cmake ..`` 并回车，将会在 ``build`` 文件夹下生成项目工程
+5. 打开执行即可

source/index.rst

@@ -24,6 +24,8 @@
    * 2024/1/2 增加 ``资源`` 文档链接
    * 2024/1/2 增加 ``资源与内存`` 文档链接
    * 2024/4/14 增加 ``相关链接`` 文章链接
+   * 2024/8/29 增加 ``指正`` 链接
+   * 2024/8/29 增加 ``讨论`` 链接
 
 .. image:: https://img.shields.io/badge/QQ%20Group-128656761-deepgreen?logo=tencentqq
    :target: https://jq.qq.com/?_wv=1027&k=rZGd2LHr
@@ -68,7 +70,7 @@
 
 致良知，知行合一。让我们步入 ``Vulkan`` 的学习吧~ (๑•̀ㅂ•́)و✧
 
-.. important:: 文章来源于本人学习总结，会出现讲解错误，请各位及时提出指正，谢谢。
+.. important:: 文章来源于本人学习总结，会出现讲解错误，请各位及时提出 `指正 <https://github.com/FuXiii/Essentials.of.Vulkan/issues>`_ 或进行 `讨论 <https://github.com/FuXiii/Essentials.of.Vulkan/discussions>`_ ，非常感谢。
 
 .. toctree::
    :caption: 入门精要