Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
7427bfa5
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
7427bfa5
编写于
6月 07, 2023
作者:
zyjhandsome
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
贡献文档 > 文档风格中,新增“示例代码风格”
Signed-off-by:
zyjhandsome
<
zyjhandsome@126.com
>
上级
99c9d6c4
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
7 addition
and
82 deletion
+7
-82
zh-cn/contribute/style-guide/style-guide-content-elements.md
zh-cn/contribute/style-guide/style-guide-content-elements.md
+3
-36
zh-cn/contribute/style-guide/style-guide-example-code-style.md
.../contribute/style-guide/style-guide-example-code-style.md
+4
-46
未找到文件。
zh-cn/contribute/style-guide/style-guide-content-elements.md
浏览文件 @
7427bfa5
...
...
@@ -157,7 +157,7 @@
-
链接到其他站点:
\[
示例]
\(
www.example.com)
|
**正例**
|
**反例**
|
| --------
|
-------- |
| --------
--------------------------------------------------- | ----------------------------------------------
-------- |
| 请参见
\[
OpenHarmony开源项目](https://gitee.com/openharmony) | OpenHarmony开源项目请参见https://gitee.com/openharmony |
...
...
@@ -315,40 +315,7 @@
## 代码与注释
### 行内代码
【规则】对于正文描述中涉及代码的内容,比如实际代码中的方法名、参数名或代码文件名等,使用
`包裹显示。
| 正例 | 反例 |
| -------- | -------- |
| 在`
index.js
`文件中实现页面跳转。 | 在index.js文件中实现页面跳转。 |
### 代码块
【规则】对代码示例、命令行使用代码样式。在Markdown中,使用`
``
呈现代码样式,同时指定语言类型。

【规则】代码块内容应符合对应语言的通用编程规范。
【规则】完整举例中的代码块复制后可直接执行,且执行结果与文档描述一致。
【规则】如果代码块中没有标识行号,则不添加行号标识。
【规则】代码块显示符合缩进要求。
【建议】代码块中的关键代码段提供注释说明。
### 注释
【规则】适时为代码块添加注释,特别是有解释说明、开发建议或注意事项的位置。恰当的注释可有效提升代码块可读性,帮助开发者快速掌握开发过程。
【规则】注释符与代码块语法保持一致,禁止自创注释符。注释符与注释内容间统一添加一个空格。例如:对于JavaScript代码块,注释写法为“// 注释内容”。
【规则】当一行注释内容过长时,注意断句切分到下一行呈现。
请参见
[
示例代码风格
](
style-guide-example-code-style.md
)
。
## IP及MAC地址
...
...
zh-cn/contribute/style-guide/style-guide-example-code-style.md
浏览文件 @
7427bfa5
# 文档示例代码风格
本文参考了业界的标准规范和最佳实践,旨在提高文档示例代码的可读性、可维护性,以及风格一致性,以增强开发者的使用体验。
本文旨在为OpenHarmony指南和API参考中的设计和内容作者提供示例代码风格指导。适用于包括ArkTS、JavaScript和C等编程语言的示例代码片段。
# 示例代码风格
本文参考了业界的标准规范和最佳实践,旨在提高OpenHarmony文档示例代码的可读性、可维护性,以及风格一致性,适用于包括ArkTS、JavaScript和C/C++等编程语言的示例代码片段。
## 代码规范
...
...
@@ -9,7 +7,7 @@
【描述】
文档的示例代码需要遵循
[
JavaScript语言编程规范
](
../OpenHarmony-JavaScript-coding-style-guide.md
)
、
[
C语言编程规范
](
../OpenHarmony-c-coding-style-guide.md
)
基本的编码规范,包括命名规范、代码格式和代码规范等。
文档的示例代码需要遵循
[
JavaScript语言编程规范
](
../OpenHarmony-JavaScript-coding-style-guide.md
)
、
[
C语言编程规范
](
../OpenHarmony-c-coding-style-guide.md
)
和
[
C++语言编程规范
](
../OpenHarmony-cpp-coding-style-guide.md
)
基本的编码规范,包括命名规范、代码格式和代码规范等。
### 【规则】每个接口(包括方法和组件)均需要提供示例代码
...
...
@@ -149,47 +147,7 @@ Text('Hello World')
代码染色是指在编辑器中对代码进行不同颜色的标记,以区分不同语法元素的功能。例如在编辑器中对不同的关键字、变量名、注释等使用不同的颜色进行标记,可以让代码更加易读易懂。
【正例】
```ts
let message: string = 'Hello World';
console.info(message);
```
```json
{
"module": {
...
"abilities": [
{
"launchType": "singleton",
...
}
]
}
}
```
【反例】
```
let message: string = 'Hello World';
console.info(message);
```
```
{
"module": {
...
"abilities": [
{
"launchType": "singleton",
...
}
]
}
}
```

### 【规则】代码格式化
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录