Typesetting math: 100%

蒟蒻的代码规范与文档编写规范

代码规范

  1. 代码每行不得超过 80 个字符
  2. 代码不分块连续编写且每一个模块不允许超过 100 行
  3. 双目运算符运算对象与运算符之间一定要分别打一个空格单目运算符与运算对象之间不打空格
  4. 禁止使用 Tab 缩进使用 2 空格缩进代码
  5. 宏定义时没有缩进
  6. 基本使用 Java 代码风格如果在 forif 后只有一两个语句尽量不使用大括号包围如果一定要使用大括号则尽量压行书写
  7. 模块化的代码提倡代码宽而短不提倡瘦长的代码风格
  8. 没有通用的头文件随用随加
  9. 尽量开局部变量减少全局变量的使用
  10. 大块的内存空间随用随开用完后立即释放并且设置为空指针
  11. 尽量使用指针书写代码以便提高代码执行效率和可读性
  12. 除递归调用的所有其它函数都使用 inline 以加快执行效率
  13. 所有函数参数如非必要均使用传址或传指针的方式以减小拷贝构造带来常数且能够使用 const 修饰的均应使用 const 进行修饰
  14. 类型名的修饰符如取地址符解指针符等采用较为随意的方式node *foo指针指向的对象, node* &foo需要修改指针, node* foo指针本来的含义 这三种写法都是可以的以容易理解为前提因为不同时期的代码风格不太一样就只有这个地方一直统一不起来
  15. 所有的函数名尽量采用驼峰命名法readIn()特别地对于一些模板性的函数则使用其较为广泛使用的名称SPFATreap对于重写的一些库函数则使用相应的命名方式

文档格式

好好写文档就行了排版什么的暂时由 Han.js 负责但是在书写时注意以下几点

  1. 正确使用中文全角标点符号通常习惯使用 来提高中文引号的辨识度同时也常用分号来表示列表环境中各复句之间的关系正确使用示例如下
  • 中学生学科竞赛主要包括信息学奥林匹克竞赛信息学奥林匹克竞赛信息学奥林匹克竞赛信息学奥林匹克竞赛和信息学奥林匹克竞赛我就是这个样你来打我啊
  • “你吃了吗李四问张三
  • 我想对你说“我真是太喜欢你了
  • 苟利国家生死以岂因祸福避趋之
  • 推荐题目LOJ #104 普通平衡树
  • 以下是这个算法的基本流程
    • 第一步初始化到各点的距离为无穷大将所有点设置为未被访问过初始化队列
    • 第二步将起点放入队列将起点设置为已被访问过更新到起点的距离为 00
    • 第三步取出队首元素将该元素设置为未被访问过
    • 第四步遍历所有与此元素相连的边若到这个点存在更短的距离则进行松弛操作
    • 第五步若这个点未被访问过则将这个点放入队列且设置这个点为已经访问过
    • 第六步回到第三步直到队列为空
  1. LaTeX 定义好了的常量与函数名直接用所有的函数名常量均应使用 Roman 体
  2. 如果遇到没有预先定义好的需要使用 Roman 体的函数名我们可以使用 \operatorname{something} 来产生如我们可以使用
    \operatorname{lcm}
    
    产生正体的最小公倍数函数符号lcm(1,2)lcm(1,2)产生 Roman 体的常量应用 \mathrm{}其他非数学内容包括中文英文特殊符号等一律使用 \text{}
  3. 绝对不能滥用公式字体
  4. 表示强调时请使用 **SOMETHING** 而非某级标题
  5. 全角字符汉字假名谚文等与半角字符英文字母阿拉伯数字公式之间添加一个半角空格特别地对于半角字符前后出现全角标点的情况不需要添加多余的半角空格类似地对于英文的半角标点请在标点后添加一个半角空格请参考下面的例子
  • 对于一元二次方程 ax2+bx+c=0ax2+bx+c=0我们设 Δ=b24acΔ=b24ac 为二次方程的判别式Δ0Δ0则说明方程有实数根
  • 我要把贡献者的 Pull Request 合并到 master 分支上了
  • B 站的 22 娘和 33 娘真是太萌了!
  • The quick brown fox jumps over a lazy dog. I can eat glass, it doesn't hurt me.
  1. 所有用作序号的数字建议使用中文
  2. 从不使用段首缩进这种操作
  3. 所有用作序号的数字建议使用中文
  4. LaTeX 的每个逗号后都需要补上一个宽度为 0.25em 的空格 \,

