build

chapter_preface/suggestions.md

@@ -17,17 +17,17 @@ comments: true
 - 当涉及到编程语言之间不一致的名词时，本书均以 Python 为准，例如使用 $\text{None}$ 来表示“空”。
 - 本书部分放弃了编程语言的注释规范，以换取更加紧凑的内容排版。注释主要分为三种类型：标题注释、内容注释、多行注释。
 
-=== "Java"
+=== "Python"
 
-    ```java title=""
-    /* 标题注释，用于标注函数、类、测试样例等 */
+    ```python title=""
+    """标题注释，用于标注函数、类、测试样例等"""
     
-    // 内容注释，用于详解代码
+    # 内容注释，用于详解代码
     
-    /**
-     * 多行
-     * 注释
-     */
+    """
+    多行
+    注释
+    """
     ```
 
 === "C++"
@@ -43,17 +43,30 @@ comments: true
      */
     ```
 
-=== "Python"
+=== "Java"
 
-    ```python title=""
-    """标题注释，用于标注函数、类、测试样例等"""
+    ```java title=""
+    /* 标题注释，用于标注函数、类、测试样例等 */
     
-    # 内容注释，用于详解代码
+    // 内容注释，用于详解代码
     
-    """
-    多行
-    注释
-    """
+    /**
+     * 多行
+     * 注释
+     */
+    ```
+
+=== "C#"
+
+    ```csharp title=""
+    /* 标题注释，用于标注函数、类、测试样例等 */
+    
+    // 内容注释，用于详解代码
+    
+    /**
+     * 多行
+     * 注释
+     */
     ```
 
 === "Go"
@@ -69,6 +82,19 @@ comments: true
      */
     ```
 
+=== "Swift"
+
+    ```swift title=""
+    /* 标题注释，用于标注函数、类、测试样例等 */
+    
+    // 内容注释，用于详解代码
+    
+    /**
+     * 多行
+     * 注释
+     */
+    ```
+
 === "JS"
 
     ```javascript title=""
@@ -95,6 +121,25 @@ comments: true
      */
     ```
 
+=== "Dart"
+
+    ```dart title=""
+    /* 标题注释，用于标注函数、类、测试样例等 */
+    
+    // 内容注释，用于详解代码
+    
+    /**
+     * 多行
+     * 注释
+     */
+    ```
+
+=== "Rust"
+
+    ```rust title=""
+
+    ```
+
 === "C"
 
     ```c title=""
@@ -108,32 +153,6 @@ comments: true
      */
     ```
 
-=== "C#"
-
-    ```csharp title=""
-    /* 标题注释，用于标注函数、类、测试样例等 */
-    
-    // 内容注释，用于详解代码
-    
-    /**
-     * 多行
-     * 注释
-     */
-    ```
-
-=== "Swift"
-
-    ```swift title=""
-    /* 标题注释，用于标注函数、类、测试样例等 */
-    
-    // 内容注释，用于详解代码
-    
-    /**
-     * 多行
-     * 注释
-     */
-    ```
-
 === "Zig"
 
     ```zig title=""
@@ -145,25 +164,6 @@ comments: true
     // 注释
     ```
 
-=== "Dart"
-
-    ```dart title=""
-    /* 标题注释，用于标注函数、类、测试样例等 */
-    
-    // 内容注释，用于详解代码
-    
-    /**
-     * 多行
-     * 注释
-     */
-    ```
-
-=== "Rust"
-
-    ```rust title=""
-
-    ```
-
 ## 0.2.2   在动画图解中高效学习
 
 相较于文字，视频和图片具有更高的信息密度和结构化程度，更易于理解。在本书中，**重点和难点知识将主要通过动画和图解形式展示**，而文字则作为动画和图片的解释与补充。