docs(config) update how to write the webpack configuration with typescript

[youta1119]

issue #1735
Update how to write the webpack configuration with typescript. Current configuration is wrong.
ts-node dosenot support the module syntax of other than commonjs module.
So, if module in compilerOptions in tsconfig.json is not commonjs, webpack getting error. like this.

(function (exports, require, module, __filename, __dirname) { import * as path from "path";
                                                              ^^^^^^

SyntaxError: Unexpected token import
    at createScript (vm.js:80:10)
    at Object.runInThisContext (vm.js:139:10)
    at Module._compile (module.js:588:28)
    at Module.m._compile (/Users/hogefuga/webpack-config-with-typescript/node_modules/ts-node/src/index.ts:392:23)

I have a two solution.

1. modify tsconfig.json
2. install tsconfig-paths

First solution:

edit module in compilerOptions in tsconfig.json. please setting commonjs.

Secoud solution:

first install tsconfig-paths

npm install --save-dev tsconfig-paths

ts-node can resolve tsconfig.json using the environment variable provided by tsconfig-path.

and setting environment variable process.env.TS_NODE_PROJECT provided by tsconfig-path like this.

//tsconfig-for-webpack-config.json
{
  "compilerOptions": {
    "module": "commonjs"
  }
}

//package.json
{
  "scripts": {
      "build": "TS_NODE_PROJECT=\"tsconfig-for-webpack-config.json\" webpack"
  }
}

I make sample project. please see this repository

[jsf-clabot]

All committers have signed the CLA.

[ChrisChinchilla]

@youta1119 Capital 'N' at the start of this line. And you are missing some other capitalisations throughout the PR.

[ChrisChinchilla]

@youta1119 This is missing quite a few articles, for example…

If the module in compilerOptions in tsconfig.json is commonjs, the setting is complete, else webpack will get an error.

Have a look through the rest of your PR and happy to help if you get stuck.

[ChrisChinchilla]

@youta1119 'Second'.

[ChrisChinchilla]

Hey @youta1119 thanks for your PR. I have a few small language suggestions that are throughout the changes so have a look through, make those changes and I'll take another look. Happy to help with any questions.

[youta1119]

@ChrisChinchilla Fix typo and few small language suggestions. Please review. 🙏

[dmitriid]

@youta1119

I've sprinkled minor suggestions to change some words and sentence structure.

Otherwise looks good!

[dmitriid]

- else webpack getting error.
+ else webpack will fail with an error

[dmitriid]

- Edit module in compilerOptions in tsconfig.json. Please setting commonjs.
+ In `tsconfig.json` look for `compilerOptions`. Set `target` to `"ES5"` and `module` to `"CommonJS"` (or completely remove the `module` option).

[dmitriid]

- and setting environment variable
+ Then set the environment variable

[youta1119]

@dmitriid
Thank you for the review. I've fix it.

[skipjack]

@youta1119 thanks again for submitting this. I tweaked the formatting a bit to match better with the rest of our site. I also moved things around slightly under the second option so it was clear that you first have to create a separate config and then set the environment variable. If these edits look ok to you, I'll go ahead and merge.

[youta1119]

@skipjack
Thanks. I think that good.
And I've fix markdown lint error. Please see it. 🙏