下面開始我們的教學時間: 首先,請註冊一個GitHub賬號(https://github.com/)。註冊流程非常簡單,1分鐘內即可搞定。
登入Github賬號,開啟星雲Wiki頁面。
(星雲Wiki中文介面,點選左下角 “v.latest”,彈出的介面可切換語言版本,下載不同格式的星雲Wiki文件。)
下面進入實戰狀態:比如我要新增一條動態。開啟星雲動態選單,進入動態頁面。
點選右上角 ”Edit on GitHub”,進入GitHub介面。看到圖中紅圈內的小筆了嗎,點選後正式進入文字編輯介面。
怎麼看起來跟我們平常的Word編輯介面不一樣?沒錯,星雲Wiki的編輯需要使用Markdown語言,跟我們平常使用的Word不那麼一樣。
編輯星雲Wiki需要使用的Markdown語言很簡單,主要有以下幾種編輯邏輯。
(一張圖看懂Markdown主要用法)
如果嫌麻煩,網上有很多好用的線上Markdowan編輯器,非常好用。
這裡推薦一款:https://www.mdeditor.com/
好了,接下來我們開始編輯內容:新增一個連結。
編輯完畢,可以點選“Preview changes”預覽效果。如果效果令你滿意,進入下一步。
在頁面底部,簡要表述更新的內容(方便管理員稽覈),然後點選“Propose file change”。
還需要點選一次“Create pull request”, 提交推送請求。
最後再確認一下,再次點選“Create pull request”。總共點選三次不同的綠色按鍵,才算真正地把修改請求傳送給管理員。
看到下面這個介面,才算大功告成。這個時候,你需要做的就是等待管理員的稽覈。
管理員稽覈過後,可以發現,你所更新的內容已經可以在星雲Wiki上正常顯示了。恭喜你,你已經為星雲Wiki作出了貢獻,任何使用星雲Wiki的人,將會看到你所更新的內容。
到目前為止,你已經學會了如何在星雲Wiki上已有的選單中新增完善其中的內容。還等什麼,趕快登陸GitHub開始貢獻你的力量吧!
上面文章我們教大家如何在星雲Wiki已有的欄目下編寫內容。
那麼,如果有社羣小夥伴想建立新的欄目,那麼具體該怎麼操作呢?
So easy!
比如有社羣小夥伴想在“社羣”選單下面建立“活動”一頁。那麼請點選右上角“Edit on GitHub”,進入GitHub編輯頁面。
選取要建立新頁面所在的資料夾,點選進入。
* 這裡需要稍微解釋下,md字尾的檔案,代表單頁頁面;README.rst,用來控制檔案的排列順序。
點選右上角的“Create new file”,建立新檔案。
上面紅框內容是給後臺檔案命名,下面紅框內容是Wiki顯示標題。
下面的提交流程就和“星雲Wiki教程(上)”裡所講解的一樣啦。
接下來我們要修改下檔名稱新增到目錄中去,並在此提交修改。修改透過後,新頁面就可以在Wiki頁面正常顯示了。
* 在新增目錄的時候,需要注意兩點:README.rst中檔名稱要跟之前建立的檔名稱保持一致,README.rst目錄的排序決定著檔案在星雲Wiki最終的顯示順序。
好了,我們的簡明星雲Wiki教程到此結束,趕快參與星雲Wiki的維護吧。