GitHubで表示

ビルドツール

Bootstrap Tableに含まれるnpmスクリプトを使用して、ドキュメントのビルド、ソースコードのコンパイルなどを行う方法を学びます。

ツール設定

Bootstrap Tableは、ビルドシステムにNPMスクリプトを使用します。 package.jsonには、コードのリンティング、コードのコンパイルなどを含む、フレームワークを操作するための便利なメソッドが含まれています。

ビルドシステムを使用し、ドキュメントをローカルで実行するには、Bootstrap TableのソースファイルとNodeが必要です。以下の手順に従ってください。

  1. 依存関係の管理に使用するNode.jsをダウンロードしてインストールします。
  2. ルートディレクトリ/bootstrap-tableに移動し、npm installを実行して、package.jsonにリストされているローカルの依存関係をインストールします。
  3. Rubyをインストールし、gem install bundlerBundlerをインストールし、最後に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ベースのファイル、テンプレートなどを提供する、かなり柔軟な静的サイトジェネレーターです。起動方法は次のとおりです。

  1. 上記のツール設定を実行して、bundle installでJekyll(サイトビルダー)と他のRubyの依存関係をインストールします。
  2. ルートディレクトリ/bootstrap-tableから、コマンドラインでnpm run docs-serveを実行します。
  3. ブラウザでhttp://localhost:9001を開きます。

Jekyllの使用方法の詳細については、ドキュメントをお読みください。

トラブルシューティング

依存関係のインストールで問題が発生した場合は、以前のすべての依存関係バージョン(グローバルとローカル)をアンインストールします。その後、npm installを再実行します。