中文技术文档的规范-标点符号

python使用TensorRT报错,多线程或多进程中使用问题 python使用TensorRT报错,Cuda Runtime问题 阅读详情

标点符号


原则


(1)中文语句的标点符号,均应该采取全角符号,这样可以与全角文字保持视觉的一致。

(2)如果整句为英文,则该句使用英文/半角标点。

(3)句号、问号、叹号、逗号、顿号、分号和冒号不得出现在一行之首。

句号


(1)中文语句的结尾处应该用全角句号(。)。

(2)句子末尾用括号加注时,句号应在括号之外。

错误:关于文件的输出,请参照第 1.3 节(见第 26 页。)

正确:关于文件的输出,请参照第 1.3 节(见第 26 页)。

逗号


(1)逗号(,)表示句子内部的一般性停顿。

(2)注意避免“一逗到底”,即整个段落除了结尾,全部停顿都使用逗号。

顿号
(1)句子内部的并列词,应该用全角顿号(、) 分隔,而不用逗号,即使并列词是英语也是如此。

错误:我最欣赏的科技公司有 Google, Facebook, 腾讯, 阿里和百度等。

正确:我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。

(2)英文句子中,并列词语之间使用半角逗号(,)分隔。

例句:Microsoft Office includes Word, Excel, PowerPoint, Outlook and other components.

(3)中文句子内部的并列词,最后一个尽量使用(和)来连接,使句子读起来更加连贯,下面两个句子都可以,第二个更优。

正确:我最欣赏的科技公司有 Google、Facebook、腾讯、阿里,以及百度等。

正确:我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。

分号


(1)分号(;)表示复句内部并列分句之间的停顿。

引号
(1)引用时,应该使用全角双引号(“ ”),注意前后双引号不同。

例句:许多人都认为客户服务的核心是“友好”和“专业”。

(2)引号里面还要用引号时,外面一层用双引号,里面一层用单引号(‘ ’),注意前后单引号不同。

例句:鲍勃解释道:“我要放音乐,可萨利说,‘不行!’。”

括号


(1)补充说明时,使用全角圆括号(()),括号前后不加空格。

例句:请确认所有的连接(电缆和接插件)均安装牢固。

(2)几种括号的中英文名称。

英文中文
{ }braces 或 curly brackets大括号
[ ]square brackets 或 brackets方括号
< >angled brackets尖括号
( )parentheses圆括号

冒号


(1)全角冒号(:)常用在需要解释的词语后边,引出解释和说明。

例句:请确认以下几项内容:时间、地点、活动名称和来宾数量。

(2)表示时间时,应使用半角冒号(:)。

例句:早上 8:00

省略号


(1)省略号(……)表示语句未完、或者语气的不连续。

(2)省略号占两个汉字空间、包含六个省略点,不要使用。。。或…等非标准形式。

(3)省略号不应与“等”这个词一起使用。

错误:我们为会餐准备了香蕉、苹果、梨…等各色水果。

正确:我们为会餐准备了各色水果,有香蕉、苹果、梨……

正确:我们为会餐准备了香蕉、苹果、梨等各色水果。

感叹号


(1)应该使用平静的语气叙述,尽量避免使用感叹号(!)。

(2)不得多个感叹号连用,比如!!和!!!。

破折号
(1)破折号————一般用于进一步解释。

(2)破折号应占两个汉字的位置。如果破折号本身只占一个汉字的位置,那么前后应该留出一个半角空格。

例句:直觉————尽管它并不总是可靠的————告诉我,这事可能出了些问题。

例句:直觉 —— 尽管它并不总是可靠的 —— 告诉我,这事可能出了些问题。

连接号


(1)连接号用于连接两个类似的词。

(2)以下场合应该使用直线连接号(-),占一个半角字符的位置。

  • 两个名词的复合
  • 图表编号
例句:氧化-还原反应

例句:图 1-1

(3)数值范围(例如日期、时间或数字)应该使用波浪连接号(~),占一个全角字符的位置。

例句:2009 年~2011 年
注意,波浪连接号前后两个值都应该加上单位。

(4)波浪连接号也可以用汉字“至”代替。