测试一波 Han.jscss

内容群组类

段落清单

好们论红手却策下使住收否人人大获及是告另子维持力本清长先阳不社相此国学风中麽很解治子上己施一见有的是用关快家所的字时情品好居…… 朋里义四时校叫洲运细种眼失妈母身古慢管用上开家问不难成的装望麽年单代操会人得人人传在善美故全推两少关心求下看同目国往成气一广机亲得飞先始们於观他使难以该因口发汽机人都领了过大广场不食收西物早社报子们看卖像师对好情的神在史评来深放表观还人的西路尽热程当人长质此中民龙证说念背生外间今经气门此都把相的公去底动

头性空风後上他根然任他在社拉布会言了来石赛亲支…… 情拉术北然使来路请放数坐灯麽象成一画专雨是我长无等爱五化客可杂有雨

诗篇段落

地址格式

有序清单

  1. 一级清单项目
  2. 一级清单项目
    1. 二级清单项目
    2. 二级清单项目
      1. 三级清单项目
      2. 三级清单项目
  3. 一级清单项目
  4. 一级清单项目

无序清单

  • 一级清单项目
  • 一级清单项目
    • 二级清单项目
    • 二级清单项目
      • 三级清单项目
      • 三级清单项目
  • 一级清单项目
  • 一级清单项目

引用区块

如事时决行入同是我表统支乐了先年人目也月老过人断弟进石给了服去孩没性就能边年排不决广之例长收满导无

——姜庆石人码头

未使用段落元素的引用区块

时来数期没道反先美别所金企感企妈失对谈
——新器急

引用区块中的引用区块

洲此境眼…… 方空车形四用厂出先作管济所唱步取的成正候社取开取高理景龙知子起配做心正道动出令正或家国前保严轻朋化下而府里基之称失等园华行…… 政生着曾们然变不发甚故些长小华从不代应头资

以满伤都片复利反尔麽生任常弟但岸过年在院投工变爱世总甚天其有爸个後轻取在克的山知中识高於过叫行出面不大开受个说自经公目学们湾合好巴地尽性士面最产张子新容得实眼不日野一克节上人党到有没她果以的是到影的请自人长表本究政快的且造的推色究听场广人形深了叫

图表内的引用区块

令会过作加身管常虽质湾人坐洋半以人问一文…… 上湾之会的面长东商实对了上修法或便纸界去定办紧现生影都合否陆一片子处用上很

这是图表解说元素<figcaption>内的解说

格式预处理文字区块

国写亲下二好湾整机生土、是看老排让和保艺车市。
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et me.
是除学图宝济候收。们性者位远另象内未院清外了以共……
长明期事生合了中文新等麽科出过能意等件教求加,
楼日里大下果个来。
球者们?方绿电後,果或错老际声可特少保期全动带东北建,似保助先走她合也的。神我兴治的保保学果车易麽连学水小西一!而视可些化。

代码区块

void (function(a,b){var c=b.documentElement,d,e;function D(a,d) {d=a*d/100+b.getElementById("main").textContent;return d;}return new D(20,5);})(window||this,window.document);

章节类

文章区块元素

文章区块内的段落清单

务用界种设是自水教台保再计见所湾们民各外超是人外每方後发他济中义生了出这失究式回值气苦我花声位香还场外国的医门

诗篇段落

清单

  • 清单项目子
  • 清单项目丑

文章区块内的重点

不做则中心与的说很笔分士校此诉平是里春家善客总外公做南多中足酒脸理特指第常三紧资现工们家化民公政我热良中以家是

文章区块内的图表引用区块

令会过作加身管常虽质湾人坐洋半以人问一文…… 上湾之会的面长东商实对了上修法或便纸界去定办紧现生影都合否陆一片子处用上很

这是文章内图表解说元素<figcaption>的解说

文章区块内的变音文字

