8條github使用小技巧

1 簡介

  作為全球最大的開源及私有軟體項目託管社區平台,github可以顯著地幫助從事編程相關工作的人員提升自己的技術水平,也是費老師我日常最常瀏覽學習的技術類網站。

  github為了使得其使用更加便捷,時常推出一些實用的功能,今天我們就來學習其中方便我們日常編寫markdown文檔、創建issues等操作的幾則小技巧。

2 github日常使用小技巧

2.1 在markdown中繪製在線地圖

  github支援使用markdown編寫的文檔或內容中利用特殊的語法插入geoJSONtopoJSON數據,從而直接渲染互動式在線地圖:

  • 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中令圖片根據主題自動切換

  github在其markdown語法中,添加了可以隨著用戶對網站主題的切換,而自動變換到相應圖片地址的功能,具體用法可參考(//github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/):

2.3 根據粘貼板鏈接快速生成markdown超鏈接內容

  當你剛剛複製了一段鏈接地址後,回到github的編輯窗口中選中某段文字後粘貼,就會自動快捷生成以這段文字為顯示內容的超鏈接:


## 2.4 快捷生成引用塊、有序列表及無序列表

  選中目標內容後,按下快捷鍵ctrl+shift+.可以快速生成引用塊;按下快捷鍵ctrl+shift+7可以快速生成有序列表;按下快捷鍵ctrl+shift+8可以快速生成無序列表:


## 2.5 為文檔生成腳註

  我們可以在markdown文檔中利用[^序號]的語法完成腳註內容的插入,使得閱讀文檔時點擊插入處即可自動滾動到相應的頁腳中:

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

  當你正在瀏覽某個倉庫時,雙擊鍵盤上的.鍵,稍等片刻後,github會刷新頁面以在線vscode的形式展示此倉庫內容,從而方便我們瀏覽倉庫內文件,以pandas官方倉庫為例:

2.7 使用中國鏡像加速倉庫clone

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

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

2.8 狀態風格引用塊

  最後要介紹的這個特性是github最近幾天放出的實驗性質功能,目前可獲得的情報中,我們可以利用下面的語法方式,創建出帶有狀態風格的引用塊,從而使得我們的文檔內容更加別緻,大家也可以在(//github.com/github/feedback/discussions/16925)中關注其最新消息:

> **Note**<br>
> This is a note

> **Warning**<br>
> This is a warning


  以上就是本文的全部內容,歡迎在評論區與我進行討論~

Tags: