开放静态文件 CDN是一个开放的堆栈,周全收录优异的开源库,并免费为之供应 CDN 加快效劳。
一、背景和目的
像 Google Ajax Library,Microsoft ASP.net CDN,SAE,Baidu,Upyun 等 CDN 上都免费供应的 JS 库的存储,但运用起来却都有些范围,由于他们只供应了部份 JS 库。固然,我们还能够有像 CDNJS 如许的平台,存储了大部份主流的 JS 库,以至 CSS、image 和 swf,但国内的接见速率却不是很抱负,而且缺乏许多国内优异开源库。
因而,我们供应如许一个堆栈,让它尽量周全收录优异的开源库,并免费为之供应 CDN
加快效劳,使之有更好的接见速率和稳固的环境。同时,我们也供应开源库源接入的进口,让一切人都能够提交开源库,包含 JS、CSS、image 和 swf 等静态文件。
二、怎样提交开源库
Fork 这个堆栈,在 libs/下新建一个目次,这个目次下能够有多个版本(最少一个版本)如:
├── jquery # ... 库名
│ ├── 1.8.3 # ... 版本号
│ └── jquery.min.js # ... 文件名,不带版本
│ ├── 1.9.1
│ └── jquery.min.js
└── package.json # ... 最新版本文件的形貌
编辑 package.json 形貌文件,这个文件形貌最新版本的信息。详细写法请参照:libs/typo.css/package.json。
{
// 这三项让你的文件能正常被索引到
// 项目名要与文件夹名一致
"name": "项目名",
"filename": "主文件名,比方 XYZ.js",
"version": "1.0",
// 其他
"description": "项目简介",
"homepage": "项目主页,如 http://staticfile.org",
"keywords": [],
"maintainers": [
{
"name": "作者/保护者",
"web": "http://staticfile.org",
"mail": "trimidea@gmail.com"
}
],
"repositories": [
{
// svn 等
"type": "git",
"url": "https://github.com/staticfile/static"
}
]
}
然后给这个堆栈提交 Pull Request。理论上我们会用最快的速率考证、考核这个库。一旦 Pull Request 被
Merge,则立时能够能过 CDN 接见。
为了保证存放在CDN上开源库的质量,我们发起提交的堆栈有肯定的关注度(包含Github的star,其他堆栈平台的珍藏数目等可参考数值),现在发起这个数目在20以上。
三、更新开源库
理论上我们自动更新库的版本文件,而且不会删除旧版本,但假如你在 staticfile.org 找不到最新的版本,则能够通过往该库中增加一个版本目次,而且修正响应的
package.json 文件,应用 Pull Request 来提示我们。
四、运用注重
虽然大多数库都是基于 MIT / BSD License 开源的,但在有某些库在个人/贸易应用上是有区分的,比方 highcharts 这个库,所以请人人在运用这些库的时刻,最好能点击其网站、代码堆栈(在搜刮效果中有链接)中检察其开源协定。
五、作者和效劳商
此堆栈由 Sofish、hfcorriez 和 ikbear 更新和保护。由国内优异的云存储效劳商 七牛云存储 供应存储和加快。外洋源同步于 CDNJS,谢谢一切开源库作者的勤奋。
六、开源协定
堆栈基于 MIT License 开源
CDN 加快由七牛存储供应
via staticfile.org.