RW-API-Code/docs/DEV.md

3.9 KiB
Raw Blame History

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扩展格式

!> 注意文本
?> 小提示文本
> [!WARNING] 警告文本
> [!NOTE] 笔记文本
> [!TIP] 重要提示文本
> [!ATTENTION] 不推荐文本

注意以下必须在START-END内进行使用才能生效,
且将chat后面的"*"换为空格:
<!--chat*:start -->
#### **tobby3600**
我是第一个消息文本
#### **JDSALing**
我是第二个消息文本
<!--chat*:end -->

实际生成代码:
<!-- chat:start -->
#### **tobby3600**
我是第一个消息文本
#### **JDSALing**
我是第二个消息文本
<!-- chat:end -->

其他说明:

有关于MarkDown的其他书写格式请参考MD书写规范
MD文档参考--点我立刻学习

附加说明:

由于插件众多为避免MD格式冲突换行建议最好使用<br>进行换行,
如果要在一些扩展格式渲染演示,请使用<font>标签,

部署策略:

!> 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给我

!> 该文档可能还有很多缺陷如果你有更好的建议请发送Issues或者PR给我。

?> 编写于2023-2-25 RTS-Code-API[第一版-修订2版]