在 Gitlab 平台簡單創建 GitBook 電子書的步驟

GitLab 提供了 gitbook儲庫 的範本,只要用戶 Fork 該專案,如此就可以建立屬於自己的 GitBook 文檔網站。不過這方式我不太喜歡,需要修改專案名稱等相關屬性,然後也要編輯「README.md」、「SUMMARY.md」內容,如此就會造成 commit 歷史紀錄一開始較為雜亂。 (雖然也可以清除,但又要額外的步驟。)

除了 Fork 的方式,其實也可以自己手動新增空白的專案,然後再針對 GitLab CI (Continuous Integration) 設定並加入執行的腳本內容即可。 (其實就是 gitbook 儲庫內的 .gitlab-ci.yml 內容)

整理下創建 GitBook 網站@GitLab 平台的步驟:

  1. 新增空白專案
    這應該不用說吧,與 GitHub 新增專案的方式幾乎是一樣。大概就是注意下儲庫的存取改為「Public」,然後預設新增一「README.md」檔案,該檔案也是 GitBook 所必要的檔案。

    新增 GitLab 空白專案

  2. 閱讀全文 »

關於 GitBook 平台的改版與 GitLab 替代的考量

GitBook 有兩種含意:一為 GitBook 文件平台;另一則為 採以 Node.js 所開發的命令列工具,用以製作基於 Git/Markdown 所產出精美的電子書文件。

就在今年四月底,Gitbook 平台 (Github 旗下之一),推出所謂的 V2 大改版,改版幅度之大,連帶影響到既有廣大的 V1 開源用戶,預計今年10月左右就要關閉 V1 的使用,強制改版至 V2。但更為難受的是它的 售價策略,Free 方案竟只縮減為只能創建一個「space」,也就是只能創建一本電子書;而付費方案最低則為每個月要支付 7美金 (5 user)!

這肯定會引發一大波開源用戶的出走潮!畢竟絕大多用戶都是基於開源分享的精神將自己的創作 (程式碼/文件) 置於 Github/GitBook 的。 (關於這次 GitBook 大改版,可參考對岸這篇:如何看待 GitBook 的改版?)

所以,要製作開源的電子書在 GitBook 平台短期內 (預期這風波會造成大量用戶的質疑抱怨)並非理想的方案。退而求其次,尋求替代可提供免費文件的平台,並基於 gitbook 工具所製作的電子書,那就非 GitLab 平台莫屬!

GitLab 也有兩種含意:一為 GitLab Inc. 所提供幾乎與 Github 一樣的介面與服務;另一則為該家公司所釋放出基於網路的Git倉庫管理工具,且具有wiki和issue跟蹤功能,可方便私人建構所屬的私有 Git 儲庫平台。

而且 GitLab Inc. 背後可是有強大的金主:Google!所以也不用擔心會有突然關閉或如 Github 那樣不可思議的收費方案。 (額,Github 被微軟收購的,這應該大家都知道吧~。)

要在 GitLab 平台發佈基於 gitbook 工具所製作的電子書並不困難,官方也提供了一個 gitbook 儲庫 (repository) 範本 (可參考它所產出的 靜態文件網頁),可依照該儲庫的 README 說明並 fork 該儲庫即可開始建構所屬自己的電子書。

嗯,其實我個人不太喜歡使用 Fork 的方式當成自己專案的起點,下一篇就來分享下如何在 GitLab 新增專案並配置成可被持續發佈的 GitBook 文件網站。 (其實步驟比想像得還簡單)

ArchLinux 跑 Virtualbox Seamless 無縫模式@Windows 10

原來以為透過 WSL 執行 ArchLinux 是在 Windows 10 系統內執行 Linux 相關應用程式會是理想的解決方案。但,當我在 WSL 要安裝 XFCE 桌面環境卻是問題多多 (Console 模式則很正常)。雖然仍可以啟動 XFCE 並跑應用程式,但我查看 Log 卻是錯誤訊息一堆,大都與 DBus、GTK 等相關的問題,查找 Google 卻是沒看出所以然。看來現階段在 WSL 跑 Linux 還不太完美 (另外還有效能的問題),所以只好先關閉 WSL,等待下一次 Windows 10 釋出較大改版再來試裝。

退而求其次,只好還是在虛擬機上執行 ArchLinux 了。這次我不使用 Vmware 了,占用系統資源太多 (雖然它執行虛擬系統效能會好上很多),改嘗試使用 Virtualbox 並透過它的 Seamless 無縫模式執行 Linux 應用程式。

這是我第一次使用 Virtualbox,不過安裝虛擬系統倒是很簡單,網路分享安裝文件很多。大概幾個選項,勾選 3D 加速、動態配置儲存空間 (最大空間設為 32Gb)、4GB RAM、切了單核2線程 (我的 Intel CPU 是 i7-7700hq 八核心),這樣就可以在虛擬機環境下安裝 ArchLinux 了。

閱讀全文 »

安裝 ArchLinux @Windows 10 子系統 (WSL)

其實 Windows 10 早在去年就已具有可以在 Windows 環境下執行 Ubuntu 的機制,但還很陽春,效能不佳,問題多多。但從 Windows 10 1803 版本釋出後,WSL (Windows Subsystem for Linux) 已修正諸多問題並大幅提昇執行效能,使其執行原生 Linux 系統於 Windows 10 環境下成為可便利運行的方案。

