掉坑記錄

三天時間花了8個小時終于走完一遍gilhub+gitbook+Markdown的使用流程，建立第一本電子書，初步掌握一些使用要點(diǎn)。

謹(jǐn)以此文記錄我在此過程中曾經(jīng)掉過的坑。

-20170205

github

1. 瀏覽器推薦使用chrome

2. 在云端查看更新的歷史版本：點(diǎn)擊commits

安裝桌面端

1. github離線安裝包（windows）是一個解壓縮包，完成后在文件所在文件夾生產(chǎn)一個新的文件夾GitHubDesktop,里面會出現(xiàn)真正的setup程序，點(diǎn)擊即可開始安裝。

2. win32和64版本都能下載成功，不成功有可能是網(wǎng)速不夠。換個人流少網(wǎng)速高的時段即可。

MD語言

• ME的有免費(fèi)版。隨便下個￥58或者pro版本，未繳費(fèi)之前默認(rèn)是免費(fèi)版。

• 本次學(xué)習(xí)中使用到4種語法：標(biāo)題 #；序列 有序1./無序-； 鏈接 ； 加粗 ****

• 語法符號必須用半角英文輸入

• 第一次看語法，記不住不勉強(qiáng)，邊寫邊查幫助

• 同時打開多個文件夾，MD可在同一窗口多頁簽方式展示。

本地repo

• 新建文件方法：

  1. github上建好repo之后，繼續(xù)用creat new file新建文件，再同步到本地。文件名要包含.md的后綴

  2. repo初步建好后同步到客戶端，在本地建分支

     • 新建txt文檔，后綴名改為.md

     • 直接在ME中建立新文檔

     • 文件名必須為英文，比如xx.md，而不能是某某.md，否則云端不認(rèn)，會導(dǎo)致同步失敗。

• 本地更新并完成同步后，打開的github云端查看同步內(nèi)容時，在頁面跳轉(zhuǎn)幾次即可刷新出來。若還是不成功，可登出再登入。

gitbook

• summury的作用是，寫入電子書的目錄鏈接，以便在各章之間進(jìn)行跳轉(zhuǎn)。內(nèi)容用MD語言，選擇使用無序列表或者有序列表都可以。

• 獲取gitbook的分享鏈接：點(diǎn)擊read進(jìn)入電子書界面，把瀏覽器的地址復(fù)制下來

• 選擇Create a new book后，同步github的選項(xiàng)，必須點(diǎn)擊列表的下拉按鈕才會出現(xiàn)。

• 轉(zhuǎn)化為書的時間若太久，右鍵chrome，選擇重新加載。

• 刪除已有電子書：回到gitbook首頁，點(diǎn)擊書右側(cè)edit旁邊的下拉按鈕，選擇settings，在點(diǎn)擊進(jìn)入的頁面最下方，有刪除選項(xiàng)。確認(rèn)刪除時要輸入正確的書名。

• 若在一個repo下存在2個以上的branch，出書對象只支持一個branch的內(nèi)容，即默認(rèn)的branch。默認(rèn)的branch可以在book的settings中做調(diào)整。

• 電子書的內(nèi)容可隨著github同步更新：重新read一遍即可。原鏈接不變。

心得體會

1. 很久沒有這樣認(rèn)真學(xué)習(xí)新東西，又找回學(xué)習(xí)的狀態(tài)，建立信心。

2. 難在開始，接觸陌生領(lǐng)域的畏難心理很重。可先原封不動的照搬文字或者視頻教程的步驟走一遍。

3. 先走一遍粗流程，再去鉆研細(xì)節(jié)。面對新事物，通過粗流程尋找關(guān)鍵步驟及其關(guān)聯(lián)關(guān)系、構(gòu)建自我經(jīng)驗(yàn)的新聯(lián)系和新的心理表征畫面，再往下逐步填充細(xì)節(jié)。先檢視閱讀再分析閱讀的步驟也是同理。

4. 教學(xué)視頻幫助很大，解決很多文字沒有提及的細(xì)節(jié)。每次碰到問題就反復(fù)看視頻，總能找出一些之前遺漏的地方。這種小細(xì)節(jié)在沒有操作經(jīng)驗(yàn)之前，是留意不到的。

疑問

• 圖片鏈接未嘗試

• 尚未理解用MD寫作的好處？

• 如何把github運(yùn)用到工作中？如何協(xié)同工作？

• 一個repo下建立多個branch的作用是什么？

下一步練習(xí)

• 進(jìn)一步學(xué)習(xí)使用MD語句

• 學(xué)習(xí)git的其他教程，是否有其他應(yīng)用場景和技巧可以借鑒

• 再新建一次gitbook