《Flutter 實戰》開源電子書
簡介
本專案為Flutter中文網《Flutter實戰》開源電子書專案,官網地址為: https://book.flutterchina.club .
貢獻須知
本書目前仍在創作中,如果您想參與到本書創作,歡迎提PR。本書目錄結構如下:
目錄及檔案 | 說明 |
---|---|
docs | 文件目錄,您應該在此目錄下對應的章節資料夾下修改/建立Markdown文件 |
_book | 打包後的網站程式碼目錄,您不應該手動修改此目錄下的文件 |
docs/SUMMARY.md | 本書目錄,要修改目錄請參考本文件中前面章節。 |
docs/imgs | 本書所引的圖片、截圖目錄 |
圖片引入說明
為了後續圖片能夠容易上CDN,如果您需要在文件中引入新的圖片,請按如下步驟操作:
-
將您的圖片大小進行調整,有一個要求是圖片高度最大不能超過500畫素,原則上單張圖片最大不能超過300K.
-
將圖片拷貝到docs/imgs目錄,注意不要重名
-
在你的文章中用 相對路徑 引用,如:

當您提交內容被合入後,我們會來上傳CDN,自動替換圖片連結,然後回提到倉庫中,在您下次提交之前,您需要先pull一下變更。
構建環境搭建
本書是採用gitbook編寫,要想在本地執行網站,需要安裝一下環境:
-
安裝node;如果已經安裝過node,可以省略這一步。node安裝方法自行百度。
-
安裝gitbook。
npm i -g gitbook gitbook-cli
-
本地進入到本專案根目錄,執行:
gitbook install #安裝本書構建所要依賴的外掛
-
執行網站,可以編輯了~
gitbook serve
哪些章節還沒有寫?
本書目前未完成部分在官網目錄中會置灰,他們會統一連結到一個todo頁面,您應該首先來寫這一部分主題。如果您有新的章節想補充,請先聯絡我!溝通後如果覺得有必要方可新增。
提交更新
為了保證書籍質量,提交後的內容都需要Review,所以您PR提交之後離正式合入可能會需要多次修改,為了節省時間,請在提交PR後的第一時間通知我Review。
勘誤
如果您發現本書的錯誤,歡迎PR。
聯絡方式
微訊號:Demons-du
免費?
知識是應該付費的,創作不易,開源不等於免費,如果您是本書讀者並手頭寬裕,可以微信掃描下面二維碼打賞,也不用太多,夠買一杯咖啡就行。當然,如果您囊中羞澀,您也可以閱讀本書,但我對您有個小小的要求,希望您在閱讀的過程中能積極參與到本書的糾錯以及未完成內容的創作上來,也算是有所付出。