mirror of
https://gitee.com/WeBank/fes.js.git
synced 2024-11-29 18:28:09 +08:00
docs: fix docs build problem
This commit is contained in:
winixt
parent
2be3cffcb6
commit
f4e4bde755
@ -22,7 +22,7 @@ export const zh = [
|
||||
},
|
||||
{
|
||||
text: 'CLI',
|
||||
link: '/reference/cli/',
|
||||
link: '/reference/cli/index.md',
|
||||
},
|
||||
{
|
||||
text: `v${version}`,
|
||||
|
||||
@ -11,7 +11,7 @@
|
||||
|
||||
### 配置
|
||||
|
||||
Webpack 和 Vite 构建在配置方面有一些差异，具体可以查看[配置](../reference/config)。
|
||||
Webpack 和 Vite 构建在配置方面有一些差异，具体可以查看[配置](../reference/config/index.md)。
|
||||
|
||||
### 静态文件处理
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Fes.js 约定 `.fes.js` 文件为项目编译需要编译时配置文件，可以引入 `node` 端依赖项，不要引入浏览器端依赖项。
|
||||
|
||||
一份常见的配置示例如下（更多配置项请查阅[配置](../reference/config))：
|
||||
一份常见的配置示例如下（更多配置项请查阅[配置](../reference/config/index.md))：
|
||||
|
||||
```js
|
||||
import { defineBuildConfig } from '@fesjs/fes';
|
||||
|
||||
@ -126,7 +126,7 @@ Starting the development server http://localhost:8000 ...
|
||||
|
||||
:::
|
||||
|
||||
Fes.js 会在 [http://localhost:8000](http://localhost:8000) 启动一个热重载的开发服务器。当你修改你的 .vue 文件时，浏览器中的内容也会自动更新。
|
||||
Fes.js 会在 `http://localhost:8000` 启动一个热重载的开发服务器。当你修改你的 .vue 文件时，浏览器中的内容也会自动更新。
|
||||
|
||||
<img :src="withBase('home.png')" alt="home">
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
## 版本 3.0.x 的 break
|
||||
|
||||
1. 编译时的 [base](../reference/config/#base) 配置，移到了 [router.base](../reference/config/#router) 下。
|
||||
1. 编译时的 [base](../reference/config/index.md/#base) 配置，移到了 [router.base](../reference/config/index.md/#router) 下。
|
||||
2. [webpack-dev-server](https://github.com/webpack/webpack-dev-server) 从 `v3.x` 升级到了 `v4.x`，如果遇到配置不兼容，可以查看[webpack-dev-server 3.x 升级 4.x](https://github.com/webpack/webpack-dev-server/blob/master/migration-v4.md)。
|
||||
|
||||
## 继续使用 Webpack
|
||||
@ -13,7 +13,7 @@
|
||||
## 换成 Vite
|
||||
|
||||
1. 安装依赖包 `npm i @fesjs/builder-vite`。
|
||||
2. 将 Webpack 相关的配置换成 Vite，具体可查看[配置](../reference/config)。
|
||||
2. 将 Webpack 相关的配置换成 Vite，具体可查看[配置](../reference/config/index.md)。
|
||||
3. 将 html 模版文件从 `public/index.html` 挪到项目根目录，如果有相应的 [html-webpack-plugin](https://github.com/jantimon/html-webpack-plugin) 配置，需要改成 [vite-plugin-html](https://github.com/vbenjs/vite-plugin-html) 的写法。
|
||||
4. 将 `require` 等 Vite 不支持的代码，改写成 Vite 支持的方式。
|
||||
|
||||
@ -21,6 +21,6 @@
|
||||
|
||||
插件都需要升级到 `3.0.x` 版本，新版添加了兼容`builder`的逻辑，但是提供的接口和配置没有变化，只需要升级版本即可使用。
|
||||
|
||||
- [@fesjs/plugin-layout](../reference/plugins/layout) 需要升级到`5.0.x`版本。
|
||||
- [@fesjs/plugin-locale](../reference/plugins/locale) 需要升级到`4.0.x`版本。
|
||||
- [@fesjs/plugin-qiankun](../reference/plugins/qiankun) 由于`qiankun`技术限制，子应用目前还只能使用 Webpack 构建。
|
||||
- [@fesjs/plugin-layout](../reference/plugin/plugins/layout.md) 需要升级到`5.0.x`版本。
|
||||
- [@fesjs/plugin-locale](../reference/plugin/plugins/locale.md) 需要升级到`4.0.x`版本。
|
||||
- [@fesjs/plugin-qiankun](../reference/plugin/plugins/qiankun.md) 由于`qiankun`技术限制，子应用目前还只能使用 Webpack 构建。
|
||||
|
||||
@ -1,81 +0,0 @@
|
||||
# 命令行接口
|
||||
|
||||
VuePress 命令行接口是由 [@vuepress/cli](https://www.npmjs.com/package/@vuepress/cli) 包提供的。它是 [vuepress](https://www.npmjs.com/package/vuepress) 包的依赖之一，当然你也可以单独安装它。
|
||||
|
||||
执行 `vuepress --help` 来获取下列帮助信息：
|
||||
|
||||
```bash
|
||||
Usage:
|
||||
$ vuepress <command> [options]
|
||||
|
||||
Commands:
|
||||
dev [sourceDir] Start development server
|
||||
build [sourceDir] Build to static site
|
||||
info Display environment information
|
||||
|
||||
For more info, run any command with the `--help` flag:
|
||||
$ vuepress dev --help
|
||||
$ vuepress build --help
|
||||
$ vuepress info --help
|
||||
|
||||
Options:
|
||||
-v, --version Display version number
|
||||
-h, --help Display this message
|
||||
```
|
||||
|
||||
## dev
|
||||
|
||||
启动一个开发服务器，在本地开发你的 VuePress 站点。
|
||||
|
||||
```bash
|
||||
Usage:
|
||||
$ vuepress dev [sourceDir]
|
||||
|
||||
Options:
|
||||
-c, --config <config> Set path to config file
|
||||
-p, --port <port> Use specified port (default: 8000)
|
||||
-t, --temp <temp> Set the directory of the temporary files
|
||||
--host <host> Use specified host (default: 0.0.0.0)
|
||||
--cache <cache> Set the directory of the cache files
|
||||
--clean-temp Clean the temporary files before dev
|
||||
--clean-cache Clean the cache files before dev
|
||||
--open Open browser when ready
|
||||
--debug Enable debug mode
|
||||
--no-watch Disable watching page and config files (default: true)
|
||||
-v, --version Display version number
|
||||
-h, --help Display this message
|
||||
```
|
||||
|
||||
::: tip
|
||||
通过命令行设置的配置项，会覆盖你配置文件中的同名配置项。
|
||||
:::
|
||||
|
||||
## build
|
||||
|
||||
将你的 VuePress 站点构建成静态文件，以便你进行后续[部署](../guide/deployment.md)。
|
||||
|
||||
```bash
|
||||
Usage:
|
||||
$ vuepress build [sourceDir]
|
||||
|
||||
Options:
|
||||
-c, --config <config> Set path to config file
|
||||
-d, --dest <dest> Set the directory build output (default: .vuepress/dist)
|
||||
-t, --temp <temp> Set the directory of the temporary files
|
||||
--cache <cache> Set the directory of the cache files
|
||||
--clean-temp Clean the temporary files before build
|
||||
--clean-cache Clean the cache files before build
|
||||
--debug Enable debug mode
|
||||
-v, --version Display version number
|
||||
-h, --help Display this message
|
||||
```
|
||||
|
||||
::: tip
|
||||
通过命令行设置的配置项，会覆盖你配置文件中的同名配置项。
|
||||
:::
|
||||
|
||||
## info
|
||||
|
||||
输出当前系统和依赖相关的信息。
|
||||
|
||||
在你想要检查你的环境，或者提交 Issue 时候，可以使用该命令。
|
||||
@ -254,7 +254,7 @@ access.getAccess();
|
||||
|
||||
### useAccess
|
||||
|
||||
- **类型**：[composition](<(https://v3.cn.vuejs.org/guide/composition-api-introduction.html)>) 函数
|
||||
- **类型**：[composition](https://vuejs.org/guide/extras/composition-api-faq.html#what-is-composition-api) 函数
|
||||
- **详情**：判断某个资源是否可见。
|
||||
- **参数**：
|
||||
- accessId，资源 Id
|
||||
|
||||
Loading…
Reference in New Issue
Block a user