docs: update website packages

Author: xbrave

.gitignore

@@ -1,7 +1,6 @@
 *.DS_Store
 *.idea
 node_modules*
-static*
 npm-debug.log
 dist/*
 idea/

website/blog/2019-05-28-first-blog-post.md

@@ -0,0 +1,65 @@
+---
+sidebar_position: 4
+title: FAQ
+---
+
+## How to override webpack configs
+You can override webpack configs via **ko.config.js**, and we recommend you override [copy-webpack-plugin](https://github.com/webpack-contrib/copy-webpack-plugin),[html-webpack-plugin](https://github.com/jantimon/html-webpack-plugin) if needed. You can override like this:
+
+``` js
+const CopyWebpackPlugin = require('copy-webpack-plugin');
+
+const copyConfig = [
+  { from: path.resolve(__dirname, 'public/config'), to: 'config' },
+  { from: path.resolve(__dirname, 'public/assets'), to: 'assets' },
+]
+
+module.exports = {
+  ... //other webpack configs
+  plugins: [
+    new CopyWebpackPlugin(copyConfig),
+  ],
+};
+
+```
+
+## How to polyfill Node.js core modules:
+
+Webpack 5 no longer polyfills Node.js core modules automatically which means if you use them in your code running in browsers or alike, you will have to install compatible modules from npm and include them yourself. And if your target environment is browser, just install some packages and add **resolve.fallback** into **ko.config.js**.
+
+### Install browserify packages:
+```bash
+pnpm add os-browserify crypto-browserify stream-browserify
+```
+
+### Add configs into **ko.config.js**:
+
+```js
+module.exports = {
+  ... //other webpack configs
+   resolve: {
+    fallback: {
+      fs: false,
+      path: false,
+      events: false,
+      os: require.resolve('os-browserify/browser'),
+      crypto: require.resolve('crypto-browserify'),
+      stream: require.resolve('stream-browserify'),
+    },
+  }
+};
+```
+
+## How to use web workers
+
+You can use [Web Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers) without [worker-loader](https://github.com/webpack-contrib/worker-loader) in ko, just like this:
+```js
+new Worker(new URL('./worker.js', import.meta.url));
+```
+And you should update your project **tsconfig.json** into these configs:
+```json
+"compilerOptions": {         
+  "module": "esnext",         
+  "moduleResolution": "Node"   
+} 
+```

website/blog/2019-05-29-long-blog-post.md

@@ -0,0 +1,4 @@
+{
+  "label": "Advanced",
+  "position": 5
+}

website/blog/2021-08-01-mdx-blog-post.mdx

@@ -0,0 +1,4 @@
+{
+  "label": "Command Line Interface",
+  "position": 3
+}

website/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg

@@ -0,0 +1,12 @@
+---
+sidebar_position: 1
+title: ko build
+---
+
+Use internal webpack instance to bundle files, compiled files will be write to **dist** directory by default. You can change this behavior via **ko.config.js**.
+
+Optional arguments:
+
+* `--hash`: output filename with it's hash
+* `-t,--ts,--typescript`: support typescript or not, ko support typescript by default
+* `-e,--esbuild`: enable esbuild (now only esbuild minification is supported)

website/blog/2021-08-26-welcome/index.md

@@ -0,0 +1,12 @@
+---
+sidebar_position: 2
+title: ko dev
+---
+
+start a development server that provides live reloading. You can change development server default behaviors via **devServer** values in **ko.config.js**, or use cli arguments.
+
+Optional arguments:
+* `-p, --port <port>`: server start on which port, a number value is accepted
+* `--host <host>`: server start on which host, you can specify an ip like **0.0.0.0**
+* `-t, --ts`: support typescript or not, ko support typescript by default
+* `-a,--analyzer`: show output files with an interactive zoomable treemap in **http://127.0.0.1:8888**

website/blog/authors.yml

@@ -0,0 +1,26 @@
+---
+sidebar_position: 3
+title: ko eslint
+---
+
+Alias `ko el`
+
+**Please note that `ko eslint` is experimental**
+
+use **eslint** to format your codes, we collate an [eslint configuration](https://github.com/DTStack/ko/blob/master/packages/ko-config/eslint.js) and use it as default eslint configuration, you can override it via cli arguments. 
+
+## How to Use
+You can use `pnpm` or `npx` to run `ko eslint` on the command like this:
+
+``` bash
+# Run on files:
+npx eslint file1.js
+# Run on multiple files via glob syntax
+npx ko eslint "src/**"
+```
+
+## Optional arguments:
+
+* `-f, --fix`:  Fix problems automatically
+* `-c, --config <path>`: overriding default eslint config path, and use this configuration
+* `--ignore-path <ignorePath>`: Specify path of ignore file

website/docs/FAQ.md

@@ -0,0 +1,26 @@
+---
+sidebar_position: 4
+title: ko prettier
+---
+
+Alias `ko pr`
+
+**Please note that `ko prettier` is experimental**
+
+use **prettier** to format your codes, we collate an [prettier configuration](https://github.com/DTStack/ko/blob/master/packages/ko-config/prettier.js) and use it as default prettier configuration, you can override it via cli arguments. 
+
+## How to Use
+You can use `pnpm` or `npx` to run `ko prettier` on the command like this:
+
+``` bash
+# Run on files:
+npx prettier file1.js
+# Run on multiple files via glob syntax
+npx ko prettier "src/**"
+```
+
+## Optional arguments:
+
+* `-w, --write`: Edit files in-place.
+* `-c, --config <path>`: overriding default prettier config path, and use this configuration
+* `--ignore-path <ignorePath>`: Specify path of ignore file

website/docs/advanced/_category_.json

@@ -0,0 +1,26 @@
+---
+sidebar_position: 5
+title: ko stylelint
+---
+
+Alias `ko sl`
+
+**Please note that `ko stylelint` is experimental**
+
+use **stylelint** to format your codes, we collate an [stylelint configuration](https://github.com/DTStack/ko/blob/master/packages/ko-config/stylelint.js) and use it as default stylelint configuration, you can override it via cli arguments. 
+
+## How to Use
+You can use `pnpm` or `npx` to run `ko stylelint` on the command like this:
+
+``` bash
+# Run on files:
+npx stylelint file1.js
+# Run on multiple files via glob syntax
+npx ko stylelint "src/**"
+```
+
+## Optional arguments:
+
+* `-f, --fix`:  Fix problems automatically
+* `-c, --config <path>`: overriding default eslint config path, and use this configuration
+* `--ignore-path <ignorePath>`: Specify path of ignore file

website/docs/advanced/architect.md

@@ -0,0 +1,33 @@
+---
+sidebar_position: 6
+title: Contributing
+---
+
+# Contributing to ko
+
+We use **pnpm workspace** to manage our packages. so make sure you use **pnpm** as package manager than **npm** or **yarn**.
+
+To getting started with this repo:
+
+``` bash
+pnpm install
+```
+
+## Code Structure
+
+as a **monorepo**, ko now maintain 4 packages in packages directory:
+
+* **ko**: main package
+* **ko-lints**: code format cli, include **eslint**, **prettier** and **stylelint**, can be integrated in ko or use individually
+* **ko-config**: default config used by **ko-lints**
+* **babel-preset-ko-app**: babel preset used by ko
+
+## Commands
+
+### Debug
+
+use `pnpm debug` to debug local packages
+
+### Local Testing
+
+use **pnpm link** to link `ko` into local packages for testing