例句:周围温度:-20°C 至 -10°C
快速搭建SpringBoot3+Vue3+ElementPlus管理系统 快速搭建SpringBoot3+Vue3管理系统前端项目搭建(默认开发环境:node20,Jdk17)创建项目并下载依赖--执行以下命令 前端项目搭建(默认开发环境:node20,Jdk17) 创建项目并下载依赖–执行以下命令 创建项目 yarn create vite admin-vue --template 2.下载依赖(也可按需下载) yarn add echarts --save yarn add vue-router --save yarn add element-plus --save y 阅读详情

相关推荐

Rockchip平台之RK3566/3568 OS02N10

文章摘要 本文主要介绍了200W摄像头传感器OS02N10在RK3566平台上的兼容与适配过程。作者基于之前的400W摄像头兼容经验,针对200W摄像头进行了类似的适配工作。文章详细阐述了RK3566芯片的特性和OS02N10传感器的技术参数,包括分辨率、接口和功耗等。适配过程分为三个关键部分:DTS设备树文件配置(定义I2C地址、电源域和GPIO控制等)、驱动文件开发(寄存器初始化和操作)以及XML和JSON配置文件调整(图像参数设置)。作者特别强调了初始化数组中空寄存器终止条件的重要性,并分享了兼容过程

different_xzh的博客 2412

中文技术文档的写作规范

本文转载自 https://github.com/ruanyf/document-style-guide 中文技术文档的写作规范 文档结构 文件名 标题 层级 原则 段落 原则 引用 文本 字间距 句子 写作风格 英文处理 数值 半角数字 千分号 货币 数值范围 变化程度的表示法 标点符号 原则 句号 逗号 顿号 分号 引号 圆括号 冒号 省略号 感叹号 破折号 ...

weixin_30667649的博客 593

基于java的汉服商城管理系统设计与实现的详细项目实例

本文介绍了一个基于Java的汉服商城管理系统设计与实现项目。该项目采用三层架构设计,包含用户模块、商品管理、订单处理、支付结算等核心功能,支持多角色权限控制和响应式前端界面。 系统创新点包括: 专业化的汉服商品管理,支持多规格属性组合 高并发订单处理机制,确保库存实时同步 个性化智能推荐算法提升用户体验 细粒度权限控制保障系统安全 项目采用SpringBoot+MyBatis技术栈,前端使用React框架实现跨设备兼容。数据库设计包含用户表、商品表、订单表等10个核心表,通过事务管理确保数据一致性。 系统解

优质创作者: 人工智能技术领域 对于有一定基础的 MATLAB和Python带具体需求都可以详谈 MATLAB和Python可以提供代码调试服务加油 谢谢 你的鼓励是我前行的动力 谢谢支持 加油 谢谢 803

论文格式

论文题目//黑体,3号,粗体 作者//仿宋_GB2312,小4号使用“作者”样式。姓名是两个字的,中间用一个中文空格或两个英文空格隔开。只有一个作者的,且作者姓名字数为三个的(包括三个的),姓名的每个字之间用一个英文空格隔开。 关于作者简介//宋体,小5号通栏,使用“收稿日期”样式。在文章的第一页下方通栏,可附一段说明,内容包括收稿日期、基金项目、第一作者姓名、职称、主研领域等。多个研究领域之间使...

qq_44843403的博客 1万+

Angular 相关的知识点和项目汇总

Angular 知识点和项目汇总

weixin_45428910的博客 578

30分钟搭建AI科研写作工作台:基于WorkBuddy的论文全流程加速实践

在人工智能技术日益普及的今天,如何利用智能工具提升专业领域工作效率成为关键课题。其核心原理在于通过模块化设计,将复杂的任务流程拆解为可复用、可编排的标准化技能单元,并结合精准的指令控制,实现从通用对话到深度任务执行的转变。这一技术价值在于显著降低重复性劳动强度,将人的创造力聚焦于核心决策与创新环节。在科研写作、数据分析、代码开发等场景中,这类智能工作台能有效辅助完成文献调研、内容生成、格式校验等繁琐步骤。本文以科研论文写作为具体应用场景,深入探讨如何利用WorkBuddy这一智能工作台,通过配置核心科研技能

weixin_29032489的博客 1466

中文的括号和英文的括号区别_What?标点符号也扣分?写好一篇英文高分文章太难了!...

