文字

版本库

每个文档都有自己的GIT版本库地址,一般是:

http://www.kancloud.cn/{用户名}/{文档标识}.git

如果不清楚的话,可以在文档页面查看到具体的GIT地址,如图:

版本库的获取和推送都需要用户认证,只有具有该文档编辑以上权限的用户才能进行版本库获取和推送,认证的账号密码就是你的看云账号密码。

首先需要本地安装GIT版本库支持(请自行百度)后,把当前文档的版本库克隆到本地,即可开始利用其他的MD编辑器进行离线写作,写作完成后,远程提交或者合并到文档的版本库地址即可。

你也可以和其他的版本库地址进行同步。

目录文件

看云目录文件的规范命名是SUMMARY.md,本身也是采用markdown格式,格式如下:

* [前言](Preface.md)
* [第1章 基础知识](content/Chapter1.md)
    * [1.1 安装 tmux](content/安装tmux.md)
    * [1.2 开始使用 tmux](content/开始使用 tmux.md)
    * [1.3 分离和连接会话](content/分离和连接会话.md) 
* [第2章 配置 tmux](content/Chapter2.md)
* [第3章 脚本定制 tmux 环境](content/Chapter3.md)
* [第4章 文本和缓冲区](content/Chapter4.md)
* [第5章 使用 tmux 结对编程](content/Chapter5.md)
* [第6章 工作流](content/Chapter6.md)
* [附录 配置文件](content/Appendix.md)

在目录文件中每个目录都对应一个md文件,该文件的命名可以使用中文,但不能使用下列特殊字符:\/:*<>|"

如果文件名中使用/会作为目录处理。

目录的层次关系采用TAB缩进,并且可以支持多级目录。

文档设置

每个文档都可以独立设置相关的参数和扩展,设置文件命名格式为:book.json
例如,我们可以给文档设置代码高亮显示功能,就需要在配置文件中加入插件参数:

{
    "plugins":["highlight"],
}

样式自定义

可以给文档的阅读页面自定义样式,只要增加 style/website.css文件,然后在里面加上样式代码,例如:

/* 改变默认的引用段落样式 */
.think-editor-content blockquote.default{
    border-left: 5px solid #D0E3F0;
    margin: 8px 0;
    padding: 8px 16px;
    background-color: #F0F7FD;
    color: #0382AD;    
}

/* 改变文档标题样式 */
.m-manual .manual-title .text{
    font-size:24px;
    font-weight:400;
}

多格式支持

你可以给某个章节的内容采用HTML格式编辑,并且确保文件后缀名是.html

看云会陆续支持其他格式的文档解析,不过需要注意的是,采用非md格式的文件格式提交后,在线编辑的时候将无法支持实时预览功能。

上一篇: 下一篇:
  页面正在加载中