提升Github使用體驗(yàn)的八個(gè)技巧
1 .簡介
作為全球最大的開源及私有軟件項(xiàng)目托管社區(qū)平臺(tái),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ù)主題自動(dòng)切換
github在其markdown語法中,添加了可以隨著用戶對(duì)網(wǎng)站主題的切換,而自動(dò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的編輯窗口中選中某段文字后粘貼,就會(huì)自動(dòng)快捷生成以這段文字為顯示內(nèi)容的超鏈接:
2.4 快捷生成引用塊、有序列表及無序列表
選中目標(biāo)內(nèi)容后,按下快捷鍵ctrl+shift+.可以快速生成引用塊;按下快捷鍵ctrl+shift+7可以快速生成有序列表;按下快捷鍵ctrl+shift+8可以快速生成無序列表:
2.5 為文檔生成腳注
我們可以在markdown文檔中利用[^序號(hào)]的語法完成腳注內(nèi)容的插入,使得閱讀文檔時(shí)點(diǎn)擊插入處即可自動(dòng)滾動(dòng)到相應(yīng)的頁腳中:
2.6 以在線vscode的方式瀏覽倉庫
當(dāng)你正在瀏覽某個(gè)倉庫時(shí),雙擊鍵盤上的.鍵,稍等片刻后,github會(huì)刷新頁面以在線vscode的形式展示此倉庫內(nèi)容,從而方便我們?yōu)g覽倉庫內(nèi)文件,以pandas官方倉庫為例:
2.7 使用國內(nèi)鏡像加速倉庫clone
由于一些眾所周知的原因,我們?cè)趪鴥?nèi)clone來自github的遠(yuǎn)程倉庫時(shí),速度十分捉急,而目前只需要在目標(biāo)倉庫的clone地址前添加前綴https://github.91chi.fun/再進(jìn)行clone,速度就會(huì)快上許多,譬如:
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