gitbook 入門教程之前置知識

雪之夢技術驛站發表於2019-03-31

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/)
複製程式碼

效果:

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

相關文章