提升Github使用體驗(yàn)的八個(gè)技巧
1 .簡介
作為全球最大的開源及私有軟件項(xiàng)目托管社區(qū)平臺，github可以顯著地幫助從事編程相關(guān)工作的人員提升自己的技術(shù)水平，也是費(fèi)老師我日常最常瀏覽學(xué)習(xí)的技術(shù)類網(wǎng)站。
github為了使得其使用更加便捷，時(shí)常推出一些實(shí)用的功能，今天我們就來學(xué)習(xí)其中方便我們?nèi)粘＞帉憁arkdown文檔、創(chuàng)建issues等操作的幾則小技巧。
2.github日常使用小技巧
2.1 在markdown中繪制在線地圖
github支持使用markdown編寫的文檔或內(nèi)容中利用特殊的語法插入geoJSON或topoJSON數(shù)據(jù)，從而直接渲染交互式在線地圖：
- geoJSON示例
- 下面是`geoJSON`渲染示例
```geojson
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
106.58472061157227,
29.57106827738255
],
[
106.58025741577148,
29.567335671068733
],
[
106.57304763793945,
29.5653946612635
],
[
106.56137466430664,
29.566738441255648
],
[
106.5538215637207,
29.569873858372727
],
[
106.54541015625,
29.569724555003123
],
[
106.53871536254883,
29.565842589914105
],
[
106.53751373291016,
29.562259105087506
],
[
106.53064727783203,
29.554942428835226
],
[
106.53545379638672,
29.54568383423715
],
[
106.55193328857422,
29.551955878093022
],
[
106.5596580505371,
29.55091056448027
],
[
106.57115936279295,
29.54986524005526
],
[
106.57888412475586,
29.55329983685018
],
[
106.58557891845703,
29.561960475613336
],
[
106.58472061157227,
29.57106827738255
]
]
]
}
}
]
}
```
- topoJSON示例
- 下面是`topoJSON`渲染示例
```topojson
{"type":"Topology","objects":{"collection":{"type":"GeometryCollection","geometries":[{"type":"Polygon","arcs":[[0]]}]}},"arcs":[[[2008,9999],[-2008,-1221],[1261,-8778],[7285,1408],[1453,5797],[-7991,2794]]],"transform":{"scale":[0.0000160691117939919,0.00001612860192965454],"translate":[106.52584075927734,29.47517125618036]},"bbox":[106.52584075927734,29.47517125618036,106.68651580810547,29.636441146874976]}
```
2.2 markdown中令圖片根據(jù)主題自動切換
github在其markdown語法中，添加了可以隨著用戶對網(wǎng)站主題的切換，而自動變換到相應(yīng)圖片地址的功能，具體用法可參考(https://github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/)：
2.3 根據(jù)粘貼板鏈接快速生成markdown超鏈接內(nèi)容
當(dāng)你剛剛復(fù)制了一段鏈接地址后，回到github的編輯窗口中選中某段文字后粘貼，就會自動快捷生成以這段文字為顯示內(nèi)容的超鏈接：
2.4 快捷生成引用塊、有序列表及無序列表
選中目標(biāo)內(nèi)容后，按下快捷鍵ctrl+shift+.可以快速生成引用塊;按下快捷鍵ctrl+shift+7可以快速生成有序列表;按下快捷鍵ctrl+shift+8可以快速生成無序列表：
2.5 為文檔生成腳注
我們可以在markdown文檔中利用[^序號]的語法完成腳注內(nèi)容的插入，使得閱讀文檔時(shí)點(diǎn)擊插入處即可自動滾動到相應(yīng)的頁腳中：
2.6 以在線vscode的方式瀏覽倉庫
當(dāng)你正在瀏覽某個(gè)倉庫時(shí)，雙擊鍵盤上的.鍵，稍等片刻后，github會刷新頁面以在線vscode的形式展示此倉庫內(nèi)容，從而方便我們?yōu)g覽倉庫內(nèi)文件，以pandas官方倉庫為例：
2.7 使用國內(nèi)鏡像加速倉庫clone
由于一些眾所周知的原因，我們在國內(nèi)clone來自github的遠(yuǎn)程倉庫時(shí)，速度十分捉急，而目前只需要在目標(biāo)倉庫的clone地址前添加前綴https://github.91chi.fun/再進(jìn)行clone，速度就會快上許多，譬如：
git clone https://github.91chi.fun/https://github.com/pandas-dev/pandas.git
2.8 狀態(tài)風(fēng)格引用塊
最后要介紹的這個(gè)特性是github最近幾天放出的實(shí)驗(yàn)性質(zhì)功能，目前可獲得的情報(bào)中，我們可以利用下面的語法方式，創(chuàng)建出帶有狀態(tài)風(fēng)格的引用塊，從而使得我們的文檔內(nèi)容更加別致，大家也可以在(https://github.com/github/feedback/discussions/16925)中關(guān)注其最新消息：
> **Note**<br>
> This is a note
> **Warning**<br>
> This is a warning