来化相据取爱统单商商半是否的妈没种试此助来精人是湾价种下落有机信际作假湾心行程官这是运价车年都人强国农特行解金产拉口……

文章内的引用区块

火说定好就用树表母微时艺出北亲双表人事为放爸车奇列长农时教产得地何高的举度们她李力内体古见业选一香音种

务用界种设是自水教台保再计见所湾们民各外超是人外每方後发他济中义生了出这失究式回值气苦我花声位香还场外国的医门

文章内引用区块中的引用区块

洲此境眼…… 方空车形四用厂出先作管济所唱步取的成正候社取开取高理景龙知子起配做心正道动出令正或家国前保严轻朋化下而府里基之称失等园华行…… 政生着曾们然变不发甚故些长小华从不代应头资

以满伤都片复利反尔麽生任常弟但岸过年在院投工变爱世总甚天其有爸个後轻取在克的山知中识高於过叫行出面不大开受个说自经公目学们湾合好巴地尽性士面最产张子新容得实眼不日野一克节上人党到有没她果以的是到影的请自人长表本究政快的且造的推色究听场广人形深了叫

文章引用区块内的重点

不做则中心与的说很笔分士校此诉平是里春家善客总外公做南多中足酒脸理特指第常三紧资现工们家化民公政我热良中以家是

文章引用区块内的变音文字

来化相据取爱统单商商半是否的妈没种试此助来精人是湾价种下落有机信际作假湾心行程官这是运价车年都人强国农特行解金产拉口……

字级语意类

超连结元素 a 示例
注记元素 u 示例
注记元素甲注记元素乙一般文字节点注记元素丙一般文字节点注记元素丁
来源元素 cite 示例
重点元素 strong 示例
术语元素 dfn 示例
关键字元素 b 示例
强调元素 em 示例
变音文字元素 i 示例
变数元素 var 示例
引用元素 q子引用 q 元素示例
讹讯元素 s 示例
讹讯元素甲讹讯元素乙一般文字节点讹讯元素丙一般文字节点讹讯元素丁
代码元素code示例
输入键元素 kbd 示例
计算机输出示例元素 samp 示例
行间注元素 ruby annotation 示例
复合式行间注 hángjiānzhù 元素 yuansuruby annotation
直角ㄏㄤˊㄐㄧㄢㄓㄨˋhángjiānzhùㄩㄢˊㄙㄨˋyuánsù

其他

缩写元素 abbr包含标题属性的缩写元素 abbr 示例
凸显元素 mark 示例
批注元素 small 示例
文字范围元素 span 示例
下标元素 sub 示例
上标元素 sup 示例

修订类

增订元素 ins 示例
增订元素甲增订元素乙一般文字节点增订元素丙一般文字节点增订元素丁
删订元素 del 示例
删订元素甲删订元素乙一般文字节点删订元素丙一般文字节点删订元素丁

特殊排版功能

汉字西文混排间隙

然而在 Jan Tschichold 和他的着作 Asymmetric Typography 流行之前直至追溯回 Gutenberg 时代对称齐整两种古老的视觉审美习惯无处不在左右并齐的纵栏——我也欣赏这样的传统一如欣赏古典格律的稳定及优美

地区变体字型及标点符号样式

此处仅展示黑体其馀字体样式请参阅其他测试页

台湾教育部式

中国国标式

ㆢㄧㆴ͘ㄒㄧㆩjp-siann

posted @   baka  阅读 (978)  评论 (0编辑  收藏  举报
编辑推荐:
· 深入理解 Mybatis 分库分表执行原理
· 如何打造一个高并发系统?
· .NET Core GC 压缩 (compact_phase) 底层原理浅谈
· 现代计算机视觉入门之:什么是图片特征编码
· .NET 9 new features-C#13 新的锁类型和语义
阅读排行:
· Spring AI + Ollama 实现 deepseek-r1 的 API 服务和调用
· 《HelloGitHub》第 106 期
· 数据库服务器 SQL Server 版本升级公告
· 深入理解 Mybatis 分库分表执行原理
· 使用 Dify + LLM 构建精确任务处理应用
点击右上角即可分享
微信分享提示