## 看云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)
### 问:上传图片到看云文档,但是一直不成功,可能是什么问题?
答:使用外部图床的话,要在插件设置页面设置相关的存储参数。
### 问:怎么让用户不用登陆就可以查阅看云文档?
答:把文档设置成公开文档就可以了。
- 每周推荐20200612
- 每周推荐20200619
- 每周推荐20200703
- 每周推荐20200710
- 每周推荐20200717
- 每周推荐20200724
- 每周推荐20200807
- 每周推荐20200814
- 每周推荐20200821
- 每周推荐20200828
- 每周推荐20200904
- 每周推荐20200918
- 每周推荐20200925
- 国庆活动
- 每周推荐20201009
- 每周推荐20201016
- 每周推荐20201023
- 每周推荐20201030
- 每周推荐20201106
- 每周推荐20201113
- 每周推荐20201120
- 每周推荐20201127
- 每周推荐20201204
- 每周推荐20201211
- 每周推荐20201218
- 每周推荐20201225
- 每周推荐20210101
- 每周推荐20210115
- 每周推荐20210122
- 每周推荐20210129
- 每周推荐20210226
- 每周推荐20210305
- 每周推荐20210312
- 每周推荐20210319
- 每周推荐20210326