首先使用 NPM 的帮助 故障排除指南。如果您仍然遇到问题,并且您已经尝试过 Google 搜索但仍然没有解决,请仔细查看更新后的 Sails 贡献指南,然后在 Sails 库中创建一个 GitHub 问题。
多年来,我们反复认识到要认真对待依赖项的版本控制。我们锁定 Sails 的依赖项版本,并且只在相关更新修复安全问题或为 Sails 用户提供其他实质性优势(改进的兼容性、性能等)时才升级这些版本。此外,Sails 的核心维护者致力于修复我们任何核心依赖项中出现的任何重大安全、性能或稳定性错误——无论这些模块是否 由另一个实体正式维护。
Sails 已在 node 版本 0.10.x 及更高版本上经过测试,但是我们建议使用最新的 LTS 版本的 Node。该框架构建在 Express 和 Socket.io 的坚实基础之上。开箱即用,它还依赖于其他优秀的模块,例如 grunt
、waterline
和 fs-extra
。点击上面的徽章查看 Sails 核心最新稳定版本的完整依赖项列表。
Sails 旗舰用户:我们每周都会手动验证 Sails 及其他官方维护模块的每个依赖项。这包括核心钩子、适配器、生成器、客户端 SDK 和旗舰软件包。我们定期将有关依赖项的安全/兼容性报告发送到与您的帐户关联的主要电子邮件地址。如果您希望团队中的其他人收到这些报告,没问题!只需 告诉我们他们的电子邮件地址,我们会将其设置为接收报告。(这些电子邮件地址还将收到有关补丁、shrinkwrap 更新和兼容性通知的通信。)
如果您对我们的依赖项有任何疑问或疑虑,请 与核心团队成员交谈。请勿提交更改依赖项版本的拉取请求,除非首先 (1) 检查依赖项的变更日志,(2) 验证兼容性,以及 (3) 提交一个附带的 PR 以更新 roadstead,我们的依赖项管理工具。
Sails 被世界各地的个人和公司、非营利组织以及政府实体用于生产环境中,用于各种项目(全新项目和成熟项目)。您可以 此处 查看一些使用 Sails 完成项目的公司示例。(这个小列表肯定不是权威的,所以如果您在您的应用程序/产品/服务中使用 Sails,请 告诉我们!)
The Sails Company 为在 Sails 上构建应用程序的团队提供定制开发、服务、培训、企业级产品和支持。
我们的工作室为初创企业、中小型企业和财富 500 强企业提供开发服务。正如您所料,Sails 核心团队已经做了很多定制的 Sails/Node.js 开发,但我们也拥有跨整个堆栈的经验,包括:高级交互设计、针对大型应用程序的实用/可扩展的 JavaScript 开发实践,以及在许多不同的设备和屏幕分辨率上构建丰富的用户体验。
我们可以从头开始构建您的应用程序和 API,现代化您的旧版 Web 平台,或促进您既有团队的开发工作。如果您有兴趣与我们合作开展您的下一个项目,请 与我们联系。
Sails 旗舰版是在 Sails 之上构建的一个平台,它提供了一套额外的服务、生产级辅助工具和对企业用例的支持。这包括对新功能和增强的抢先体验、我们内部工具的许可证,以及核心维护者创建的独家报告和最佳实践指南。要了解更多信息,请 安排通话(或 立即在线购买)。
我们正在积极扩展此产品,其中包含新功能以及一些以前实验性模块的官方重新发布版本。如果您对新的旗舰软件包有任何具体建议/请求,请 告诉我们。
The Sails Company 还为使用 Sails 构建产品的组织提供了一条生命线。如果您在关键的生产问题发生时需要保证支持,或者只是希望在开发过程中有另外一双眼睛关注您的代码库,请查看我们的 基本订阅,或 联系我们,我们会给您打电话。
除了 官方文档 之外,请务必查看 Sails 网站上推荐的支持选项,并加入我们的 Gitter 聊天室。如果您遇到问题,请务必 在 StackOverflow 上提问,那里有一个 活跃的 Sails 社区。我们核心团队的成员最近在 Platzi 上教授了一门 免费视频课程,并写了一本 书。
如果您是关于 Sails 的教程或指南的作者,请向我们发送一个拉取请求 此处,我们会查看它。(请确保将您的教程添加到相关列表的顶部,因为我们尝试从最新到最旧对这些教程进行排序。)
- 如果您是关于 Sails 的文章的作者,请向我们发送一个拉取请求 此处。我们会查看它!
- 如果您是希望发布关于 Sails 的新闻稿的公司,请联系 @mikermcneil(推特)。我们会尽力提供帮助。
Sails 项目在 GitHub 问题中跟踪错误报告,并使用拉取请求进行功能提案。在创建问题、提交提案或开始处理拉取请求之前,请阅读 贡献指南。
除非你是正在运行框架预发布版本的贡献者,目的是进行一些测试或处理核心工作,否则你应该使用 NPM 上的最新稳定版本的 Sails(点击上面的徽章)。安装很简单 - 只需按照 这些说明 进行操作。
注意:要在现有项目中本地安装/升级到 Sails 的最新版本,请运行
npm install sails@latest --save
。如果你遇到问题,并且正在寻找一个大杀器,你可能还想运行rm -rf node_modules && npm cache clear && npm install sails@latest --force --save && npm install
。
如果你想安装 Sails 的预发布版本,你可以从 npm 的 beta
标签进行安装(例如 npm install sails@beta
)。这是一种提前试用即将发布的版本并开始升级的好方法,以便在发布正式发布之前开始升级。beta npm 发行候选版本与 Sails 库中的 beta
分支相对应。(只需确保也使用你喜欢的适配器和其他插件的正确版本。如有疑问,请随时询问。)
最后,如果你喜欢走在时代前沿,或者你正在添加 Sails 的功能或修复错误,请从 github 上的 master
分支安装边缘版本。边缘版本不会发布到注册表上,因为它一直在开发中,但你仍然可以使用 npm 来安装它(例如 npm install sails@git://github.com/balderdashy/sails.git
)
有关安装 Sails 的 beta 版和边缘版本的更多说明,请查看 贡献指南。
有很多不同的方法可以为 Sails 做贡献;例如,你可以帮助我们改进 官方文档,编写 插件,回答 StackOverflow 问题,创建 Sails 聚会,帮助排查 GitHub 问题,编写一些测试,或者提交 Sails 核心或其依赖项的补丁。在开始之前,请查看 贡献指南。这只是一篇简短的文章,其中介绍了指南和最佳实践,以确保你的辛勤工作将产生最大的影响。
文档是从 github 上的 sails
库 中的 markdown 文件编译而来的。许多 Sails 用户都表示有兴趣模仿我们用来生成 Sails 网站页面上的过程。好消息是这非常简单:Sails 文档的编译过程涉及从 sails 库中的 Markdown 文件生成 HTML,然后执行一些额外的转换,例如添加数据类型气泡、为页面的各个部分添加永久链接标签、构建 JSON 数据以支持侧边导航菜单以及设置 HTML <title>
属性以提高各个文档页面的搜索引擎可发现性。有关更多信息,请参阅 doc-templater 模块。
在 主网站上的文档 用于 Sails 的最新稳定 npm 版本,并与 github 上 sails
库的 master 分支 中的文档镜像(Master 有时领先几个提交,但任何关键的文档更新都会在一天或两天内发布到网站上。)
对于仍然广泛使用的旧版 Sails,文档是从相关的 sails-docs
分支编译的,并托管在以下子域上