gitbook 入门教程之前置知识
markdown
基本知识
markdown
是一种简化的 html
语法,相比于 txt
无格式文本更强大.
你可以用专门的软件去编辑 markdown
文件,就像需要使用软件编辑 txt
文件一样,当然也可以什么软件也不用,甚至直接在记事本或命令行书写,只不过这样的缺点就是无法实时预览输出效果,安全依赖个人经验和想象力了.
markdown
文件后缀名是.md
,安装了相应插件的浏览器或专门软件能够看到输出效果.
标题
语法格式:
#
+空格
+文本
大多数markdown
编辑器支持 h1~h6
级标题,而富文本编辑器一般仅支持到二级标题.
示例:
# 标题1
## 标题2
效果:
标题1
标题2
列表
列表包括有序列表,无序列表和任务列表,并支持列表嵌套.
大多数 markdown
编辑器和富文本编辑器均支持有序列表和无序列表,而任务列表和列表嵌套支持度就不是很好,存在平台兼容性问题.
有序列表
语法格式:
数字
+.
+空格
+文本
示例:
1. 有序列表1
2. 有序列表2
3. 有序列表3
效果:
- 有序列表1
- 有序列表2
- 有序列表3
无序列表
语法格式:
- 或 * 或 +
+空格
+文本
示例:
- 无序列表1
* 无序列表2
+ 无序列表3
效果:
- 无序列表1
- 无序列表2
- 无序列表3
链接和图片
markdown
编辑器和富文本编辑器均支持链接和图片,值得注意的是有些平台限制或禁止外链.
链接
语法格式:
[显示文本]
+(链接地址)
示例:
[https://snowdreams1006.github.io](https://snowdreams1006.github.io/)
效果:
https://snowdreams1006.github.io
图片
语法格式:
!
+[图片标题]
+(图片地址)
示例:
![雪之梦技术驿站的头像](https://avatars0.githubusercontent.com/u/23238267?s=400&u=c60a9628495b4bfb4c6ee1a7bba8e3a8d265ca96&v=4)
效果:
代码
代码分为单行代码和多行代码,其中多行代码也叫做代码块.
大多数 markdown
编辑器均支持代码,富文本编辑器支持度不一样,有的支持单行代码有的支持代码块.
单行代码
语法格式:
`
+单行代码
+`
示例:
`code`
效果:
code
多行代码
语法格式:
```
+多行代码
+```
示例:
```
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
```
效果:
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
这里的富文本支持语法指的是
markdown
渲染后的内容能否正常显示,并不是指markdown
语法本身能够正常渲染,更多详情请参考 markdown 快速入门
git
基本知识
git
是全世界最先进的分布式版本控制系统,帮助项目更好地进行管理,支持版本历史管理和多人写作管理等功能.
简单地说,可以理解为一种优雅的文档备份方式,支持云端备份,多人协作等特点.
初始化项目
语法格式:
git init
适合从零开始的本地项目,初始化后的项目才是能够被 git
管理的项目.
示例:
git init
克隆项目
语法格式:
git clone
适合已有远程项目需要下载到本地,作用是将远程项目克隆到本地,和 git init
实现类似的功能.
示例:
git clone git@github.com:username/username.github.io.git
添加文件
语法格式:
git add
将文件添加到暂存区,支持多次添加文件,相当于写入缓存区.
示例:
git add .
提交文件
语法格式:
git commit
将暂存区内容提交到版本库,完成一次历史版本.
示例:
git commit -m "写入提交备注,简短说明下提交意图和目标"
推送文件
语法格式:
git push
将本地版本库推送到远程版本库,相当于本地文件备份到云端服务器.
示例:
git push origin master
拉取文件
语法格式:
git pull
将远程版本库拉取到本地版本库,相当于云端服务器文件恢复到本地.
示例:
git pull
查看状态
语法格式:
git status
查看当前文件状态,包括文件被新增,被修改,被删除,未提交等等.
示例:
git status
比较差异
语法格式:
git diff
查看两个文件之间的具体差异
示例:
git diff
历史日志
语法格式:
git log
查看版本库的提交历史日志
示例:
git log
上述仅介绍了
git
的简单命令,实际使用情况远不止这些,更多详情请参考 git 入门教程
gitbook 入门教程之前置知识的更多相关文章
- gitbook 入门教程之小白都能看懂的 Gitbook 插件开发全流程
什么是插件 Gitbook 插件是扩展 GitBook 功能(电子书和网站)的最佳方式. 只要是 Gitbook 默认没有提供的功能,基于插件机制都可以自行扩展,是插件让 Gitbook 变得更加强大 ...
- gitbook 入门教程之从零到壹发布自己的插件
什么是插件 Gitbook 插件是扩展 Gitbook 功能的最佳方式,如果 Gitbook 没有想要的功能或者说网络上也没有现成的解决方案时,那么只剩下自食其力这条道路,让我们一起来自力更生开发插件 ...
- gitbook 入门教程之使用 gitbook.com 在线开发电子书
gitbook 官网是官方提供的图书托管的在线平台,分为新版官网(需要FQ) https://www.gitbook.com/ 和旧版官网(无需FQ) https://legacy.gitbook.c ...
- gitbook 入门教程之使用 gitbook-cli 开发电子书
gitbook 生成电子书主要有三种方式: gitbook-cli 命令行操作,简洁高效,适合从事软件开发的相关人员. gitbook-editor 编辑器操作,可视化编辑,适合无编程经验的文学创作者 ...
- gitbook 入门教程之快速体验
本文主要介绍三种使用 gitbook 的方式,分别是 gitbook 命令行工具,Gitbook Editor 官方编辑器和 gitbook.com 官网. 总体来说,三种途径适合各自不同的人群,找到 ...
- gitbook 入门教程之环境要求
gitbook 是基于 node.js 的命令行工具,首先需要安装并配置好 node.js 环境,然后才能安装gitbook 相关工具. 由于安装工具全部都是国外网站,因此速度可能会很慢,也可能需要F ...
- gitbook 入门教程之发布电子书
输出目标文件 语法格式: gitbook build [book] [output] 默认情况下,gitbook 输出方式是静态网站,其实 gitbook 的输出方式有三种: website, jso ...
- gitbook 入门教程之常用命令详解
不论是 gitbook-cli 命令行还是 gitbook editor 编辑器都离不开 gitbook 命令的操作使用,所以再次了解下常用命令. 注意 gitbook-cli 是 gitbook 的 ...
- gitbook 入门教程之还在搞公众号互推涨粉?gitbook 集成导流工具,轻轻松松躺增粉丝!
相信大多数博客作者都或多或少有过这样想法: 现在各种平台这么多,想要实现全平台发布就要到处复制粘贴,等我有空一定做统一平台一次性全部解决! 不知道正在阅读文章的你,有没有这样的想法? 反正我确实这么想 ...
随机推荐
- 转)ZooKeeper的实现分析
最近在大量看关于Zookeeper的博客,发现一篇讲解ZK实现很详细的博客,特此转载一下: 原博客地址: http://my.oschina.net/zhengyang841117/blog/1866 ...
- 关于内核转储(core dump)的设置方法
原作者:http://blog.csdn.net/wj_j2ee/article/details/7161586 1. 内核转储作用 (1) 内核转储的最大好处是能够保存问题发生时的状态. (2) 只 ...
- sql server 高可用故障转移(3)
虚拟磁盘创建 前面我们已经搭了域和两台sql 服务器, 下面我们准备让DC域服务器除了担当域控制器外,还行使另一个职能:充当集群共享存储. 集群共享存储是由群集内的每个节点都能共同访问的一个存储设备, ...
- 《Hadoop金融大数据分析》读书笔记
<Hadoop金融大数据分析> Hadoop for Finance Essentials 使用Hadoop,是因为数据量大数据量如此之多,以至于无法用传统的数据处理工具和应用来处理的数据 ...
- WinForm中DataGridView对XML文件的读取
转自http://www.cnblogs.com/a1656344531/archive/2012/11/28/2792863.html c#读取XML XML文件是一种常用的文件格式,例如Win ...
- Python中使用MongoEngine2
mongoengine基本用法实例: from mongoengine import * from datetime import datetime #连接数据库:test # connect('te ...
- Linux下*.tar.gz/.tar.bz2 文件解压缩安装命令
1. .tar.gz压缩命令: 命令格式: tar -zcvf 压缩文件名.tar.gz 被压缩文件名 可先切换到当前目录下.压缩文件名和被压缩文件名都可加入路径. 2. .tar.gz解压缩命令: ...
- Java 读书笔记 (十四) Java 方法
finalize() 方法 finalize() 用来清除回收对象. //为什么要回收内存?怎样写可以避免内存过多占用?什么时候需要手动回收内存? protected void finalize() ...
- BZOJ_1085_[SCOI2005]骑士精神_IDDFS
BZOJ_1085_[SCOI2005]骑士精神_DFS Description 在一个5×5的棋盘上有12个白色的骑士和12个黑色的骑士, 且有一个空位.在任何时候一个骑士都能按照骑 士的走法(它可 ...
- mfc启动画面
目标 用一张位图来作为启动画面,在进入程序时显示. 策略 在应用程序类的I n i t I n s t a n c e ()函数中,在最早时刻创建启动窗口.启动窗口用一个位图类显示在普通窗口中. 步骤 ...