Weekly-GitHub-Digest #34
2018/04/19–2018/04/25
Web — 網路本身高風險，請詳閱公開說明書
- QingWei-Li/docsify 🃏 A magical documentation site generator
純文件類型的 repo 在 GitHub 上多不勝數，而其中又以 sindresorhus 首發的 awesome 系列最為人所知。不過在 GitHub 上看實在是有點過於低調，應該說介面可以更華麗一點的啊，如果有個產生器可以用很簡單的方式做到的話應該體驗會更好吧。docsify 在這件事情上的確是非常出色的產生器，創作者只要專注在文件內容本身，剩下的全部交給它處理即可，去年為了響應 GitHub 在每年十月舉辦的 OctoberFest 盛事，因為嫌畫面單調所以就用了 docsify 製作 awesome-singer-official-portal 這個專門收集歌手樂團官方網站的 awesome list。要如何使用呢？Initialize 之後就只要在把 docs 下的東西綁定在 GitHub pages 上瞬間就有個設計感爆棚的頁面了。不覺得挺像 Vue.js 官網的風格嗎ＸＤ
有在聽饒舌的樂迷對 Joey 應該都不陌生，這個圈子厲害的人還是挺多的，台大嘻研社的招牌也不是只有 BR 和熊仔兩個人在扛。懷舊風滿滿的即時通絕對是 90 年代的青春回憶，看這個專案的原始碼應該是要配上 就已 (Joey Huang) — 即時通 Live Messenger 一起服用的，看到混音的是賴暐哲老師膝蓋就不自覺的先跪了，也記得看看影片下方的描述，會更有鞭策自己寫 side project 的動力。還記得國小跟妹子聊天都用即時通，就算場景換到今日的臉書，妹子要不去洗澡要不就是超愛打哈哈哈哈，大概是尷尬癌吧真的不知道到底在哈三小，但其實當時更風行的應該是 MSN，但聊天軟體就是這樣啦，偉大的時代還是會消逝的，後浪推前浪擋也擋不住，只要經歷過那樣的時代的人們心中仍有一片專屬於他們的綠洲那也就足夠了。
Terminal — 已經是 iTerm 的形狀了呢
- egoist/log-horizon A fancy logger for CLI apps
在 CLI 的應用當中，和第三方請求資料的情境必不可少，也意味著使用者必定會耗費不少等待中的時間，而這些流程之間的轉換要如何做得盡可能讓使用者感到無痛就是介面呈現上的藝術了。log-horizon 是一個可以把 logger 樣式升級的 npm package，使用方式如下：
開個新專案，選擇局部安裝即可：
1$ npm install log-horizon想更快看到結果的話建議直接把整包 repo 抓下來，這邊直接用 example 資料夾底下的 icons.js 做為示範：
可以看到它提供的 API 有三種不同的對應，分別是 emoji，badge 和單純的 text，實務上就針對需求個別使用：
在有 GUI 介面的情況下還會使用 CLI apps 的使用者很大比例是對電腦技術有著一定程度熱情的人，外人眼中看起來或許就像是一個文明的倒退擼，明明有漂亮的介面卻放著不用。事實上電腦即便是照著摩爾定律指數型成長並且蓬勃發展數十個年頭以來，CLI 的快捷性依舊是多數開發者優先使用的最大原因之一。
Useful OSS — 好用的開源軟體
- xxhomey19/nba-bar 🏀 🖥️ Check NBA in your menubar
看到這個 repo 有沒有勾起一些印象呢？曾經在 第 10 期 介紹過 nba-go 這個 CLI 專案，為的就是方便開發者在工作之餘也能開 terminal 觀看 NBA 文字轉播現況，還被 GitHub 特別收錄 在他們 Open source project trends for 2018 的專文介紹中，也算是把 CLI 這塊玩出了新格局。這次的 nba-bar 明顯看得出來是為了優化體驗，所以舞台從終端機搬到了 desktop app，使用了 Electron 和 menubar 封裝，在 UI 上不難看出原作者的用心，不過我認為 nba 這系列最大的改進在於受眾層面，因為不是每個人都對電腦感興趣啊，往往我們認為的有趣之處在外人眼中可能是很難理解而被貼上標籤，現在只要動動手指一直點軟體就自己裝好了，從工程師的平流層到普羅大眾都能涵蓋到。
Developers — 開發者們
- Kamran Ahmed Coding and writing stuff for Humans ™
歌壇圈內常常會出現一個現象：歌紅人不紅，人紅是非多。把一首歌唱成名曲之後，歌手本尊卻乏人問津屢見不鮮，GitHub 圈會不會也有這種狀況呢？那些專案很紅但原作者卻根本不知道是誰。這非常常見啊其實，就不相信把 JS 或是 Python 的老爸邀請到大拜拜現場，在沒有特別介紹的情況下有幾個人可以認出來。不過話說回來如果能夠藉由一個開源專案的架構讓別人認識到你這個人的開發能力，這點絕對是特別公平的。曾經在 第 29 期 介紹過 Kamran Ahmed 的專案 driver.js，不過更多人知道的應該是 developer-roadmap 和 design-patterns-for-humans 這兩個專案 (這邊偷渡一下，想看中文的可以參照這份台灣人翻譯的 版本)，既活躍在 GitHub 以外也在 Medium 上發表過不少文章，有心想增加自身在開源圈內影響力的人不妨學學 Kamran Ahmed 的經營方式。或許你也曾覺得某些明明很好的專案推廣卻每每不順，這其實就跟臉書越改越低的觸及率一樣啊，所謂的爆紅根本就不是短時間內一大群人轉發，而是少數意見領袖做為大聲公在短時間內廣泛傳播才造成的效應。除了繼續把質量提升，或許現階段還是該腳踏實地ㄧ點，在多個平台上積極經營才能讓能見度提高。
Technical Posts — 你都去哪看技術文啊城武
- Soft & Share 告訴我, 我會忘記; 教導我, 我只是記得; 讓我深入其中, 我便學會
最早是從臉書粉專得知 Soft & Share，論教學網站平台的話，國內有 Hahow 而國外有 Udemy，Soft & Share 幾乎每天都會有至少一門課程是完全免費的，要不然就是可以用超誇張的折扣購買，所以之後如果有需要上 Udemy 自我進修之類的都建議先去看看有沒有折扣碼，不然一門課的原價光看就蠻吐血的。覺得 Soft & Share 的好處在於還有一個類似讀書筆記的部落格，大部分都是授權過後的翻譯文章，從軟體工程師的生涯規劃到各種雞湯文，不過就算是雞湯文文中給出的意見都有種被打到的感覺，就是真的在工作日常看到這些描述且對內容會格外有共鳴。出社會一年多真的已經是軟體工程的形狀了呢。
You Need Some Music, And A Bottle of Dry Martini — 你一定要把氣氛搞得這麼銷魂嗎
大二升大三的暑假那年被室友 (熬夜吃建宏牛肉麵的那位損友) 推坑 Guilty Crown，說是什麼必看的神作結果途中接近劇情高潮時一直爆雷，你妹的原本想好好利用長假練習英文的，結果卻變成前前後後看了足足有四次，不過也得感謝當時藉此認識到 ACG 界的編曲大師 Sawano Hiroyuki。Rё∀L 做為收錄在罪惡王冠原聲帶的插入曲，歌詞通篇是以德文撰寫而成，雖然真的是聽不出來德文發音準確與否，不過德語這項元素放入日本樂曲之中形成的反差感讓 Rё∀L 的內在更顯神秘。擷取一段歌詞如下：“ leere Meldung, falsche Wahrheit, wir sehen nur einen Tell der Dinge, leere meldung, falsche Wahrheit, what is real? was heißt Wirklichkeit? ( 空虛的消息。虛假的真實。我們只看到事物的一部分。空虛的消息。虛假的真實。什麼是真實？什麼是現實？ )”。去對照中譯會發現這其實可以延伸到很多層面，不覺得這根本就是在反映假新聞嗎？最後聊聊動漫樂曲本身。類似經驗發生在很多人身上，心血來潮去追部嚮往已久的動畫卻被旁人說很宅，說什麼音樂聽起來不是爆熱血就是感覺超奇怪。事實上動漫樂曲的層次編排根本不是流行樂那三兩個簡單和弦莫名其妙就唱完一首能夠比得上的。學吉他的人一定都有聽過這樣的說法，從電吉他踏入木吉他是完全不同的領域，但反之卻是如魚得水，所以很多電吉他界的大師登頂之後轉去練古典吉他。而鋼琴也有類似的看法。給新手練琴最快的方式絕對是彈流行歌(這點和要推坑菜鳥寫 Web 就會叫他/她去寫 Rails 不謀而合)，因為那是建立起信心最為立竿見影的方式，但之後如果有心要繼續往上鑽研修煉，絕對會去練古典樂，這塊值得學習的手法和技巧實在太多了。論池子水深從高到低，我會這樣排：古典，動漫曲，流行樂。
