1 簡介
作為全球最大的開源及私有軟體專案託管社群平臺,github
可以顯著地幫助從事程式設計相關工作的人員提升自己的技術水平,也是費老師我日常最常瀏覽學習的技術類網站。
github
為了使得其使用更加便捷,時常推出一些實用的功能,今天我們就來學習其中方便我們日常編寫markdown
文件、建立issues
等操作的幾則小技巧。
2 github日常使用小技巧
2.1 在markdown中繪製線上地圖
github
支援使用markdown
編寫的文件或內容中利用特殊的語法插入geoJSON
或topoJSON
資料,從而直接渲染互動式線上地圖:
- 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
語法中,新增了可以隨著使用者對網站主題的切換,而自動變換到相應圖片地址的功能,具體用法可參考(https://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
地址前新增字首https://github.91chi.fun/
再進行clone
,速度就會快上許多,譬如:
git clone https://github.91chi.fun/https://github.com/pandas-dev/pandas.git
2.8 狀態風格引用塊
最後要介紹的這個特性是github
最近幾天放出的實驗性質功能,目前可獲得的情報中,我們可以利用下面的語法方式,建立出帶有狀態風格的引用塊,從而使得我們的文件內容更加別緻,大家也可以在(https://github.com/github/feedback/discussions/16925
)中關注其最新訊息:
> **Note**<br>
> This is a note
> **Warning**<br>
> This is a warning
以上就是本文的全部內容,歡迎在評論區與我進行討論~