-
Notifications
You must be signed in to change notification settings - Fork 19
/
Copy pathabout.html
executable file
·126 lines (103 loc) · 6.55 KB
/
about.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<!DOCTYPE html>
<html ng-app="static" class="doc">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="开放静态文件 - 为开源库稳定、快速的免费 CDN 服务 - powered by 七牛">
<title>简介 - 开放静态文件 CDN - powered by 七牛</title>
<link rel="stylesheet" href="http://cdn.staticfile.org/typo.css/1.1/typo.css" />
<link rel="stylesheet" href="http://cdn.staticfile.org/prettify/r298/prettify.min.css" />
<link rel="stylesheet" href="static/app.css" />
<link rel="shortcut icon" href="/favicon.ico" />
</head>
<body ng-controller="libListCtrl">
<div id="header" class="wrapper"></div>
<div class="wrapper">
<h1 class="typo-h1"><a href="/">开放静态文件 CDN</a></h1>
<div id="nav">
<a href="/">首页</a> /
<a href="about.html#howto">新增一个库</a> /
<a href="https://github.com/staticfile/static/issues" target="_blank">意见反馈</a> /
<a href="about.html">简介</a> /
<a href="index_en.html">English</a>
</div>
<div id="githubbtn" class="wrapper">
<iframe src="http://ghbtns.com/github-btn.html?user=staticfile&repo=static&type=watch&count=true" allowtransparency="true" frameborder="0" height="20px" scrolling="0" width="85px"></iframe>
<iframe src="http://ghbtns.com/github-btn.html?user=staticfile&repo=static&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="95" height="20"></iframe>
</div>
</div>
<div class="wrapper typo" id="about">
<h3>一、背景和目标</h3>
<p>像 Google Ajax Library，Microsoft ASP.net CDN，SAE，Baidu，Upyun 等 CDN 上都免费提供的 JS 库的存储，但使用起来却都有些局限，因为他们只提供了部分 JS 库。当然，我们还可以有像 CDNJS 这样的平台，存储了大部分主流的 JS 库，甚至 CSS、image 和 swf，但国内的访问速度却不是很理想，并且缺少很多国内优秀开源库。</p>
<p>因此，我们提供这样一个仓库，让它尽可能全面收录优秀的开源库，并免费为之提供 CDN 加速服务，使之有更好的访问速度和稳定的环境。同时，我们也提供开源库源接入的入口，让所有人都可以提交开源库，包括 JS、CSS、image 和 swf 等静态文件。</p>
<h3 id="howto">二、如何提交开源库</h3>
<p><a href="https://github.com/staticfile/static" target="_blank">Fork 这个仓库</a>，在 libs/ 下新建一个目录，这个目录下可以有多个版本（至少一个版本）如：</p>
<pre class="prettyprint lang-bash">.
├── jquery # ... 库名
│ ├── 1.8.3 # ... 版本号
│ | └── jquery.min.js # ... 文件名，不带版本
│ └── 1.9.1
│ └── jquery.min.js
└── package.json # ... 最新版本文件的描述
</pre>
<p>编辑 package.json 描述文件，这个文件描述最新版本的信息。具体写法请参照：<a href="https://github.com/staticfile/static/blob/master/libs/typo.css/package.json">libs/typo.css/package.json</a>。</p>
<pre class="prettyprint lang-js">
{
// 这三项让你的文件能正常被索引到
// 项目名要与文件夹名一致
"name": "项目名",
"filename": "主文件名，比如 XYZ.js",
"version": "1.0",
// 其他
"description": "项目简介",
"homepage": "项目主页，如 http://staticfile.org",
"keywords": [],
"maintainers": [
{
"name": "作者/维护者",
"web": "http://staticfile.org",
"mail": "[email protected]"
}
],
"repositories": [
{
// svn 等
"type": "git",
"url": "https://github.com/staticfile/static"
}
]
}
</pre>
<p>然后给这个仓库提交 Pull Request。理论上我们会用最快的速度验证、审核这个库。一旦 Pull Request 被 Merge，则马上可以能过 CDN 访问。</p>
<p class="com">为了保证存放在CDN上开源库的质量，我们建议提交的仓库有一定的关注度（包括Github的star，其他仓库平台的收藏数量等可参考数值），目前建议这个数量在20以上。</p>
<h3>三、更新开源库</h3>
<p>理论上我们自动更新库的版本文件，并且不会删除旧版本，但如果你在 <a href="http://staticfile.org">staticfile.org</a> 找不到最新的版本，则可以通过往该库中添加一个版本目录，并且修改相应的 package.json 文件，利用 Pull Request 来提醒我们。</p>
<h3>四、使用注意</h3>
<p>虽然大多数库都是基于 MIT / BSD License 开源的，但在有某些库在个人/商业应用上是有区别的，比如 Highcharts 这个库，所以请大家在使用这些库的时候，最好能点击其网站、代码仓库（在搜索结果中有链接）中查看其开源协议。</p>
<h3>五、作者和服务商</h3>
<i>历史维护者</i>
<ul>
<li><i> <a href="https://github.com/sofish" target="_blank">Sofish</a></i></li>
<li><i> <a href="https://github.com/hfcorriez" target="_blank">hfcorriez</a></i></li>
<li><i><a target="_blank" href="https://github.com/ikbear">ikbear</a></i></li>
</ul>
<p>此仓库由<a href="https://github.com/Xuanwo" target="_blank">Xuanwo</a>和<a href="https://github.com/sorcerer-ma" target="_blank">sorcerer-ma</a>更新和维护。由国内优秀的云存储服务商 <a href="http://qiniu.com/" target="_blank">七牛云存储</a> 提供存储和加速。国外源同步于 <a href="https://github.com/cdnjs/cdnjs" target="_blank">CDNJS</a>，感谢所有开源库作者的努力。</p>
<h3>六、开源协议</h3>
<p>仓库基于 MIT License 开源</p>
</div>
<div id="footer" class="typo wrapper">
<p id="power"><a href="http://qiniu.com" target="_blank"><img src="static/qiniu.png" /></a><br><small>CDN 加速由七牛云存储提供</small></p>
<small>© Copyright 2014 <a href="http://staticfile.org">staticfile.org</a>. Built upon love.</small>
</div>
<script src="http://cdn.staticfile.org/prettify/r298/run_prettify.js"></script>
<script type="text/javascript">
// tracker
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-43035690-1', 'www.staticfile.org');
ga('send', 'pageview');
</script>
</body>
</html>