说起标点符号难免会有“鸡肋”之感?不注意吧平时写作总少不了尤其中英标点不小心打错了那就难免尴尬注意吧又太容易忽略更不知道该从什么改起(不知道多少人的标点符号的用法还是套用的国内学的那些基础知识)英文标点符号后加不加空格?中文常用的顿号、书名号以及省略号在英文中能用么?长短“杠杠”怎么用?逗号可以随意添加么?……相信这些问题经常困扰着大家,今天我们就来聊聊标点符号!标点符号虽然很小,但在书...

weixin_39666931的博客 1万+

手把手教你用8位单片机IO口直接驱动WS2812灯带(附完整代码和避坑指南)

本文详细介绍了如何使用8位单片机IO口直接驱动WS2812灯带,包括硬件准备、时序生成、色彩引擎与特效算法的实现,以及调试技巧与性能优化。通过汇编语言优化和精确时序控制,实现高效的LED驱动和炫酷的彩虹灯效,适合嵌入式开发者和硬件爱好者参考。

weixin_42696271的博客 304

[word] word文档中中英文全角和半角有什么区别? #知识分享#笔记

下图第一行为中文全角状态下输入的汉字、符号、数字,第二行为中文半角状态下输入的汉字、符号、数字。“”等标点符号时全角和半角显示状态是相同的,字符宽度一致;而输入@~#等符号以及123等数字时,中文全角状态下输入的字符宽度更宽,中文半角状态下输入的字符宽度更窄。从下图可以看出,在英文全角状态下句子最后面的句号字符宽度更宽,而英文半角状态下的句号字符宽度更窄。通常情况下全角状态下输入一个字符会占用两个字符的位置,半角状态下输入一个字符会占用一个字符的位置,全角字符比半角字符更宽,但是也不尽然。

2401_82667983的博客 7837

当R语言遇见MaxENT:参数优化的艺术与自动化调参实践

本文探讨了R语言与MaxENT在生态位建模中的结合应用,重点介绍了参数优化与自动化调参的实践方法。通过caret与ENMeval工具链,研究人员可以高效处理多物种、多环境变量的大规模分析任务,提升模型性能与工作效率。文章还涵盖了从数据准备到结果可视化的全流程,为生态学家提供了实用的技术指导。

corn8的博客 455

[技术解析] SGDC驱动的轻量级IoT入侵检测:特征选择与模型优化的实战指南

本文深入解析了如何利用SGDC驱动的轻量级入侵检测系统保护IoT设备安全。通过实战指南,详细阐述了SGDC模型在资源受限环境下的优势,并结合特征选择技术优化模型性能,实现高效、低耗的异常流量检测,为物联网安全部署提供了一套可行的解决方案。

weixin_29192211的博客 350

【中文技术文档的写作规范_P03】如何书写标点符号和控制文档体系

通过本文,你将了解到中文技术文档中标点符号和文档体系的写法。 文章目录标点符号原则句号逗号顿号分号引号括号冒号省略号感叹号破折号连接号文档体系结构文件名 标点符号 原则 (1)中文语句的标点符号,均应该采取全角符号,这样可以与全角文字保持视觉的一致。 (2)如果整句为英文,则该句使用英文/半角标点。 (3)句号、问号、叹号、逗号、顿号、分号和冒号不得出现在一行之首。 句号 (1)中文语句的结尾处应...

极客-多重人格递归 1512

【APM】在Kubernetes中,使用Helm安装Grafana 9.5.1

Grafana是一款流行的开源数据可视化和分析平台,它特别擅长处理时序数据,即随时间变化的数据,因此在监控系统性能、应用程序指标、物联网(IoT)设备数据等领域有着广泛的应用。

CN_Eden 1200

技术文档写作规范:GCTT 中文文案排版指南详解

在技术文档写作中,良好的排版规范不仅能提升文档的专业性,还能显著改善读者的阅读体验。本文将深入解析 GCTT 项目中的中文文案排版规范,帮助技术写作者掌握专业的中文技术文档写作技巧。 ## 空格使用规范 ### 中英文混排时的空格规则 在技术文档中,中英文混排极为常见。正确的做法是: - 中文与英文之间增加一个空格 - 中文与数字之间增加一个空格 - 数字与单位之间增加一个空格 示例: ...

