[ng-alain系列]目錄結構與版本升級說明

目錄結構與版本升級說明

ng-alain 會一直與 ng-zorro-antd 保持同步更新，但這不表明你須要從新克隆 ng-alain。

目錄結構

項目是經過 ng new 來構建的，就如同你平時要建立項目同樣，所以，當你克隆 ng-alain 到你本地後，只須要執行 npm install，那麼就至關構建好一個新項目。

如下是一個完整的大概結構：

_documents (容許刪除)
_screenshot (容許刪除)
src
    app
        core
            menu
            preloader
            settings
            themes
            translator (可選：國際化)
        layout
        routes
        shared
            directives (可選：若干自定義的指令)
            styles
    assets
        i18n (可選：國際化)
        img  (可選：一些圖片資源)
        ueditor  (可選：百度ueditor)
.angular-cli.json
package.json

對於可選的文件夾，容許你直接刪除，但可能會因爲一些依賴倒置編譯失敗，能夠根據編譯結果自行調整並刪除相關語句。

core

core文件夾包括菜單配置、佈局配置、顏色主題、國際化（可選）；我建議若是企業後臺無須國際化容許刪除它。而其餘建議保留。

layout

頁面總體佈局結構，包括：頭部、左邊菜單，除非在更新日誌中明確提醒不然該目錄不太會變更。

routes

具體業務頁面能夠所有放在該目錄下面。有關文件結構，能夠參考裏面的風格。這裏的內容對於後續的升級不會有任何是影響。

shared/styles

核心文件，除非你知道你在幹什麼，不然不建議你去調整它們。

.angular-cli.json

scripts 節點除了 app/core/preloader/preloader.js 之外，其餘第三方類庫也能夠移除。

項目名稱問題

因爲是直接克隆的基礎上進行開發，所以，對於項目命名上面，有一個竅門是搜索整個文件夾把 ng-alain 替換成你的名稱便可。

後續升級注意項

除非在更新日誌中明確指出須要對DOM結構上有所調整之外，任何一次的版本升級（主要是修復一些兼容性問題）你能夠直接將 shared/styles 覆蓋你的老版本便可。