開篇: 碼良的正確打開方式

本文爲「碼良系統的使用及設計實現」系列文章的第一篇。

碼良是啥，咋沒聽過呢

沒聽過？今天你聽過咯~

其實碼良平臺已經存在多時，今年6月份即首次上線，至今註冊用戶不足千人，代碼倉庫 star 數不足500， 維持着穩定的自（zeng）然（zhang）增（ting）長（zhi），也怪不得諸位沒聽過了。

想來，發佈一點使用引導仍是頗有必要的。

碼良是一個在線 H5 頁面編輯器系統，用於快速製做 H5 頁面。用戶無需掌握複雜的編程技術，經過簡單拖拽、少許配置便可製做精美的頁面。同時，也爲開發者提供了完備的編程接入能力，經過腳本和組件的形式得到強大的組件行爲及交互控制的能力。

頁面管理方便

按團隊，項目的維度管理項目頁面，方便團隊協做。每一個項目均可以有本身的權限，也很是適合多人管理一組項目。

圖爲項目管理界面

編輯操做高效

拖拽挪移，爲所欲爲。靈活組合，提升提升效率，保存模板，快速建立。

圖爲編輯器工做區界面

靈活豐富的擴展

能夠對組件添加各類腳本，擴展組件的功能，並友好的提供給使用者配置參數

圖爲腳本編輯界面

組件接入簡單

提供方便的腳手架建立組件，你能夠把一個小功能，一個頁面，一個項目作成一個組件，暴露參數給其餘同窗在編輯器裏面填寫

圖爲組件開發套件使用動圖

誰可使用碼良？

程序員 程序員能夠在碼良平臺按業務須要建立本身的組件，並暴露相應參數提供給產品或者設計師方便使用。也能夠開發一些腳本擴展已有組件的功能。

設計師 設計師能夠製做動畫效果比較好的模板提供給更多的人使用

營銷者 營銷團隊可使用碼良建立配置很是靈活的頁面，配合獲取到的訪問等數據，能夠直觀的看到營銷效果。

更詳盡的介紹請移步官方文檔。

碼良的正確打開方式？

碼良系統目前的體驗/使用途徑主要有兩種：官方服務和 docker 私有部署。

方式一 官方服務

點擊連接進入碼良官網 godspen.ymm56.com 。

點擊頁面右上角「開始使用」菜單路由至登錄/註冊頁面。

使用郵箱註冊並登錄帳號，或者也能夠經過第三方登錄，目前已接入 github 登錄。

至此，您已成功註冊成爲碼良用戶，接下來就可使用碼良服務了。

大致來講，碼良系統分爲了三部分，管理後臺、頁面編輯器、頁面渲染器。

登入系統以後所看到的便是管理後臺了。碼良的頁面管理分爲三級，團隊、項目和頁面，團隊是用戶的聚合，項目是頁面的聚合，頁面面向終端用戶。此外，管理後臺提供了頁面、項目、團隊維度的受訪數據，能夠查看頁面的受訪狀況。更詳細的說明見官方文檔。

頁面編輯器是碼良系統的核心，以下是編輯器的工做空間。

圍繞組件操做，編輯器工做區大致分爲組件候選區、組件樹導航區、屬性設置區、通用樣式設置區、腳本設置（編輯）區、動畫編輯區、可視化場景編輯區。看起來可能和市面上其餘H5編輯器大同小異，須要特別說明的是，正是腳本編輯能力爲頁面編輯提供了無限可能，腳本能夠擴展組件功能、能夠被複用、幾乎具有徹底的組件控制能力，並支持 es6+ 語法。

頁面保存發佈後，碼良貼心地提供了訪問連接、短鏈以及二維碼，點擊頁面設置面板便可看到。

如下是部分功能和頁面的截圖，要想更直觀地感覺碼良平臺的能力，速速註冊體驗吧。

精選模板頁面

頁面受訪數據

資源管理

優雅的pc端展現效果

限於篇幅，碼良平臺的使用不能詳盡介紹，更多細節請快快註冊體驗吧，官方文檔也是圖文並茂的，更有視頻操做說明哦。

方式二 docker 私有部署

儘管官方服務免費註冊便可使用，已經很方便了，可是咱們還提供了私有 docker 部署能力，讓您能將碼良系統運行在本身的服務器上。

對於熟悉 docker 技術的同窗來講，依照如下步驟便可迅速完成部署操做。

1. clone 配置倉庫到本地，該倉庫提供了 docker-compose 配置。
2. 準備一臺服務器，固然，私人電腦也可，可是原則上不推薦 windows 系統機器。
3. 安裝 docker 環境、及 docker-compose，若是已有，請略過。
4. 接下來依照 readme 說明逐步操做便可。須要提醒的是，必定要依照說明修改 config.yaml 配置。

對於不太熟悉 docker 技術的同窗，在後續文章（docker 從入門到放棄中，/笑）中會詳細一步步指引如何操做，敬請期待。

方式三 源碼運行

說好的兩種方式呢？方式三什麼鬼

方式三目前不具有可操做性，可我仍是想說，/任性

碼良團隊以極廣的胸懷提供了免費官方服務的同時，又提供了docker 部署能力，同時計劃着整個項目的開源，目前已經開源了最核心的部分——編輯器的代碼。在不久的未來，完成代碼整理和安全審查之後，咱們會將全部代碼開源，屆時，您將能夠直接以源碼形式運行整個項目，此爲方式三。

碼良團隊享受了開源精神帶來的便利，也願將本身的一點成果回饋給開源世界。

歡迎 star 問候，熱烈歡迎。

連接區

github ymm-tech/gods-pen

docker ymm-tech/gods-pen-docker

碼良官網 godspen.ymm56.com/