(以及为什么你认为 jQuery 团队不能或不愿意编写像样的文档?;)
例如,访问http://jqueryui.com/download/all/并下载
#1
- 有一个
MANIFEST
文件。 - 有一个
README.md
文件,但没有说明档案的布局。 - 有几个带有 JSON 扩展名的文件,例如
ui.accordion.jquery.json
. 它们包含有关特定 UI 小部件的一些信息。我不知道这些是干什么用的,你知道吗? - 一个名为
package.json
. 它似乎只是一些 JSON 格式的库信息。你知道这是干什么用的吗?我怀疑它与其他.json
文件相关联,但谁知道呢? - 有一个名为
external
包含 javascripts 的目录。你知道这是干什么用的吗? - 有
jquery-1.9.1.js
文件。没有缩小版。 - 中的许可证
MIT-LICENSE.txt
。 - 包含贡献者姓名的
AUTHORS.txt
文件,在整个档案中重复多次。但是,他们中没有一个人能够彻底列出档案中的内容;) - 一个
demos
目录,其中包含网站上的所有演示。 - 自述文件中所说的A
Gruntfile.js
用于构建 jQuery。无论“构建”jQuery 意味着什么。 - 一个
tests
目录。 - 有一个名为的目录
ui
似乎包含所有 jQuery UI 效果 javascript,也在一个子目录中缩小,以及一个i18n
用于那些需要国际化的小部件的子目录。 - 有一个名为 的目录
themes
。其中有一个名为的子目录base
,它包含基本主题样式表。此子目录还包含images
基本主题的目录。它还包含几个效果的样式表,例如jquery.ui.accordion.css
. 这些仅适用于基本主题还是可以应用于任何主题?如果没有,为什么只有 base 有它们?(见下文)还有一个minified
子目录,其中包含所有样式表的缩小版本。
#2
- 存档包含一个
MANIFEST
文件 - 但没有自述文件。
- 作者文件。
package.json
包含少量项目信息的文件。- 它有几个主题,但没有
base
。 - 根目录或每个主题的目录中都没有效果/小部件文件。
- 每个主题目录都包含一个
images
子目录,其中包含与该主题相关的图像文件、一个jquery-ui.css
样式表、一个缩小版本和一个jquery.ui.theme.css
. 每个主题目录中的jquery-ui.css
每个目录都不同。你知道每个文件的用途吗?为什么不是jquery.ui.theme.css
文件中的所有特定更改?
为什么我需要知道这个?
这可能会出现在评论中,所以我会在这里回答。我编写了几个库来帮助在 Ruby Rack 项目、Rack JQueryUI和Rack JQueryUI Themes中部署正确的版本/主题。每次 jQuery UI 发生版本更改时,我都必须处理这些未记录的档案,这些档案似乎也在版本之间的布局/内容上发生了变化。与 jQuery 团队交谈时,我没有得到很好的反馈——我发现他们在文档方面很可悲,这显然不是他们的优先事项,他们宁愿重命名函数或其他东西——所以我宁愿有一个有用的答案我在这里,这将是一个保存它的好地方(可以这么说)。
我对主题目录周围的问题最感兴趣,因为这将直接帮助我,但我已经扩展了问题的范围,因为我相信它会帮助其他人并且我很好奇。