RTS-Code-API---开发规范

> [!TIP] 0.如果你确定你想帮忙开发此站点,
就可以点击右上角的Github按钮,Clone我们的库
编写代码并进行PR申请,我非常感谢你的帮忙,感谢各位的支持与帮助。
> 1.确保代码的解释通俗易懂,能让新手迅速入门
2.编写的代码应该以以下格式进行: >

代码的格式编写规范:

1.代码的英文名和附属信息(参考站点已添加的代码例子)
2.代码的简介
3.代码的要点指示
4.代码的演示例子
5.代码的扩展例子(可选)
6.GIF演示/视频演示(可选) > [!TIP] 使用外部资源时,请使用支持HTTPS协议的资源地址传输。
否则在Google Chrome等一系列以CEF的内核上会因为强制替换HTTPS导致资源无法打开。 > [!WARNING] 不能使用过于高深的说明,严禁出现谜语人话语,无用话语,任何玩梗, 夹带私货等一系列与本站无关的东西,违者将不能通过PR审核 > [!WARNING] 有一些代码或许有一些新的写法,或该写法可能已经废弃,如果遇到这些代码,编写者需要注明,并提供推荐代码。 !> 为了更好的方便一起编写站点的贡献者,本站点提供了以下的扩展MD格式供各位书写 #### MD扩展格式: ```bash !> 注意文本 ?> 小提示文本 > [!WARNING] 警告文本 > [!NOTE] 笔记文本 > [!TIP] 重要提示文本 > [!ATTENTION] 不推荐文本 注意:以下必须在START-END内进行使用才能生效, 且将chat后面的"*"换为空格: #### **tobby3600** 我是第一个消息文本 #### **JDSALing** 我是第二个消息文本 实际生成代码: #### **tobby3600** 我是第一个消息文本 #### **JDSALing** 我是第二个消息文本 ``` #### 其他说明: 有关于MarkDown的其他书写格式,请参考MD书写规范 [MD文档参考--点我立刻学习](https://docs.github.com/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) #### 附加说明: ```txt 由于插件众多,为避免MD格式冲突,换行建议最好使用
进行换行, 如果要在一些扩展格式渲染演示,请使用标签, ``` #### 部署策略: !> 1.本地部署 > [!NOTE] 如果要本地测试,请确保设备有Node.js 并在项目根目录使用以下命令:
> npm i docsify-cli -g
docsify serve docs !> 2.Netlify部署 > [!NOTE] 如果你已经发送了PR请求,可以通过我的Netlify预览站点进行预览,
Netlify会在你的PR请求下面显示你的预览页面地址。
如下图所示,点击😎 Deploy Preview后面的链接即可看见效果
由于某些原因,TX会拦截Netlify的站点,请使用浏览器预览。 #### 实际格式演示: !> 注意文本 ?> 小提示文本 > [!WARNING] 警告文本 > [!NOTE] 笔记文本 > [!TIP] 重要提示文本 > [!ATTENTION] 不推荐文本 #### **tobby3600** 我是第一个消息文本 #### **JDSALing** 我是第二个消息文本 > [!TIP] 如果要添加你的聊天MD头像和名字,请发送Issues给我 #### 单位代码文档推荐格式: ```markdown ### xxxx #### xxxx-代码简介 ?> 代码:xxxx 中文释义:xxxx 类型:xxxx 隶属于:xxxx > [!TIP] xxxxxx #### 视频/GIF演示---(可选) #### 聊天气泡[追加内容]---(可选) #### xxxx代码-演示例子 ***ini xxxx *** ``` #### 表格推荐格式 ### 代码演示: |A|B|C| |-|-|- |1|2|3| ### 代码例子: ```markdown |A|B|C| |-|-|- |1|2|3| ``` 如果你仍然不会Markdown表格写法,这里给你一个链接:

TableConvert-MD-点击进入

### 扩展写法(高级) 有一些时候,我们可能需要在已经标记的后面再添加东西, 但Markdown解析方式在标签后面再有一个标签就不会识别了。 所以这里我们必须直接使用原生Html的代码, 通过浏览器的检查元素,你应该能迅速找到模块框架, 将它的模块元素区域复制下来,并调用。 !> 该文档可能还有很多缺陷,如果你有更好的建议,请发送Issues或者PR给我。 ?> 编写于2023-3-9 RTS-Code-API[第2版-第2次修订]