Markdown 文档写作规范 - 标点符号与文本分割

1. 标点符号

• 全角与半角: 推荐在中文环境下使用全角标点符号，在英文环境下使用半角标点符号，以保持文本的一致性和可读性。
  • 中文全角标点示例：，。！？；：（）【】——“”‘’《》（注：中文环境下的引号通常使用全角）
  • 英文半角标点示例：,.!?;:()[]"'()

2. 英文与数字

• 大小写: 在代码、命令、文件名等需要准确表示的情况下，保持英文大小写的准确性。
• 数字: 对于数字，保持其格式的一致性，例如在列举、日期、时间、代码等场景中使用阿拉伯数字。

3. 代码与普通文本分割

• 代码前后空格: 在代码与普通文本之间添加空格，以提高代码的可读性。

  请使用命令 `git status` 查看当前状态。
  错误示例：请使用命令git status``查看当前状态。 `
  

4.列表与文本分割

• 列表前后空行: 在列表前后添加空行，以区分不同的段落或列表。

  这是一个普通段落。
  - 列表项一
  - 列表项二```
  
  错误示例：
  ```markdown
  这是一个普通段落。- 列表项一- 列表项二`
  

5.链接与文本分割

• 链接前后空格: 在链接前后添加空格，以区分链接文本和其他内容。

正确示例：访问 官方网站 了解更多信息。

错误示例：访问官方网站了解更多信息。

部署信息

访问地址

emp3.yy.com

项目仓库

https://git.yy.com/webs/hd/emp/official

发布地址

https://sy.sysop.yy.com/service/overview/3@friend@emp3-official/release/container

EMP3 官网

从webpack 切换到rspack(基于rust实现构建) 来构建js

底层的构建是rust实现 上层作用还是构建js

构建 共享模型 产物体积方面某做了调整适配

构建速度明显加强 提升数倍

共享 后续可以适配业务场景更多 如老项目不需要改造的情况下接入新项目

产物通过新的算法减少产物体积

对于新的产物模式进一步适配（esm） 运行效率更高

构建底层环境也做了主流升级（版本继续node12 已经淘汰了2-3年）

对于运行环境 第三方库的支持和 项目的 实现逻辑基于 commonjs 全面切换到 esm 为后面升级做了充分的准备

目前是继续nodejs 20lts做升级 20以前的版本已经全部都不维护了

之前构建的对比

如 fec yss等 目前预留下来的项目 没做升级的情况下导致了很多项目都无法正常运行 或者需要不断的改造才能适配

而且运行速度和效率都很低下导致严重影响正常的开发速度

所以构建工具的定期升级必要性还是有的 从研发效率上有大大提升

兼容性问题主要体现在 构建产物工具 和运行环境+第三方库支持两部分

产物是不断升级迭代的

随着主流浏览器升级 很多老代码都会被取代 如（cef升级到109后已经全面支持esm）

从运行速度和后续开发难度上都得到很好的改良

运行工具新功能不会基于非lts环境做适配 后续会导致很多想用的功能无法使用或者bug越来越多的问题

文档规范

1. 使用空格：在英文字母、数字和代码之间添加空格
2. 使用中文字符
3. 使用"你"代替"您"