文档章节

gitbook 入门教程之前置知识

o
 osc_w9s1w4o0
发布于 2019/03/31 14:24
字数 1186
阅读 9
收藏 0

精选30+云产品,助力企业轻松上云!>>>

markdown 基本知识

markdown 是一种简化的 html 语法,相比于 txt 无格式文本更强大.

你可以用专门的软件去编辑 markdown 文件,就像需要使用软件编辑 txt 文件一样,当然也可以什么软件也不用,甚至直接在记事本或命令行书写,只不过这样的缺点就是无法实时预览输出效果,安全依赖个人经验和想象力了.

markdown 文件后缀名是.md,安装了相应插件的浏览器或专门软件能够看到输出效果.

标题

语法格式: # + 空格 + 文本

大多数markdown编辑器支持 h1~h6 级标题,而富文本编辑器一般仅支持到二级标题.

示例:

# 标题1
## 标题2

效果:

标题1

标题2

列表

列表包括有序列表,无序列表和任务列表,并支持列表嵌套.

大多数 markdown 编辑器和富文本编辑器均支持有序列表和无序列表,而任务列表和列表嵌套支持度就不是很好,存在平台兼容性问题.

有序列表

语法格式:数字 + . + 空格 + 文本

示例:

1. 有序列表1 
2. 有序列表2 
3. 有序列表3 

效果:

  1. 有序列表1
  2. 有序列表2
  3. 有序列表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> + 单行代码 + <code>`</code>

示例:

`code`

效果:

code

多行代码

语法格式:<code>```</code> + 多行代码 + <code>```</code>

示例:

<pre> ``` function fun(){ echo "这是一句非常牛逼的代码"; } fun(); ``` </pre>

效果:

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 入门教程

o
粉丝 0
博文 500
码字总数 0
作品 0
私信 提问
加载中
请先登录后再评论。
gitbook 入门教程之 gitbook 简介

是一个基于的命令行工具,使用 和 构建精美的电子书. 支持输出静态网页和电子书等多种格式,其中默认输出静态网页格式. 不仅支持本地构建电子书,而且可以托管在 官网上,并享受在线发布和托管图...

雪之梦技术驿站
2019/03/30
20
0
gitbook 入门教程之 gitbook 简介

是一个基于的命令行工具,使用 和 构建精美的电子书. 支持输出静态网页和电子书等多种格式,其中默认输出静态网页格式. 不仅支持本地构建电子书,而且可以托管在 官网上,并享受在线发布和托管图...

osc_arhijur3
2019/03/30
2
0
gitbook

安装Node 安装 Node.js(下载地址:https://nodejs.org/en/download/) 安装gitbook Typora 工具 typora 下载地址:https://typora.io/ 使用 初始化电子书 编辑SUMMARY.md文件 更新电子书 再...

浮云晓生
2019/02/13
14
0
GitBook 入门学习

一、什么是 Gitbook GitBook 是一个基于 Node.js 的命令行工具,支持 Markdown 和 AsciiDoc 两种语法格式,可以输出 HTML、PDF、eBook 等格式的电子书。 Gitbook 使用方案: GitBook + Typo...

osc_ugxmmsvy
2019/06/24
2
0
GitBook - 快速打造可留言的博客

Create by jsliang on 2019-05-20 14:43:41 Recently revised in 2019-05-22 18:01:09 本文将介绍如何安装 GitBook、如何起 GitBook 服务、如何配置 GitBook,以及到最后的部署到 GitHub Pag...

jsliang
2019/05/22
0
0

没有更多内容

加载失败,请刷新页面

加载更多

JIT的Profile神器JITWatch

点击上方的蓝字关注我吧 程序那些事 简介 老是使用命令行工具在现代化社会好像已经跟不上节奏了,尤其是在做JIT分析时,使用LogCompilation输出的日志实在是太大了,让人望而生畏。有没有什么...

flydean
07/04
0
0
运维基础--虚拟机的使用(一)

虚拟机的使用 开始使用Linux操作系统时,首先可能会接触到两个主要的界面:GUI和CLI,即图形界面个命令界面,而运维一般极少使用到图形界面。 一、命令提示符的格式:[root@mylab11~] # roo...

osc_9os5791s
23分钟前
25
0
以程序员的方式,尽绵薄之力

作为程序员,我们不能冲在第一线,参与病毒防疫工作,我们希望通过我们的方式,让更多的人获取到关于疫情的有用的消息,正确的消息 虽然github可能是个相对小众的平台,对于非程序员来说,可...

Jipson
01/26
17
0
Oracle 等待事件之 db file scattered read

db file scattered read 官网解释: This event signifies that the user process is reading buffers into the SGA buffer cache and is waiting for a physical I/O call to return. A db......

osc_qlj7m2h9
24分钟前
19
0
互联网+时代的畅想

封面的台风卫星照片,我认为很形象地可以看作互联网的那一波浪潮。在智能手机普及的初始阶段,还记得我们对于互联网的狂热,有人说要用互联网颠覆一切,亦有人要用互联网干一切事情,当然,这...

zd200572
2015/09/02
24
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部