ThinkChat🤖让你学习和工作更高效,注册即送10W Token,即刻开启你的AI之旅 广告
## 看云1024程序员节优惠活动! 先说个优惠活动信息。明天就是1024了,广大的程序员朋友们,看云限时折扣,你懂的…… 戳下面的链接吧,优惠多多哦。 [![](https://img.kancloud.cn/1d/6a/1d6a8ad517010b00ff3de4bb544dec1c_955x283.png)](https://www.kancloud.cn/activity/programmer1024) https://www.kancloud.cn/activity/programmer1024 ## :-: 使用场景 >[danger] ### 典型场景:说一说看云文档的内容规范 今天小编要来说一说的是文档的内容规范。有的朋友会说,文档的内容是用户自由创作的,需要什么规范呢。其实,有一些内容还是需要一些规范的,规范的文档无论是阅读还是维护都会非常方便。那就跟着小编一起来看看吧。 ### 目录层次 如果你的内容是有层次关系的,建议尽量用 `H2~H4` 标识区分,并且便于自动提取当前页的目录,除非特别必要,谨慎使用 `H1`,从 `H2` 开始是由于默认的样式 `H2` 带有一个下划线样式,很容易区分。 ![](http://box.kancloud.cn/document_2015-09-22_560117c8a31f0.png) > 对于H4以后的则不建议使用,可以考虑直接使用粗体替代。 不建议对H2~H4 再次使用粗体,例如: ![](http://box.kancloud.cn/document_2015-09-22_56011f0fa8143.png) > 相关的样式可以通过自定义样式来做一些调整,避免固化。 ### 代码 **代码部分确保使用代码标签**,否则可能导致页面显示出错或者某些内容被过滤、混淆而导致预览和阅读出现问题,例如下面的示例中使用了单行代码和多行代码标签: ![](http://box.kancloud.cn/document_2015-09-22_56011960c1b59.png) > 对于很长的内容或者中文内容尽量少用单行代码标签,因为单行代码标签没有自动换行样式支持。 ### 链接 内容中的URL地址会自动转换为超链接,无需使用链接标签,但是需要注意,链接URL地址前后必须加上空格,否则可能会有混淆。 正确的: > `广场地址 http://www.kancloud.cn/explore` 错误的: > `广场地址(http://www.kancloud.cn/explore)` ### 章节导航 对于较长的内容,建议采用 H2~H4 将内容层次化,并在开头或者需要的位置添加目录导航标识 `[TOC]`,效果如图: ![](http://box.kancloud.cn/document_2015-09-22_560123450b056.png) > 如果发现`[TOC]`标签无法正常解析,最好在前后添加一个空行。 ## 文档推荐: Java系统微优化权威指南 :-: ![](https://img.kancloud.cn/ad/90/ad904b3c4f6b6fa618be4668f7864f77_194x259.png) > 本书第8章和附录免费阅读. 本书介绍了如何对Java系统进行微优化,这来源于我多年对Java系统进行单机优化的经验,比如JD库存,JD最为核心的一个系统进行性能优化,使用这些方法,极大的优化了库存系统,还顺带优化了其他相关JD工具类。 我本人也是开源爱好者,个人Beetl和BeetlSQL也因为高性能和易用性得到国内外用户好评。 本书不空谈理论而是聚焦实战。涉及了Java方方面面常用知识,可以作为面试准备的教材。 如果喜欢阅读纸质书籍,可以在JD上找到《Java系统性能优化实战》 ### :-: 扫小程序码在线阅读 :-: ![](https://img.kancloud.cn/6b/b5/6bb55510c4a75be3d1bfed0071ce2808_320x320.png) ## :-: 每周问答精选 本周是小编整理出的问题最少的一周了,希望大家是真的都进步了。不过,帮助文档的链接也还是放在这里:[https://help.kancloud.cn](https://help.kancloud.cn/62409) 。大家有需要记得查看哦。 ### 问:看云的微信小程序不能用QQ登录,应该怎么办? 答:小程序只能用微信登录的。如果你的看云账号是QQ登录的,可以在网站绑定微信, 然后就可以在小程序同步阅读了。 ### 问:怎么建立看云文档目录层级? 答:请参考目录操作的相关文档: [https://help.kancloud.cn/41499](https://help.kancloud.cn/41499) ### 问:请问在看云上,哪里可以查看支付记录或者购买记录? 答:可以在发票的管理页面查看, 个人信息--发票管理。 ### 问:请问怎么给看云文档的作者留言? 答:可以给作者写评论。 ### 问:看云文档html下载下来是乱码,没有办法运行,这是怎么回事 ? 答:有时候是解压缩软件引起的,可以尝试换一个解压缩软件。 ### 问:购买看云文档可以开发票吗? 答:可以的,就在个人信息--发票管理 里面申请电子发票。 ### 问:请问在哪里发布看云文档? 答:请参考帮助文件:[https://help.kancloud.cn/41504](https://help.kancloud.cn/41504) ### 问:上传图片到看云文档,但是一直不成功,可能是什么问题? 答:使用外部图床的话,要在插件设置页面设置相关的存储参数。 ### 问:怎么让用户不用登陆就可以查阅看云文档? 答:把文档设置成公开文档就可以了。