本文爲“碼良系統的使用及設計實現”系列文章的第一篇。
碼良是啥，咋沒聽過呢
沒聽過？今天你聽過咯~
其實碼良平臺已經存在多時，今年6月份即首次上線，至今註冊用戶不足千人，代碼倉庫 star 數不足500， 維持着穩定的自（zeng）然（zhang）增（ting）長（zhi），也怪不得諸位沒聽過了。
想來，發佈一點使用引導還是很有必要的。
碼良是一個在線 H5 頁面編輯器系統，用於快速製作 H5 頁面。用戶無需掌握複雜的編程技術，通過簡單拖拽、少量配置即可製作精美的頁面。同時，也爲開發者提供了完備的編程接入能力，通過腳本和組件的形式獲得強大的組件行爲及交互控制的能力。
頁面管理方便
按團隊，項目的維度管理項目頁面，方便團隊協作。每個項目都可以有自己的權限，也非常適合多人管理一組項目。
圖爲項目管理界面
編輯操作高效
拖拽挪移，隨心所欲。靈活組合，提高提高效率，保存模板，快速創建。
圖爲編輯器工作區界面
靈活豐富的擴展
可以對組件添加各種腳本，擴展組件的功能，並友好的提供給使用者配置參數
圖爲腳本編輯界面
組件接入簡單
提供方便的腳手架創建組件，你可以把一個小功能，一個頁面，一個項目做成一個組件，暴露參數給其他同學在編輯器裏面填寫
圖爲組件開發套件使用動圖
誰可以使用碼良？
程序員 程序員可以在碼良平臺按業務需要創建自己的組件，並暴露相應參數提供給產品或者設計師方便使用。也可以開發一些腳本擴展已有組件的功能。
設計師 設計師可以製作動畫效果比較好的模板提供給更多的人使用
營銷者 營銷團隊可以使用碼良創建配置非常靈活的頁面，配合獲取到的訪問等數據，可以直觀的看到營銷效果。
更詳盡的介紹請移步官方文檔。
碼良的正確打開方式？
碼良系統目前的體驗/使用途徑主要有兩種：官方服務和 docker 私有部署。
方式一 官方服務
點擊鏈接進入碼良官網 https://godspen.ymm56.com 。
點擊頁面右上角“開始使用”菜單路由至登陸/註冊頁面。
使用郵箱註冊並登陸賬號，或者也可以通過第三方登陸，目前已接入 github 登陸。
至此，您已成功註冊成爲碼良用戶，接下來就可以使用碼良服務了。
大體來說，碼良系統分爲了三部分，管理後臺、頁面編輯器、頁面渲染器。
登入系統之後所看到的即是管理後臺了。碼良的頁面管理分爲三級，團隊、項目和頁面，團隊是用戶的聚合，項目是頁面的聚合，頁面面向終端用戶。此外，管理後臺提供了頁面、項目、團隊維度的受訪數據，可以查看頁面的受訪情況。更詳細的說明見官方文檔。
頁面編輯器是碼良系統的核心，如下是編輯器的工作空間。
圍繞組件操作，編輯器工作區大體分爲組件候選區、組件樹導航區、屬性設置區、通用樣式設置區、腳本設置（編輯）區、動畫編輯區、可視化場景編輯區。看起來可能和市面上其他H5編輯器大同小異，需要特別說明的是，正是腳本編輯能力爲頁面編輯提供了無限可能，腳本可以擴展組件功能、可以被複用、幾乎具備完全的組件控制能力，並支持 es6+ 語法。
頁面保存發佈後，碼良貼心地提供了訪問鏈接、短鏈以及二維碼，點擊頁面設置面板即可看到。
以下是部分功能和頁面的截圖，要想更直觀地感受碼良平臺的能力，速速註冊體驗吧。
精選模板頁面
頁面受訪數據
資源管理
優雅的pc端展示效果
限於篇幅，碼良平臺的使用不能詳盡介紹，更多細節請快快註冊體驗吧，官方文檔也是圖文並茂的，更有視頻操作說明哦。
方式二 docker 私有部署
儘管官方服務免費註冊即可使用，已經很方便了，但是我們還提供了私有 docker 部署能力，讓您能將碼良系統運行在自己的服務器上。
對於熟悉 docker 技術的同學來說，依照以下步驟即可迅速完成部署操作。
- clone 配置倉庫到本地，該倉庫提供了 docker-compose 配置。
- 準備一臺服務器，當然，私人電腦也可，但是原則上不推薦 windows 系統機器。
- 安裝 docker 環境、及 docker-compose，如果已有，請略過。
- 接下來依照 readme 說明逐步操作即可。需要提醒的是，一定要依照說明修改
config.yaml配置。
對於不太熟悉 docker 技術的同學，在後續文章（docker 從入門到放棄中，/笑）中會詳細一步步指引如何操作，敬請期待。
方式三 源碼運行
說好的兩種方式呢？方式三什麼鬼
方式三目前不具備可操作性，可我還是想說，/任性
碼良團隊以極廣的胸懷提供了免費官方服務的同時，又提供了docker 部署能力，同時計劃着整個項目的開源，目前已經開源了最核心的部分——編輯器的代碼。在不久的將來，完成代碼整理和安全審查以後，我們會將所有代碼開源，屆時，您將可以直接以源碼形式運行整個項目，此爲方式三。
碼良團隊享受了開源精神帶來的便利，也願將自己的一點成果回饋給開源世界。
歡迎 star 問候，熱烈歡迎。
鏈接區
github
docker
碼良官網