建構 DataTables

DataTables 本質上是一個大型 Javascript 檔案，但其原始碼被分割成可管理的多個個別檔案，這些檔案會組合在一起以建立主要的程式庫檔案。這就是 DataTables 的建構過程，如果您想從原始碼修改 DataTables，則需要經歷此過程。

環境與軟體

DataTables 的建構過程在 Mac、Linux 和 Windows (WSL) 上皆可支援。以下軟體是建構 DataTables 所需的必要條件

Bash
Node.js
PHP 7+

取得原始碼

DataTables 原始碼在 GitHub 上提供，這表示取得程式碼非常簡單

git clone https://github.com/DataTables/DataTablesSrc.git

然後您需要安裝建構相依性

cd DataTablesSrc
npm install

建構

要建構程式碼，請執行

npm run build

debug 部分是選用的（這就是它顯示在方括號中的原因）。啟用除錯後，將會跳過使用 Closure 編譯器的最小化過程，進而加快建構時間，但不會產生最小化的檔案，這表示它僅適用於除錯。

建構過程的輸出結果看起來會像這樣

  DataTables build (2.1.4) - branch: master 

  Deploying to build repo 
  JS js 
      Minification - js 
        File size: 93174 
  JS mjs 
      Minification - mjs 
        File size: 104504 
  Styling frameworks JS 
    JS processing dataTables.bootstrap5 
      Creating ES module 
      Minification - mjs 
        File size: 1102 
      Creating UMD 
      Minification - js 
        File size: 1470 
      Linting UMD 
  ...
  Types 
  Examples 
  Lint 
    Pass 
    Updating package descriptors 

  Done

輸出

輸出檔案（Javascript、CSS、圖片和範例）會放置到 built/DataTables 目錄中。要在瀏覽器中載入它們，請執行

npm run serve

擴充功能

DataTables 擴充功能也使用此指令碼執行相同的建構過程，但在此案例中

./make.sh extension {name} [debug]

其中，debug 同樣為選用，且在此案例中 {name} 是擴充功能的名稱。此指令碼會自動從 DataTables 儲存庫複製擴充功能，然後建構擴充功能及其範例。

輸出

建構好的擴充功能會放置到 built/DataTables/extensions 中，範例可以直接從 localhost 執行。