まずは NPM のトラブルシューティングガイドをご覧ください。それでも問題が解決せず、Google検索を試しても解決しない場合は、Sails の貢献ガイドをよく読んでから、Sails リポジトリに GitHub issue を作成してください。
私たちは長年の経験から、依存関係のバージョン管理を非常に重要視することを学びました。Sails の依存関係のバージョンは固定されており、関連するアップデートがセキュリティ問題を修正する場合、または Sails ユーザーに実質的な利点(互換性の向上、パフォーマンスの向上など)をもたらす場合にのみ、バージョンを上げます。さらに、Sails のコアメンテナーは、コアの依存関係で発生する主要なセキュリティ、パフォーマンス、または安定性のバグを修正することを約束しています。これらのモジュールが他の組織によって公式にメンテナンスされているかどうかに関係なくです。
Sails は node バージョン 0.10.x 以上でテストされていますが、Node の最新の LTS バージョンを使用することをお勧めします。フレームワークは、Express と Socket.io の堅牢な基盤の上に構築されています。標準では、grunt
、waterline
、fs-extra
など、他の優れたモジュールにも依存しています。上記のバッジをクリックすると、Sails コアの最新の安定版リリースの依存関係の完全なリストが表示されます。
Sails Flagship ユーザー: Sails および公式にメンテナンスされている他のモジュールのすべての依存関係を、毎週手動で確認しています。これには、コアフック、アダプター、ジェネレーター、クライアント SDK、Flagship パッケージが含まれます。アカウントに関連付けられている主要なメールアドレスに、依存関係に関するセキュリティ/互換性レポートを定期的に送信します。チームの他のメンバーにもこれらのレポートを受信させたい場合は、お知らせください。メールアドレスを設定します。(これらのメールアドレスには、パッチ、shrinkwrap の更新、および互換性に関する通知も送信されます。)
依存関係について質問や懸念がある場合は、コアチームメンバーにご相談ください。依存関係のバージョンを変更するプルリクエストを送信する前に、(1)その依存関係の変更ログを確認し、(2)互換性を検証し、(3)依存関係管理ツールである roadstead を更新するためのプルリクエストを提出してください。
Sails は、世界中の個人、企業、非営利団体、政府機関で、あらゆる種類のプロジェクト(新規および既存)の本番環境で使用されています。Sails をプロジェクトに使用している企業の例はこちらでご覧いただけます。(このリストは完全なものではありません。Sails をアプリ/製品/サービスで使用している場合は、ぜひお知らせください!
The Sails Company は、Sails でアプリケーションを構築するチーム向けに、カスタム開発、サービス、トレーニング、エンタープライズクラスの製品、サポートを提供しています。
私たちのスタジオは、スタートアップ、中小企業、フォーチュン500企業向けに開発サービスを提供しています。ご想像のとおり、Sails コアチームは Sails/Node.js のカスタム開発を数多く行ってきましたが、高度なインタラクションデザイン、大規模アプリケーション向けの実際的/スケーラブルな JavaScript 開発手法、さまざまなデバイスや画面解像度に対応したリッチなユーザーエクスペリエンスの構築など、フルスタックの経験も豊富です。
アプリと API をゼロから構築したり、レガシー Web プラットフォームを最新化したり、既存チームの開発作業を促進したりできます。次のプロジェクトで私たちと協力することに興味がある場合は、ご連絡ください。
Sails Flagship は、Sails 上に構築されたプラットフォームであり、エンタープライズユースケース向けの追加サービス、本番品質の装備、サポートを提供します。これには、新機能や拡張機能への早期アクセス、社内ツールのライセンス、コアメンテナーが作成した限定レポートとベストプラクティスガイドが含まれます。詳細については、お電話ください(またはオンラインでご購入ください)。
私たちは、この製品に新しい追加機能や、以前は実験的なモジュールだったものの公式リリースを追加することで、積極的に拡張しています。新しい Flagship パッケージについて具体的な提案/リクエストがある場合は、お知らせください。
The Sails Company は、Sails を使用して製品を構築している組織に lifeline も提供しています。重大な本番問題が発生した場合に保証されたサポートが必要な場合、または開発中にコードベースを監視する追加の担当者が必要な場合は、基本サブスクリプションをご覧ください。またはお問い合わせください。お電話いたします。
公式ドキュメントに加えて、Sails ウェブサイトのおすすめサポートオプションを確認し、Gitter チャットルームにアクセスしてください。行き詰まった場合は、StackOverflow で質問してください。活発な Sails コミュニティがあります。コアチームのメンバーは最近、Platzi で無料のビデオコースを教え、本を執筆しました。
Sails Flagship を使用している場合は、こちらからコアチームに連絡できます。
Sails に関するチュートリアルまたはガイドの著者の場合は、こちらにプルリクエストを送信してください。確認いたします。(チュートリアルは、最新のものから順に並べているため、該当するリストの一番上に追加してください。)
- Sails に関する記事の著者の場合は、こちらにプルリクエストを送信してください。確認いたします!
- Sails に関するプレスリリースに興味のある企業は、Twitter で@mikermcneil にご連絡ください。できる限りお手伝いいたします。
Sailsプロジェクトは、GitHubのIssueでバグレポートを追跡し、機能提案にはプルリクエストを使用しています。Issueを作成したり、提案を送信したり、プルリクエストの作業を開始する前に、貢献ガイドをお読みください。
テストやコアの作業を行うために、プレリリース版のフレームワークを実行しているコントリビューターでない限り、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`)。これは、正式リリース前に今後のリリースを試して、リリースが公式になる前にアップグレードを開始するのに最適な方法です。ベータnpmリリース候補は、Sailsリポジトリの`beta`ブランチに対応しています。(お気に入りのアダプターやその他のプラグインの適切なバージョンも使用してください。疑問がある場合は、お気軽にお問い合わせください。)
最後に、最新バージョンを使用したい場合、またはSailsの機能追加やバグ修正に取り組んでいる場合は、githubの`master`ブランチからエッジバージョンをインストールします。エッジバージョンは常に開発中であるため、レジストリには公開されていませんが、*それでもnpmを使用してインストールできます*(例:`npm install sails@git://github.com/balderdashy/sails.git`)
Sailsのベータ版とエッジ版のインストール方法の詳細については、貢献ガイドをご覧ください。
Sailsに貢献する方法はたくさんあります。たとえば、公式ドキュメントの改善、プラグインの作成、Stack Overflowの質問への回答、Sailsミートアップの開始、GitHubのIssueのトラブルシューティングの支援、テストの作成、Sailsコアまたはその依存関係へのパッチの送信などが挙げられます。始める前に、貢献ガイドをご覧ください。ガイドラインとベストプラクティスが簡潔にまとめられており、あなたの努力が最大限の効果を発揮するのに役立ちます。
ドキュメントは、githubの`sails`リポジトリにあるMarkdownファイルからコンパイルされます。多くのSailsユーザーが、Sails Webサイトのページを生成するために使用しているプロセスをエミュレートすることに関心を示しています。幸いなことに、それは非常に簡単です。Sailsドキュメントのコンパイルプロセスでは、sailsリポジトリのMarkdownファイルからHTMLを生成し、データ型バブルの追加、ページの個々のセクションへのパーマリンクのタグ付け、サイドナビゲーションメニューを強化するためのJSONデータの構築、個々のドキュメントページの検索エンジンでの発見性を向上させるためのHTML `<title>`属性の設定など、追加の変換を実行します。詳細については、doc-templaterモジュールを参照してください。
メインWebサイトのドキュメントは、Sailsの最新の安定版npmリリース用であり、githubの`sails`リポジトリのmasterブランチにあるドキュメントによってミラーリングされています(masterはコミットが数回先行している場合がありますが、重要なドキュメントの更新は1、2日以内にWebサイトに反映されます)。
現在も広く使用されているSailsの古いリリースについては、ドキュメントは関連する`sails-docs`ブランチからコンパイルされ、以下のサブドメインでホストされています。