所以,WSL 到底是什麼?這篇 Arch Wiki 上說明得很清楚:

「Windows 10 包含一個模擬 Linux 內核的子系統,使得 windows 可以運行 Linux 原生應用程序。這個子系統有點像反過來的 Wine,但是它比 Wine 更加底層。默認情況下,此子系統使用 Ubuntu 用戶空間,但是它可以被替換成 Arch。你需要使用一個現有的 Arch 安裝去構建一些軟件包。」

我個人是相當偏好 ArchLinux,因為可以高度客製化。安裝 ArchLinux 於 WSL 下相當簡單,因為國外已經有大神整理成安裝執行包,詳見 Github-ArchWSL。安裝該執行包前,需要先啟動 WSL 功能,使用 Administrator 開啟 PowerShell 命令列視窗,執行下列指令:

> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

重新啟動,然後下載上述 ArchWSL 安裝包,解壓縮並置於準備安裝的目錄下 (我是設定於 C:\Linux\ArchLinux 目錄下)。再來依照執行 ARCH.exe,靜待安裝過程 (非常快),然後完成。

閱讀全文 »

大幅提昇實體硬碟讀寫效率的超效工具-PrimoCache

其實我早已購買了對岸研發的「Primo Ramdisk」,一次買三套授權,而且用了好幾年,用得非常滿意。我利用 Ramdisk 切割了約 5~8GB 的 DRAM作為邏輯硬碟 (例如磁碟代號為 R),然後把系統的暫存位置 (TEMP)指向 R磁碟,如此可以大幅提昇系統暫存檔案的讀寫效能,且也比較得以降低 SSD (作為系統碟)的寫入次數,進而延續 SSD 的使用壽命。

該家公司有另一套產品:「PrimoCache」,作用幾乎等同於最近 Intel 新發表的「Optane Cache」,採以 Optane 專屬記憶體 (比 SSD 快上幾倍)來作為 SSD 的內存 (Cache)。不過不同的是 PrimoCache 則採以 DRAM 與 隨身碟 (Flash Memory)於 Windows-based OS 層級 (也就是不能使用在如 Linux 系統)作為包括 SSD、機械硬碟的內存。

    簡單比較:

  • Optane 屬硬體規格,主機板要能有支援;PrimoCache 為 Windows OS層級的工具軟體。
  • Optane 需使用專屬的實體記憶體,目前僅支援 32GB,而且不太便宜;PrimoCache 則採以 DRAM 與 隨身碟作為一級與二級的緩存。

簡而言之,若主機板有 16GB 以上記憶體,且主要的作業系統為 Windows 7/10,那麼採以 PrimoCache 是蠻好的 C/P 值,一套授權約台幣九百,且設定彈性相當十足。

我的桌機就有 32GB 記憶體,還有一條號稱高效讀取 SSD等級的隨身碟 (64GB USB3.0)。而儲存機制除了系統碟是 256GB 的 Intel SSD 外,還有兩顆大容量的機械硬碟 (7200 轉),一顆昨為文書碟、另一則為遊戲碟。

閱讀全文 »

決心走出白漫城-使用 MO 重新安裝 Skyrim SE

Skryim 是神作,它的開放世界觀、自由度之高,以及起碼數萬種類模組 (還在持續增加),絕對是讓其奠立為永垂不朽的遊戲鉅作沒有之一。

我從 Skyrim 傳奇版 (32bit),直到 Skyrim SE (64bit)版,最少有五年的時間,來回安裝眾模組 (MODs)起碼有十數次之多了。但早期 32bit 版本最多只能支持 4GB 記憶體,造成很容易 CTD 跳出;而 SE 版則是 2016/10 才推出,初期模組數量支援不多,還有最重要的 SKSE (腳本擴展工具)前一年都還未能釋放出來,直至這兩個月總算推出相當穩定的版本 (目前為 2.0.7)。

以前只要一有 CTD 跳出,就導致我失去繼續玩的動力。事實上,花在安裝模組的時間,遠比實際玩遊戲的時間多太多太多了,難怪乎玩友們都說玩了 Skryim 那麼多年,還是仍停留在「河木鎮 (新手城鎮)」與「白漫城 (第一個主城)」。

嗯,這次因為穩定版的 SKSE 64bit 釋出,還有這篇超級超級棒的 MODs 整理文:【心得】個人MOD使用、排序、管理 (持續更新),所有具代表性的 MOD 且已分類好及中文化的檔案提供直接透過谷歌磁碟下載,真是太有熱忱了,造福廣大台灣用戶玩家。

照著該文的安裝指引,另外我是使用 MO (Mod Organizer) 來安裝與管理模組的。 (MO 真是神奇的工具,它創始了以虛擬整合模組的方式,使得很容易調整與管理模組。) 這樣陸續安裝了兩、三個星期左右,總算開啟了新遊戲,體驗在這天際廣袤無垠的上古世界冒險解任,瀏覽觀賞這豐富多樣的美麗景色 (安裝各類景觀、天氣等模組後)。

閱讀全文 »

軟體思維顧問

專職軟體輔導與教育訓練的獨立顧問。輔導企業資訊單位如何有效組織系統開發與維護;輔導開發人員達成有效的專業分工。傳授如何把軟體作軟 (Keeping Software Soft)的技能,得以提昇系統的彈性/延展,並進而創造系統的再利用價值。

Personal