1 簡介

作為全球最大的開源及私有軟件項目托管社區(qū)平臺，github可以顯著地幫助從事編程相關(guān)工作的人員提升自己的技術(shù)水平，也是費老師我日常最常瀏覽學(xué)習(xí)的技術(shù)類網(wǎng)站。

github為了使得其使用更加便捷，時常推出一些實用的功能，今天我們就來學(xué)習(xí)其中方便我們?nèi)粘＞帉?code style="font-size: 14px;overflow-wrap: break-word;padding: 2px 4px;border-radius: 4px;margin-right: 2px;margin-left: 2px;background-color: rgba(27, 31, 35, 0.05);font-family: "Operator Mono", Consolas, Monaco, Menlo, monospace;word-break: break-all;">markdown文檔、創(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 快捷生成引用塊、有序列表及無序列表

選中目標內(nèi)容后，按下快捷鍵ctrl+shift+.可以快速生成引用塊；按下快捷鍵ctrl+shift+7可以快速生成有序列表；按下快捷鍵ctrl+shift+8可以快速生成無序列表：

2.5 為文檔生成腳注

我們可以在markdown文檔中利用[^序號]的語法完成腳注內(nèi)容的插入，使得閱讀文檔時點擊插入處即可自動滾動到相應(yīng)的頁腳中：

2.6 以在線vscode的方式瀏覽倉庫

當(dāng)你正在瀏覽某個倉庫時，雙擊鍵盤上的.鍵，稍等片刻后，github會刷新頁面以在線vscode的形式展示此倉庫內(nèi)容，從而方便我們?yōu)g覽倉庫內(nèi)文件，以pandas官方倉庫為例：

2.7 使用國內(nèi)鏡像加速倉庫clone

由于一些眾所周知的原因，我們在國內(nèi)clone來自github的遠程倉庫時，速度十分捉急，而目前只需要在目標倉庫的clone地址前添加前綴https://github.91chi.fun/再進行clone，速度就會快上許多，譬如：

git?clone?https://github.91chi.fun/https://github.com/pandas-dev/pandas.git

2.8 狀態(tài)風(fēng)格引用塊

最后要介紹的這個特性是github最近幾天放出的實驗性質(zhì)功能，目前可獲得的情報中，我們可以利用下面的語法方式，創(chuàng)建出帶有狀態(tài)風(fēng)格的引用塊，從而使得我們的文檔內(nèi)容更加別致，大家也可以在（https://github.com/github/feedback/discussions/16925）中關(guān)注其最新消息：

>?**Note**

>?This?is?a?note

>?**Warning**

>?This?is?a?warning

以上就是本文的全部內(nèi)容，歡迎在評論區(qū)與我進行討論~