Skip to content

教你如何读webpack2中文文档 #17

Open
@lcxfs1991

Description

@lcxfs1991

webpackdoc

经过一个多月的奋战,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,一个寒冷的春夜

Activity

MeCKodo

MeCKodo commented on Feb 26, 2017

@MeCKodo

十分感谢,辛勤的付出

CommanderXL

CommanderXL commented on Feb 26, 2017

@CommanderXL

感谢感谢

chenbin92

chenbin92 commented on Feb 26, 2017

@chenbin92

赞,webpack v2 的文档比 v1 好很多

adoyle-h

adoyle-h commented on Feb 26, 2017

@adoyle-h

赞!感谢辛勤付出

adntin

adntin commented on Feb 28, 2017

@adntin

感谢你们的付出!

GeoffZhu

GeoffZhu commented on Feb 28, 2017

@GeoffZhu

感谢

mujiatong

mujiatong commented on Feb 28, 2017

@mujiatong

Many Thanks.

benmo1602

benmo1602 commented on Mar 15, 2017

@benmo1602

作为小白 十分感谢你们,辛苦了

wugang168

wugang168 commented on Mar 17, 2017

@wugang168

给你们点赞

koucxz

koucxz commented on Mar 25, 2017

@koucxz

十分感谢

zymt

zymt commented on Mar 29, 2017

@zymt

正在看,相信会有收获!

zidian257

zidian257 commented on Apr 12, 2017

@zidian257

点赞!

kumayato

kumayato commented on Apr 26, 2017

@kumayato

谢谢!!!

91Cola

91Cola commented on May 3, 2017

@91Cola

非常感谢,腾讯的兄弟

12 remaining items

vajsp

vajsp commented on Jul 28, 2017

@vajsp

辛苦啦~!

guyunxiang

guyunxiang commented on Aug 1, 2017

@guyunxiang

指南部分,模块热替换。翻译的的有问题,译者自己删改示例代码成伪代码,不利于理解,导致示例无法运行,对应文案也自我想当然口语化表达,不适合用作指南。

EvanEest

EvanEest commented on Aug 25, 2017

@EvanEest

感谢,么么哒!

chen86860

chen86860 commented on Aug 25, 2017

@chen86860

辛苦,谢谢了 :D

hanzhangyu

hanzhangyu commented on Aug 25, 2017

@hanzhangyu

thanks

f1084

f1084 commented on Aug 28, 2017

@f1084

大佬们辛苦了 --simle

MoGoethe

MoGoethe commented on Aug 31, 2017

@MoGoethe

膜拜大佬

oroz-vip

oroz-vip commented on Sep 6, 2017

@oroz-vip

艾玛去慕课网看了个webpack的视频,结果代码到了我这里好多都失效了,配置文件都不对,去啃了好一会英文官网,英文不太好,难咽,终于找到了这里

Randysheng

Randysheng commented on Sep 8, 2017

@Randysheng

感谢

yondmn

yondmn commented on Sep 13, 2017

@yondmn

十分感谢,对我特别有帮助

wanglq80

wanglq80 commented on Oct 16, 2017

@wanglq80

谢谢!

robert7git

robert7git commented on Oct 23, 2017

@robert7git

谢谢

Randysheng

Randysheng commented on Oct 26, 2017

@Randysheng

thanks

qq406601626

qq406601626 commented on Mar 10, 2018

@qq406601626

3Q~

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @mujiatong@adntin@adoyle-h@lcxfs1991@chenbin92

        Issue actions

          教你如何读webpack2中文文档 · Issue #17 · lcxfs1991/blog