起因
最近看到一個博客搭建項目,感覺很不錯哩簿,項目地址: 蘑菇博客
經(jīng)過
首先按照說明文檔嘗試著搭建,并在管理后臺頁面寫了一遍測試文章, 并且選擇了halo 下的一個展示主題:halo-theme-fantastic
搭建成功后的博客首頁如圖:
個人還是挺滿意這個主題的,但是在文章歸檔頁面卻發(fā)現(xiàn)了一個明顯的bug:
頁面中文章的圖片顯示異常爽茴,點擊后跳轉鏈接為文章圖片灾锯,通過F12查看頁面源碼:
發(fā)現(xiàn)是頁面中的文章跳轉鏈接和文章圖片搞反了兢榨。
通常查看 halo-theme-fantastic 主題的源代碼:
將post.fullPath
與 post.thumbnail
交換即可,改正后正常顯示文章圖片顺饮,并且正常跳轉到文章詳情頁面:
結果
所以吵聪,終于第一次發(fā)現(xiàn)了GitHub上項目的bug并將其修復,慚愧中帶點開心~
問題來了兼雄,我要怎么把這個修復提交給 halo-theme-fantastic 項目呢吟逝?
那就是 pull request 了。
之前工作和學習一直都是在gitlab上同一個代碼庫提交代碼赦肋,常用命令就是 pull, push, merge
等块攒,還沒有嘗試過向其他項目提pull request呢。 看來今天就是給渣渣我的一個好機會佃乘。
筆記
經(jīng)常查詢局蚀,了解以下操作步驟,特此記錄下,參考鏈接: creating-a-pull-request
1. fork 原始項目
登錄 GitHub 網(wǎng)站恕稠,找到原始項目 https://github.com/imkundev/halo-theme-fantastic琅绅,點擊右上角的 fork 按鈕
這樣就會在你自己的GitHub 上有了一個相同的項目:
2. 復制自己的項目到本地
> git clone https://github.com/lyk2655/halo-theme-fantastic.git
3. 將原始項目添加有項目的upstream
> git remote add upstream https://github.com/think-view/halo-theme-fantastic
查看項目情況
> git remote -v
origin https://github.com/lyk2655/halo-theme-fantastic.git (fetch)
origin https://github.com/lyk2655/halo-theme-fantastic.git (push)
upstream https://github.com/think-view/halo-theme-fantastic (fetch)
upstream https://github.com/think-view/halo-theme-fantastic (push)
4.創(chuàng)建新的分支
> git checkout -b fix-archives-img-href
Switched to a new branch 'fix-archives-img-href'
5. 修改并提交代碼
修改 archives.ftl 文件, add, commit后將改動提交到自己GitHub上的項目鹅巍,也就是 origin 端項目
> git add archives.ftl
> git commit -m "fix archives img and href url"
> git push origin fix-archives-img-href
這樣這個改動就會到自己GitHub的項目里了
6. 向原始項目提交 pull request
提交代碼后千扶,自己項目的頁面會出現(xiàn)一個 Compare & pull request
的提示
點擊綠色的Compare & pull request
按鈕料祠,注意base 端選擇 原始項目的 master分支, head 端選擇自己項目的新分支。
然后寫好說明澎羞,點擊提交就可以了髓绽,這樣就可以慢慢的等待原始項目的開發(fā)者審核你的pull request, 如果通過的話,我們的代碼改動就會被合進原始項目里了妆绞。
雖然這次只是改動了一點點代碼顺呕,但能夠有機會走一次完整的 pull request 請求,也是很開心括饶,尤其是自己比較感興趣的一個項目株茶。
慢慢的等候,期待原始項目的大佬能通過我的pull request~
參考鏈接:
蘑菇博客
halo-theme-fantastic 主題
creating-a-pull-request 教程