项目作者: limingtech-front-end

项目描述 :
提供前端及nodeJs代码库的索引服务,为代码包及文档提供索引支持
高级语言:
项目地址: git://github.com/limingtech-front-end/codebase-index.git
创建时间: 2016-11-16T07:16:02Z
项目社区:https://github.com/limingtech-front-end/codebase-index

开源协议:

下载


limingtech 前端及nodeJs公共代码库索引

建立目的

提供前端及nodeJs代码库的索引服务,为代码包及文档提供索引支持

层级划分基本原则

settings

配置相关,例如全局css reset,全局环境变量配置等

controllers

逻辑控制类,多为抽离于具体功能的抽象封装,例如计数方法,数据状态控制方法等

directives

dom、bom相关操作封装,例如跨平台touch事件封装,滚动位置检测

components

复用性组件,例如搜索框,button控件,多为引用controllers及directives代码和组件相关样式及模板的组合

utilities

功能性方法,例如url参数截取,cookie操作等

threeparties

基于第三方服务、开放API进行封装的以上类别及扩展类别相关代码

templates

适用于不同类型项目的基础结构,非页面模板

层级组织方式与命名规则

为方便开发人员对于代码的引用及自动化构建,远程代码库文件使用扁平化索引方式,不建立显式的目录层级(原理参照npm对依赖的管理方式),本地文件的组织方式依据个人喜好自行安排。
依据上文所述划分原则,命名方式以封装代码所属层级的首字母及其之后未被同级索引命名占用的第一个字母之组合作为索引名,
代码包名前使用短横线拼接其隶属的各个层级,例如:co-loop 表示controller层级下名称为loop的代码包,具体参阅如下(*代表代码包名或子层级名称)

settings

se-*

controllers

co-*

directives

di-*

components

cm-*

utilities

ut-*

threeparties

th-*

templates

te-*

代码包(package)构建与引用指南

基础开发环境的选择

为解决手动处理各种依赖所产生的代码重复加载、执行、引用混乱、版本不统一等问题,使用NodeJs + npm包管理器作为代码包的引用与构建基础,
npm提供了git协同支持,可以节省很多处理包管理器与代码仓库间的衔接问题,因此代码仓库基于git进行构建。

开发环境安装

公共代码包的构建与引用

代码包索引

settings

controllers

directives

components

utilities

threeparties

templates

其他

其余内容不定时更新