gitblog_00268的博客 610

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

中文技术文档写作规范【转载】

标题 层级 标题分为四级。 一级标题:文章的标题 二级标题:文章主要部分的大标题 三级标题:二级标题下面一级的小标题 四级标题:三级标题下面某一方面的小标题 原则 一级标题下,不能直接出现三级标题。 标题要避免孤立编号(即同级标题只有一个)。 下级标题不重复上一级标题的内容。 谨慎使用四级标题,尽量避免出现,保持层级的简单和防止出现过于复杂的章节。...

weixin_30929195的博客 329

SAP B1中文培訓教材_SDK

公司内部培训资料,对开发工具 ,DIAPI, UIAPI,Add-ON有详细解说

pangu.js 快速入门指南:10分钟掌握文本格式化神器

pangu.js 是一款强大的文本格式化工具,专门用于优化中文排版和文本格式。这款 JavaScript 库能够智能地在中文与英文、数字之间添加适当的空格,让文本阅读体验更加舒适和专业。 ## ✨ 什么是pangu.js? pangu.js 是一款**文本格式化神器**,主要解决中文排版中常见的格式问题。它能自动在中英文之间添加空格,规范标点符号使用,让文本看起来更加整洁美观。 ## 🚀

gitblog_00915的博客 883

OV9734 DATASHEET,完整规格书

OV9734完整规格书,包括电气参数,尺寸规格,寄存器配置表等

终极中文文案排版指北:从空格到标点的完整教程

中文文案排版指北是一份帮助你规范中文写作格式的实用指南,旨在统一中文文案、排版的相关用法,降低团队成员之间的沟通成本,增强网站气质。无论是日常写作、自媒体运营还是专业文档撰写,掌握这些规范都能让你的文字更加专业易读。 ## 为什么要重视中文排版? 「有研究显示,打字的时候不喜欢在中文和英文之间加空格的人,感情路都走得很辛苦,有七成的比例会在 34 岁的时候跟自己不爱的人结婚,而其余三成的人最后

gitblog_00053的博客 428

如何使用 zhlint:提升中文文本质量的终极工具

zhlint 是一个强大的中文内容格式化工具,能够自动检测并修复中文文本中的格式问题,包括标点符号统一、中英文之间空格处理等,帮助用户轻松提升文本质量。 ## 🚀 快速安装指南 您可以通过 npm、yarn 或 pnpm 快速安装 zhlint: ```bash # 通过 npm 安装 npm install zhlint -g # 或通过 yarn yarn global add zh

gitblog_00090的博客 469

如何用lint-md自动检测并修复中文Markdown格式错误?超实用工具推荐

在日常撰写中文博客或技术文档时,你是否常因中英文空格、标点符号不规范等格式问题烦恼?**lint-md** 作为一款专为中文Markdown设计的格式校验命令行工具,基于AST技术深度检查文档,能帮你自动识别并修复多种常见格式错误,让文档质量提升一个档次!无论是个人写作还是团队协作,它都能轻松集成到CI流程,成为你写博客和文档的必备助手。 ## 为什么选择lint-md?5大核心优势解析 ##...

gitblog_00319的博客 942

中文技术文档的写作规范(搬运)

阮一峰老师的《中文技术文档的写作规范》搬运。等七大方面进行了简明扼要的介绍。内容:对中文技术文档从。

m0_37412775的博客 724

如何写好技术文档 - 排版格式和规范(一)

本文参考谷歌开发文档风格指南、Vue官方文档、React官方文档、掘金小册和阮一峰《中文技术文档的写作规范》,其中排版格式,主要参照Vue、React官网,写作规范部分主要参考阮一峰老师的《中文技术文档的写作规范》。编写技术文档除了排版格式和规范,思路和风格也极为重要,目前一些亲和、幽默的写作风格往往能获得更多的阅读量。技术文档通常使用markdown编写,所以后面的内容都是针对Markdown文档进行排版。同时排版格式和写作规范有很多重合部分,所以放在一篇文章说明。

程序员李林 9403
上一篇: 中文技术文档的规范-数值
下一篇: 中文技术文档的规范-文档体系
happytaohaha
博客等级 码龄9年 37粉丝 187原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值