教你如何讀webpack2中文文檔

原文地址

通過一個多月的奮戰，webpack2的中文文檔已經翻譯好大部份，而且完成了核心內容「概念」和「指南」部份的校對。

這份文檔比react, vue之類的文檔都要龐大並且複雜。本文帶你如何快速讀懂這份文檔。

首先是「概念」。這部份對於菜鳥或者老司機來講，都是值得一讀的，因爲webpack跟以前的grunt, gulp都有所不一樣，它是基於模塊的配置型構建工具，許多理念對於前端玩家來講都是全新的，例如，什麼是入口(entry)，它有幾種配置的方式，如何配置咱們須要輸出(output)的位置、文件名，加載器(loaders)，和插件(plugins)是如何幫助咱們編譯文件和處理各類自動化任務的，webpack要打包的模塊(module)究竟是什麼，它去哪裏解析(resolve)文件等等，這裏都會幫你一一解答。

在你瞭解了webpack的概念以後，接下來，能夠看看「指南」。這裏的內容都是實踐經驗之談，例如前四篇文章主要是介紹怎麼用webpack去初始化一個項目，並進行發佈；《從v1遷移到v2》幫助你順利從webpack1升級至webpack2。其它的文檔，主要是介紹webpack一些比較精彩的特性，例如拆包、熱替換等等，還有一些比較有趣的，像怎麼用typescript寫webpack配置，怎麼用虛擬機跑webpack等等。

若是你對前兩部份都瞭如指掌，那麼恭喜你，你已經具有能力進入webpack的深水區了--更爲細緻的"文檔"了。

點擊」文檔「，首先進入的是"配置"，這裏算是完整配置的介紹，要搭建一個更爲完善的腳手架或者構建工具，須要仔細閱讀這裏的配置文檔。

「API」主要介紹了像webpack命令行的使用、如何在Node.js中結合webpack來搭建構建工具。對比起webpack1，webpack2的命令行工具變得更爲強大，並且能夠對你的構建耗時進行分析。

API中另外的兩部份，「加載器API」和「插件API」，能夠結合「開發」部份來看，主要是幫助開發者更好地開發webpack的加載器和插件，藉助webpack的能力去解決自身項目中遇到的構建問題。對比webpack1，這是一份更好的加載器和插件開發文檔，由於它不只介紹了推薦的寫法，還把內部的事件、內部可調用的一些方法，都展示了出來，賦予了開發者更多的能力。

webpack2的文檔，耗費了許多人大量的心血，尤爲要感謝最開始啓動這個翻譯項目的dear-lizhihua 還有 dingyiming，webpack中文社區的幾位籌辦成員，還有許多貢獻本項目的熱心技術同仁。

若是想參與咱們的翻譯項目，請關注咱們的官方文檔翻譯計劃。

若是有webpack相關的技術文章，能夠在awesome-webpack-cn給咱們提pull request。

若是有興趣參與社區籌辦，請關注咱們的harpers項目。

咱們會持續關注webpack，關注前端工程化發展的方方面面。

By AlloyTeam LeeHey,

webpack-china首席打雜

於2017.2.25，一個寒冷的春夜