GitHubで表示
ビルドツール
Bootstrap Tableに含まれるnpmスクリプトを使用して、ドキュメントのビルド、ソースコードのコンパイルなどを行う方法を学びます。
ツール設定
Bootstrap Tableは、ビルドシステムにNPMスクリプトを使用します。 package.jsonには、コードのリンティング、コードのコンパイルなどを含む、フレームワークを操作するための便利なメソッドが含まれています。
ビルドシステムを使用し、ドキュメントをローカルで実行するには、Bootstrap TableのソースファイルとNodeが必要です。以下の手順に従ってください。
- 依存関係の管理に使用するNode.jsをダウンロードしてインストールします。
- ルートディレクトリ
/bootstrap-table
に移動し、npm install
を実行して、package.jsonにリストされているローカルの依存関係をインストールします。 - Rubyをインストールし、
gem install bundler
でBundlerをインストールし、最後にbundle install
を実行します。Jekyllやプラグインなど、すべてのRubyの依存関係がインストールされます。- Windowsユーザー:問題なくJekyllを起動して実行するには、このガイドをお読みください。
完了すると、コマンドラインから提供されるさまざまなコマンドを実行できるようになります。
NPMスクリプトの使用
package.jsonには、次のコマンドとタスクが含まれています。
タスク | 説明 |
---|---|
npm run build |
npm run build は、コンパイルされたファイルを含む/dist ディレクトリを作成します。 |
npm run lint |
/src ディレクトリのCSSとJavaScriptの構文チェックを行います。 |
npm run docs |
ドキュメントのCSSとJavaScriptをビルドし、構文チェックを行います。npm run docs-serve を実行して、ドキュメントをローカルで実行できます。 |
すべてのnpmスクリプトを表示するには、npm run
を実行します。
ローカルドキュメント
ドキュメントをローカルで実行するには、Jekyllを使用する必要があります。Jekyllは、基本的なインクルード、Markdownベースのファイル、テンプレートなどを提供する、かなり柔軟な静的サイトジェネレーターです。起動方法は次のとおりです。
- 上記のツール設定を実行して、
bundle install
でJekyll(サイトビルダー)と他のRubyの依存関係をインストールします。 - ルートディレクトリ
/bootstrap-table
から、コマンドラインでnpm run docs-serve
を実行します。 - ブラウザで
http://localhost:9001
を開きます。
Jekyllの使用方法の詳細については、ドキュメントをお読みください。
トラブルシューティング
依存関係のインストールで問題が発生した場合は、以前のすべての依存関係バージョン(グローバルとローカル)をアンインストールします。その後、npm install
を再実行します。