translate DefinedsGuidance

Author: sunflower2333

.vitepress/zh.ts

@@ -63,6 +63,7 @@ function sidebarDocs(): DefaultTheme.SidebarItem[] {
       text: 'UEFI移植',
       items: [
         { text: '设备移植简述', link: '/PortingGuides/SimpleGuide'},
+        { text: '宏定义说明', link: '/PortingGuides/DefinesGuidance'},
         { text: '调试', link: '/PortingGuides/Debug'}
       ]
     },

DualBoot/PatchKernel.md

@@ -85,29 +85,29 @@ Please do not patch a patched kernel.
 
 - Test with fastboot.
   + Send `new-boot.img` to your computer:
-  ```pwsh
+  ```powershell
   adb pull /sdcard/dualboot/new-boot.img
   ```
   + Reboot to fastboot
-  ```pwsh
+  ```powershell
   adb reboot bootloader
   ```
   + Ensure OS-switch is on the correct state before it loading. Like magnet shell or tri-state key.
   + Try load boot image once.
-  ```pwsh
+  ```powershell
   fastboot boot new-boot.img
   ```
   + See if the device is entering a correct os.
 
 - Flash boot image into disk
   + If everything goes well and boot image was backuped. You can flash boot image into disk now. Then no fastboot command is required when using dualboot.
   + Flash boot:
-  ```pwsh
+  ```powershell
   fastboot flash boot new-boot.img
   ```
 - Recover original boot image:
   + If you want to remove dualboot, flash your backuped boot image.
-  ```pwsh
+  ```powershell
   fastboot flash boot.img
   ```
 

PortingGuides/SimpleGuide.md

@@ -78,7 +78,7 @@ ___
       * Included by SurfaceDuo1.dsc
     - **Defines.dsc.inc**
       * Macros for special use.
-      * For detailed about Macros, please read [DefinesGuidance.md](DefinesGuidance.md)
+      * For detailed about Macros, please read [DefinesGuidance](DefinesGuidance.md)
     - **PcdsFixedAtBuild.dsc.inc**
       * Included by SurfaceDuo1.dsc.
       * Stores device specific pcds. (e.g Screen resolution)

zh/PortingGuides/DefinesGuidance.md

@@ -0,0 +1,24 @@
+# 定义
+> 本文档将介绍 `Defines.dsc.inc` 中所有可用的定义
+
+## **HAS_MLVM**  
+  * 类型
+    - 布尔值
+  * 为什么要定义它？
+    - 某些设备有 MLVM 区域，有些没有。
+    - 如果设备启用了 MLVM，MLVM 区域将被保护，并且不可读写。
+  * 当为 **1** 时会发生什么？
+    - 如果 `HAS_MLVM = TRUE`，MLVM 区域将被保留，因此 HLOS 不会使用此区域。
+    - 总 RAM 大小将减少约 400MB。
+  * 在哪里使用？
+    - `HAS_MLVM` 在 `Platforms/AndromedaPkg/Driver/RamPartitionDxe/ExtendedMemoryMap.h` 中使用。
+
+## **CUST_LOGO**  
+  * 类型
+    - 布尔值
+  * 为什么要定义它？
+    - 某些设备可能想要自己的标志。（即品牌的标志）
+  * 当为 **1** 时会发生什么？
+    - 启动标志将被替换为 `Device/$(brand-codename)/Include/Resources/CustBootLogo.bmp` 下的标志
+  * 在哪里使用？
+    - `CUST_LOGO` 在 `Platforms/AndromedaPkg/Frontpage.fdf.inc` 中使用

zh/PortingGuides/SimpleGuide.md

@@ -78,7 +78,7 @@ ___
       * 由SurfaceDuo1.dsc包含
     - **Defines.dsc.inc**
       * 特殊用途的宏。
-      * 有关宏的详细信息，请阅读 [DefinesGuidance.md](DefinesGuidance.md)
+      * 有关宏的详细信息，请阅读 [宏定义说明](DefinesGuidance.md)
     - **PcdsFixedAtBuild.dsc.inc**
       * 由SurfaceDuo1.dsc包含。
       * 存储设备特定的pcds。（例如屏幕分辨率）