gitbook 入門教程以前置知識

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

多行代碼

語法格式： ``` + 多行代碼 + ```

示例:

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