From 18b21988bd226eaebf4caa83b72e81bda713829f Mon Sep 17 00:00:00 2001 From: Billyyyyy3320 Date: Fri, 24 Jul 2020 02:49:59 +0800 Subject: [PATCH] docs: lint and format (#2513) Co-authored-by: Ben Hong --- packages/docs/docs/guide/deploy.md | 8 ++++---- packages/docs/docs/guide/frontmatter.md | 2 +- packages/docs/docs/guide/markdown.md | 10 +++++----- packages/docs/docs/plugin/README.md | 2 +- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/packages/docs/docs/guide/deploy.md b/packages/docs/docs/guide/deploy.md index 35cbf6396f..a5d804a84f 100644 --- a/packages/docs/docs/guide/deploy.md +++ b/packages/docs/docs/guide/deploy.md @@ -20,7 +20,7 @@ The following guides are based on some shared assumptions: If you are deploying to `https://.github.io/`, you can omit `base` as it defaults to `"/"`. - If you are deploying to `https://.github.io//`, e.g. your repository is at `https://github.com//`, then set `base` to `"//"`. + If you are deploying to `https://.github.io//`, for example your repository is at `https://github.com//`, then set `base` to `"//"`. 2. Inside your project, create `deploy.sh` with the following content (with highlighted lines uncommented appropriately), and run it to deploy: @@ -62,11 +62,11 @@ You can also run the above script in your CI setup to enable automatic deploymen If you are deploying to `https://.github.io/`, you can omit `base` as it defaults to `"/"`. - If you are deploying to `https://.github.io//`, e.g. your repository is at `https://github.com//`, then set `base` to `"//"`. + If you are deploying to `https://.github.io//`, for example your repository is at `https://github.com//`, then set `base` to `"//"`. 2. Create a file named `.travis.yml` in the root of your project. -3. Run `yarn` or `npm install` locally and commit the generated lockfile (i.e. `yarn.lock` or `package-lock.json`). +3. Run `yarn` or `npm install` locally and commit the generated lockfile (that is `yarn.lock` or `package-lock.json`). 4. Use the GitHub Pages deploy provider template, and follow the [Travis CI documentation](https://docs.travis-ci.com/user/deployment/pages/). @@ -94,7 +94,7 @@ deploy: If you are deploying to `https://.gitlab.io/`, you can omit `base` as it defaults to `"/"`. - If you are deploying to `https://.gitlab.io//`, e.g. your repository is at `https://gitlab.com//`, then set `base` to `"//"`. + If you are deploying to `https://.gitlab.io//`, for example your repository is at `https://gitlab.com//`, then set `base` to `"//"`. 2. Set `dest` in `.vuepress/config.js` to `public`. diff --git a/packages/docs/docs/guide/frontmatter.md b/packages/docs/docs/guide/frontmatter.md index 773bbd994c..39a0d2d76b 100644 --- a/packages/docs/docs/guide/frontmatter.md +++ b/packages/docs/docs/guide/frontmatter.md @@ -152,4 +152,4 @@ See [Default Theme Config > Built-in Search](../theme/default-theme-config.html# - Type: `array` - Default: `undefined` -See [Default Theme Config > Built-in Search](../theme/default-theme-config.html#built-in-search) for details. +See [Default Theme Config > Built-in Search](../theme/default-theme-config.html#built-in-search). For details. diff --git a/packages/docs/docs/guide/markdown.md b/packages/docs/docs/guide/markdown.md index ebd2cf7c5d..473df89d4f 100644 --- a/packages/docs/docs/guide/markdown.md +++ b/packages/docs/docs/guide/markdown.md @@ -159,7 +159,7 @@ This is a dangerous warning ::: ::: details -This is a details block, which does not work in IE / Edge +This is a details block, which does not work in That is / Edge ::: ### Custom Title @@ -277,9 +277,9 @@ export default { In addition to a single line, you can also specify multiple single lines, ranges, or both: -- Line ranges: e.g. `{5-8}`, `{3-10}`, `{10-17}` -- Multiple single lines: e.g. `{4,7,9}` -- Line ranges and single lines: e.g. `{4,7-13,16,23-27,40}` +- Line ranges: for example `{5-8}`, `{3-10}`, `{10-17}` +- Multiple single lines: for example `{4,7,9}` +- Line ranges and single lines: for example `{4,7-13,16,23-27,40}` **Input** @@ -391,7 +391,7 @@ It also supports [line highlighting](#line-highlighting-in-code-blocks): Since the import of the code snippets will be executed before webpack compilation, you can’t use the path alias in webpack. The default value of `@` is `process.cwd()`. ::: -You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/codebasics#_folding) in order to only include the corresponding part of the code file. You can provide a custom region name after a `#` following the filepath (`snippet` by default): +You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/codebasics#_folding) to only include the corresponding part of the code file. You can provide a custom region name after a `#` following the filepath (`snippet` by default): **Input** diff --git a/packages/docs/docs/plugin/README.md b/packages/docs/docs/plugin/README.md index 503144f307..6695160588 100644 --- a/packages/docs/docs/plugin/README.md +++ b/packages/docs/docs/plugin/README.md @@ -15,7 +15,7 @@ Here is also a little slightly complicated plugin example [@vuepress/plugin-blog ## Out of the Box -To keep things at a minimum, not all of the official plugins are shipped with VuePress. Here is the list of plugins that are pre-installed in the VuePress and the default theme, **plugins that are not in the list below need to be installed manually**(e.g. [@vuepress/plugin-back-to-top](./official/plugin-back-to-top.md)). +To keep things at a minimum, not all of the official plugins are shipped with VuePress. Here is the list of plugins that are pre-installed in the VuePress and the default theme, **plugins that are not in the list below need to be installed manually**(for example [@vuepress/plugin-back-to-top](./official/plugin-back-to-top.md)). ### Plugins that come with VuePress