如何在 Hexo 文章中插入本地圖片

Hexo文件設定

將 Hexo 文件裡面的 _config.yml 的此參數設定為true

1
post_asset_folder: true

這個功能目的是在你使用Hexo new 文章名稱,建立一篇新的文章。文章相對路徑為\source_posts,例如我輸入以下指令:

1
Hexo new test

目錄下就會生成一個test.md文件和一個與文章同名的資料夾,可以用來放置該文章相關的所有資源,例如圖片、附件等等。

安裝 hexo-asset-image 套件

安裝 hexo-asset-image 圖片路徑轉換套件,使用npm進行安裝:

1
npm install https://github.com/CodeFalling/hexo-asset-image --save

插入圖片

1
![當圖片無法顯示時出現的文字](圖片檔名.PNG)

也支援使用 HTML 的img標籤,可以更改圖片高度、寬度等設定。

1
<img src="xx.png" width = "100%" height = "100%">

參考文獻

  1. http://etrd.org/2017/01/23/hexo%E4%B8%AD%E5%AE%8C%E7%BE%8E%E6%8F%92%E5%85%A5%E6%9C%AC%E5%9C%B0%E5%9B%BE%E7%89%87/
  2. https://blog.csdn.net/Sugar_Rainbow/article/details/57415705

設定 SSH 連接 GitHub

關於 SSH keys

使用SSH協定,連接到遠端服務器 GitHub 進行身份驗證,透過設定 SSH keys,就不用在每次訪問 GitHub 的時候提供用戶名稱或密碼。

檢查 SSH keys

在生成 SSH keys之前,你可以先檢查本機是否有已存在的 SSH keys。

  1. 進入 Git Bash
  2. 輸入 bash ls -al ~/.ssh 查看是否有存在的 SSH keys
1
2
$ ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist</code>
  1. 查看目錄中是否已經有 public SSH key

預設情況下,public SSH key 的文件名會是以下類型之一,
副檔名為 .pub 就是 public key,另一個則是 private key:

  • id_dsa.pub
  • id_ecdsa.pub
  • id_ed25519.pub
  • id_rsa.pub

如果沒有 .ssh 的目錄,或是沒有 id_xxxid_xxx.pub 來命名的一對 key ,請生成一個新的 SSH keys:

生成新的 SSH keys

  1. 進入 Git Bash
  2. 複製以下指令,並替換自己的 GitHub 電子郵件
1
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

根據提供的電子郵件作為標籤,建立一個新的 SSH key。

1
> Generating public/private rsa key pair.

接下來的步驟都按 Enter 即可。

增加新的 SSH key 到 Github

  1. 複製 SSH key
1
2
$ clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard
  1. 到 Github 網站加入你的 SSH key
  1. 點擊 SSH and GPG keys
  1. 點擊 New SSH key 或 Add SSH key.
  1. 在”標題”中為新的 key 添加一個描述性的標籤。 例如:如果是你個人的筆電,則可以將此名稱設為”Personal NB”。

  2. 貼上第一步驟複製的 key

  1. 點擊 Add SSH key
  1. 再次輸入密碼確認

參考文獻

  1. https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

  2. http://wiki.csie.ncku.edu.tw/github

  3. https://git-scm.com/book/zh-tw/v1/%E4%BC%BA%E6%9C%8D%E5%99%A8%E4%B8%8A%E7%9A%84-Git-%E7%94%9F%E6%88%90-SSH-%E5%85%AC%E9%96%8B%E9%87%91%E9%91%B0

Git for Windows

Git Installation on Windows

要在 Windows 作業系統上安裝 Git,請到官方網站下載合適的版本:


網址:https://git-scm.com/download/win

網站會偵測使用者的系統版本為32-bit或64-bit,進行自動下載。

安裝過程中,每個步驟都點選下一步直到安裝完成:

安裝完成後,請搜尋「Git Bash」應用程式:


進入 Git Bash 後,請試試輸入以下兩個指令,來驗證 Git 是否安裝成功,以及查看版本資訊:


若看到類似的訊息,就表示安裝成功。


使用者設定

要開始使用 Git,請先對使用者設定識別資料,分別是使用者名稱及電子郵件,每次 Git 提交會使用此資訊,請打開終端機,輸入下面這兩行指令,請自行替換使用者及電子信箱名稱:

1
2
$ git config --global user.name "Cheng-Yi-Ting"
$ git config --global user.email "d02405035@ems.npu.edu.tw"

輸入完成之後,可以再檢視一下目前的設定:

1
2
3
$ git config --list
user.email=d02405035@ems.npu.edu.tw
user.name=Cheng-Yi-Ting

你也可以輸入 git config <key> 來檢視某個設定目前的值:

1
2
git config user.name
Cheng-Yi-Ting

專案設定不同的作者

若有傳遞 –global 參數,意思是要做全域(Global)的設定,不論 Git 做任何事都會採用此資訊,如果遇到要幫特定的專案設定不同的作者及電子郵件,可以在該專案目錄下進行 Git 設定的時候,加上 –local 參數:

1
2
$ git config --local user.name ray
$ git config --local user.email ray@gmail.com

撰寫技術 Blog 的優點

前言

最近想開始寫Blog,主要是想寫技術文,也是幫助自己熟悉一些技術,簡單整理一下寫Blog的好處:

好處一:歷史筆記

許多頻繁接觸的東西,過一陣子沒碰就有機會忘記,像是環境的設置或是程式語法,假使有認真將這些文章記錄下來的話,到時候只要回頭看看找資料就好了,遇到一些問題就寫Blog記錄下來,下次碰到可能就忘記當初是怎麼解決的,然後就會很感謝當時的自己有留下紀錄。

好處二:內化知識

找一個主題,做深入地探討、研究,過程裡可能有些你本來就懂的,或是不太懂得內容,這些似懂非懂的內容,透過寫文時有方向性地篩選與蒐集資訊,重新檢視自己的知識,深入瞭解並加深印象。

好處三:幫助學習

我相信不一定要有很厲害的技術底子才有資格教人,在教學過程中對自己也是一種學習,將所學整理出一個總結,我想寫文章不只是幫助自己,只要傳達的東西能夠解決一部份人的問題那就是有價值的內容。