预览:GitBook tips-ios @ GitBook
备注:GitBook 更新了新版样式,没有之前的样式好看(之前的样式参考:http://android.developerdocumentation.cn),而且在 URL 路径上面的处理不太一样了,不像之前一样是通过你的文件夹和文件名来匹配,而是分析首行文字,如果是中文的话,会转化成中文对应的拼音,我觉得这个做法很难受,不喜欢这种“自以为是”的处理方式,相当于我们想要自定义 URL 的话,我的首行文字必须要和 URL 一样的内容。新用户注册 GitBook 已经是强制要求使用新的样式了,老用户如果你在组织底下点击升级到新的 GitBook,就回不去了。但是个人账号底下还是可以采用旧的样式,可以通过访问 legacy.gitbook.com 的方式来处理。新版本目前唯一的亮点就是增强了搜索功能。
后期我们可以在自己的服务器架设 GitBook 服务,采用之前的样式。
搜索:在 GitHub 中搜索当前仓库,在 GitBook 中搜索当前电子书(推荐)。
tip:n.小窍门;小提醒
在 tips-android 中,我们可以将 tips 理解为“小知识点”的意思。此仓库是用来记录 Android 开发者在实际开发过程中所遇到各种“小知识点”,也为其他 Android 开发者提供相关的参考,让彼此了解更多的 Android 开发的“小知识点”。
该“小知识点”属于哪一个分类,追加到对应的文件中。如果不清楚属于哪个分类,可以提交到:temporary-contribution.md
中,仓库管理员会再次评估分类。
文本排版格式要求参照:中文文案排版指北
参考格式:
[参数描述]
[说明描述]
参考 Markdown 语言格式:
### 1.[小提示关键内容描述]
#### 环境参数:
[参数描述]
#### 说明:
[说明描述]
A.能用图片的情况下,不要用视频。能用文本的情况下,不要用图片。
B.使用原始错误提示来作为问题关键内容描述,这个更方便别人查找参考。
C.有代码内容的部分,请使用代码块。
D.如果想要引入视频和大量的图片,请引入外部链接。如果想要引入图片,少量的可以放置在 img/
目录底下,图片文件采用全部小写字母、横杠的命名方式。
E.代码的引入方式有两种,一种是采用双"```"引入,另外一种是采用缩进方式引入,为了保持格式的美观,我们统一采用前者方式,而不采用缩进的方式引入代码。
仓库管理者请注意,所有的目录和文件名称,除了特殊情况之外,全部采用小写字母与横杠的组合。每一层目录底下包含一个 README.md
文件,如果当前内容(比如:xcode)没有下一级目录细分的话,就将包含内容的文件名称命名成:xcode.md
。
非 iOS 内容,非 iOS “小知识点”内容,例如:“坑”总结等。本仓库只接受 iOS 的“小知识点”的总结。