從 NPM 實用的 疑難排解指南 開始。如果您持續遇到問題,並且已嘗試 Google 搜尋但仍感到困惑,請仔細查看更新後的 Sails 貢獻指南,然後在 Sails 儲存庫中建立 GitHub issue。
多年來,我們一次又一次地了解到,非常重視依賴項目的版本控制。我們鎖定 Sails 的依賴項目版本,並且只有在相關更新修復安全性問題或為 Sails 使用者帶來其他實質性優勢(改進的相容性、效能等)時,才會提升這些版本。此外,Sails 的核心維護者致力於修復我們任何核心依賴項目中出現的任何重大安全性、效能或穩定性錯誤——無論這些模組是否 由另一個實體正式維護。
Sails 已使用 node 版本 0.10.x 及更高版本進行測試,但是,我們建議使用最新 LTS 版本的 Node。該框架建立在 Express 和 Socket.io 的堅實基礎之上。開箱即用,它還依賴於其他很棒的模組,例如 grunt
、waterline
和 fs-extra
。按一下上面的徽章以取得最新穩定版本 Sails 核心中依賴項目的完整清單。
Sails 旗艦版使用者: 我們每週手動驗證 Sails 和其他官方維護模組的每個依賴項目。這包括核心 hooks、adapters、generators、client SDK 和旗艦版套件。我們會定期將關於依賴項目的安全性/相容性報告發送到與您的帳戶關聯的主要電子郵件地址。如果您希望您的團隊中有更多人收到這些報告,沒問題!只需 告訴我們 他們的電子郵件地址,我們就會為他們設定。(這些電子郵件地址也將收到關於修補程式、shrinkwrap 更新和相容性通知的通訊。)
如果您對我們的依賴項目有疑問或疑慮,請 與核心團隊成員交談。請勿在未先 (1) 檢查該依賴項目的變更日誌、(2) 驗證相容性以及 (3) 提交隨附的 PR 以更新 roadstead(我們的依賴項目管理工具)的情況下,提交變更依賴項目版本的 pull request。
世界各地的個人和公司、非營利組織和政府實體都在生產環境中使用 Sails,用於各種專案(全新和成熟)。您可以在 這裡 查看一些使用 Sails 進行專案的公司範例。(這個小清單絕對不是權威性的,所以如果您在您的應用程式/產品/服務中使用 Sails,我們很樂意聽到您的消息!
The Sails Company 為在 Sails 上建置應用程式的團隊提供客製化開發、服務、培訓、企業級產品和支援。
我們的工作室為新創公司、中小企業和財富 500 強企業提供開發服務。正如您可能預期的那樣,Sails 核心團隊已經完成了許多客製化 Sails/Node.js 開發,但我們在整個堆疊方面也擁有豐富的經驗,包括:進階互動設計、適用於大型應用程式的實用/可擴展 JavaScript 開發實務,以及跨許多不同裝置和螢幕解析度建置豐富的使用者體驗。
我們可以從頭開始建置您的應用程式和 API、現代化您的舊版網路平台,或促進您已建立的團隊的開發工作。如果您有興趣在您的下一個專案中與我們合作,請 給我們留言。
Sails 旗艦版是 Sails 之上的平台,為企業用例提供一套額外的服務、生產品質的裝備和支援。這包括搶先體驗新功能和增強功能、我們內部工具的許可證,以及核心維護者建立的獨家報告和最佳實務指南。若要了解更多資訊,請 安排通話 (或 立即線上購買)。
我們正在積極擴展此產品產品,新增功能並正式重新發布一些以前實驗性的模組。如果您對新的旗艦版套件有具體的建議/要求,請 告訴我們。
The Sails Company 也為使用 Sails 建置產品的組織提供生命線。如果您在發生重大生產問題時需要有保障的支援,或者只是希望在開發期間有一雙額外的眼睛關注您的程式碼庫,請查看我們的 基本訂閱,或 聯絡我們,我們會給您回電。
除了 官方文件 之外,請務必查看 Sails 網站上推薦的支援選項,並加入我們的 Gitter 聊天室。如果您感到困惑,請務必 在 StackOverflow 上提問,那裡有一個 活躍的 Sails 社群。我們核心團隊的成員最近在 Platzi 上教了一個 免費視訊課程,並撰寫了 一本書。
如果您是關於 Sails 的教學課程或指南的作者,請在此處向我們發送 pull request 這裡,我們會查看。 (請務必將您的教學課程新增到適用的清單頂部,因為我們嘗試按從最新到最舊的順序排列這些。)
- 如果您是關於 Sails 的文章的作者,請在此處向我們發送 pull request 這裡。我們會查看!
- 如果您是一家有興趣發布關於 Sails 新聞稿的公司,請在 Twitter 上聯絡 @mikermcneil。我們會盡力協助。
Sails 專案在 GitHub issue 中追蹤錯誤報告,並使用 pull request 來提出功能建議。在您建立 issue、提交建議或開始處理 pull request 之前,請閱讀 貢獻指南。
除非您是執行框架預發行版本以進行一些測試或處理核心的貢獻者,否則您應該使用 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
分支。(只需確保也使用正確版本的您最喜歡的 adapters 和其他外掛程式。如有疑問,隨時詢問。)
最後,如果您喜歡走在前端,或者您正在努力在 Sails 中新增功能或修復錯誤,請從 github 上的 master
分支安裝 edge 版本。edge 版本未發布在登錄檔中,因為它不斷處於開發中,但您仍然可以使用 npm 安裝它(例如 npm install sails@git://github.com/balderdashy/sails.git
)
有關安裝 Sails 的 beta 和 edge 版本的更多說明,請查看 貢獻指南。
有很多不同的方式可以為 Sails 做出貢獻;例如,您可以協助我們改進 官方文件、撰寫 外掛程式、回答 StackOverflow 問題、發起 Sails 聚會、協助排除 GitHub issue、撰寫一些測試,或提交 Sails 核心或其依賴項目的修補程式。在您開始之前,請仔細閱讀 貢獻指南。這是一篇簡短的讀物,涵蓋了確保您的辛勤工作將產生最大影響的指南和最佳實務。
文件是從 github 上的 sails
儲存庫 中的 markdown 檔案編譯而來的。許多 Sails 使用者表示有興趣模仿我們用於在 Sails 網站上產生頁面的流程。好消息是它非常簡單:Sails 文件編譯流程包括從 sails 儲存庫中的 Markdown 檔案產生 HTML,然後執行一些額外的轉換,例如新增資料類型氣泡、標記頁面各個部分的永久連結、建置 JSON 資料以支援側邊導覽選單,以及設定 HTML <title>
屬性,以提高各個文件頁面的搜尋引擎可發現性。請參閱 doc-templater 模組以取得更多資訊。
主網站上的文件 適用於最新穩定 npm 版本的 Sails,並且與 github 上 sails
儲存庫的 master 分支 中的文件相互鏡像(Master 有時會領先幾個提交,但任何重要的文件更新都會在一兩天內出現在網站上。)
對於仍廣泛使用的舊版 Sails,文件是從相關的 sails-docs
分支編譯而來,並託管在以下子網域上