From de2c093d250f4ab70fd34ec3facaecbe629e871a Mon Sep 17 00:00:00 2001 From: awkj Date: Wed, 16 Sep 2020 14:20:01 +0800 Subject: [PATCH 01/16] change document version from char to npm svg file, keep be consistent with vue-next repo (#480) --- src/guide/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 727d9afa..013399aa 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -2,7 +2,7 @@ ## リリースノート -最新のベータバージョン: 3.0.0-rc.5 +最新のベータバージョン: ![beta](https://img.shields.io/npm/v/vue/next.svg) 各バージョンの詳細なリリースノートは、 [GitHub](https://github.com/vuejs/vue-next/releases) で入手できます。 From 96cf91fb958e92902d6cab0bf62b92d976fd2453 Mon Sep 17 00:00:00 2001 From: Evan You Date: Thu, 17 Sep 2020 21:47:35 -0400 Subject: [PATCH 02/16] docs: links to migration guide + update navbar ecosystem links --- src/guide/installation.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 013399aa..22929676 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -2,15 +2,13 @@ ## リリースノート -最新のベータバージョン: ![beta](https://img.shields.io/npm/v/vue/next.svg) +最新のバージョン: ![npm](https://img.shields.io/npm/v/vue/next.svg) -各バージョンの詳細なリリースノートは、 [GitHub](https://github.com/vuejs/vue-next/releases) で入手できます。 +各バージョンの詳細なリリースノートは、 [GitHub](https://github.com/vuejs/vue-next/blob/master/CHANGELOG.md) で入手できます。 ## Vue Devtools -> 現在、ベータ版です。 - -> Vue 3 向けの Vue Devtools の利用には、`vue@^3.0.0-rc.1` 以上が必要です。 +> Currently in Beta - Vuex and Router integration is still WIP Vue を使用する場合は、ブラウザに [Vue Devtools](https://github.com/vuejs/vue-devtools#vue-devtools) をインストールすることをお勧めします。これにより、Vue アプリケーションをよりユーザーフレンドリーなインターフェースで調査、デバッグすることが可能になります。 From b7b5d0d91932215af43ad1bfebf78c7588cbf9c9 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Sun, 20 Sep 2020 13:51:44 +0900 Subject: [PATCH 03/16] fix: change to modern bundler (#508) --- src/guide/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 22929676..67d29f19 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -30,7 +30,7 @@ Vue を使用する場合は、ブラウザに [Vue Devtools](https://github.com ## NPM -Vue による大規模アプリケーションを構築するときには、NPM を利用したインストールを推奨します。[Webpack](https://webpack.js.org/) または [Browserify](http://browserify.org/) のようなモジュールバンドラーとうまく組み合わせることができます。Vue は[単一ファイルコンポーネント](../guide/single-file-component.html)を作成するための、付随するツールも提供しています。 +Vue による大規模アプリケーションを構築するときには、NPM を利用したインストールを推奨します。[Webpack](https://webpack.js.org/) または [Rollup](https://rollupjs.org/) のようなモジュールバンドラーとうまく組み合わせることができます。Vue は[単一ファイルコンポーネント](../guide/single-file-component.html)を作成するための、付随するツールも提供しています。 ```bash # 最新安定版 From 36125f6eaf011ae5137d4b150aeff600183484c1 Mon Sep 17 00:00:00 2001 From: NataliaTepluhina Date: Mon, 21 Sep 2020 06:46:42 +0300 Subject: [PATCH 04/16] fix: fixed Vue CLI npm name --- src/guide/installation.md | 6 +++--- src/guide/typescript-support.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 67d29f19..946c9bf6 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -45,12 +45,12 @@ $ npm install vue@next CLI は Node.js と関連するビルドツールに関する予備知識を前提としています。もし、Vue またはフロントエンドビルドツールを初めて使用する場合は、CLI を使用する前に、ビルドツールなしでガイドを参照することを強くお勧めします。 ::: -`npm` 上で `@vue/cli@next` として、Vue 3 向けの Vue CLI v4.5 が利用可能です。以前のバージョンからアップグレードする場合は、以下のように `@vue/cli` をグローバルに再インストールしてください: +`npm` 上で `@vue/cli` として、Vue 3 向けの Vue CLI v4.5 が利用可能です。以前のバージョンからアップグレードする場合は、以下のように `@vue/cli` をグローバルに再インストールしてください: ```bash -yarn global add @vue/cli@next +yarn global add @vue/cli # または -npm install -g @vue/cli@next +npm install -g @vue/cli ``` その後、Vue プロジェクト内で以下を実行します diff --git a/src/guide/typescript-support.md b/src/guide/typescript-support.md index dc1afb46..029db15c 100644 --- a/src/guide/typescript-support.md +++ b/src/guide/typescript-support.md @@ -34,7 +34,7 @@ ```bash # 1. Vue CLI をまだインストールしていなければ、インストールします -npm install --global @vue/cli@next +npm install --global @vue/cli # 2. 新しいプロジェクトを作成し、"Manually select features" を選択してください vue create my-project-name From eb651dde6a05c78214c5985654b053f0ace2a77e Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Wed, 21 Apr 2021 21:18:11 +0900 Subject: [PATCH 05/16] fix: update broken links https://github.com/vuejs/docs-next/commit/96d64039aa13770ab44f5c5ed46b387439014024#diff-923f699fa88653104589aefed42ad89c3b1df393cdd375c0e0805f4e305ab93e --- src/guide/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 946c9bf6..fb17b2a9 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -42,7 +42,7 @@ $ npm install vue@next 大規模なシングルページアプリケーション開発の足場を素早く組むために、Vue は [公式 CLI](https://github.com/vuejs/vue-cli) を提供します。この CLI にはモダンなフロントエンドワークフローのための、すぐに使えるビルド設定を用意しています。ホットリロード、保存時のリント、本番リリースのビルドができるようになるまでには、ほんの数分しかかかりません。より詳細は [Vue CLI ドキュメント](https://cli.vuejs.org) を参照してください。 ::: tip -CLI は Node.js と関連するビルドツールに関する予備知識を前提としています。もし、Vue またはフロントエンドビルドツールを初めて使用する場合は、CLI を使用する前に、ビルドツールなしでガイドを参照することを強くお勧めします。 +CLI は Node.js と関連するビルドツールに関する予備知識を前提としています。もし、Vue またはフロントエンドビルドツールを初めて使用する場合は、CLI を使用する前に、ビルドツールなしで [ガイド](./introduction.html) を参照することを強くお勧めします。 ::: `npm` 上で `@vue/cli` として、Vue 3 向けの Vue CLI v4.5 が利用可能です。以前のバージョンからアップグレードする場合は、以下のように `@vue/cli` をグローバルに再インストールしてください: From eca95e6e5caed4f521bdb38e3cf8bb1d23059de5 Mon Sep 17 00:00:00 2001 From: Ben Hong Date: Fri, 9 Oct 2020 08:20:47 -0400 Subject: [PATCH 06/16] docs: add intro to installation --- src/guide/installation.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/guide/installation.md b/src/guide/installation.md index fb17b2a9..02636178 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -1,5 +1,13 @@ # インストール +Vue.js is built by design to be incrementally adoptable. This means that it can be integrated into a project multiple ways depending on the requirements. + +There are two primary ways of adding Vue.js to a project: + +1. Import it as a [CDN package](#cdn) on the page +2. Install it using [npm](#npm) +3. Use the official [CLI](#cli) to scaffold a project, which provides batteries-included build setups for a modern frontend workflow (e.g., hot-reload, lint-on-save, and much more) + ## リリースノート 最新のバージョン: ![npm](https://img.shields.io/npm/v/vue/next.svg) From 597e2b5d05118c1e7213ebc4e3e3d1cc2415f8f7 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Wed, 21 Apr 2021 21:22:52 +0900 Subject: [PATCH 07/16] fix: casing on npm https://github.com/vuejs/docs-next/commit/8c8d85aaab77ae174cdbbc14c0c3a57aadf51598#diff-923f699fa88653104589aefed42ad89c3b1df393cdd375c0e0805f4e305ab93e --- src/guide/installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 02636178..fb5ccbf7 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -36,9 +36,9 @@ Vue を使用する場合は、ブラウザに [Vue Devtools](https://github.com 本番環境では、新しいバージョンによる意図しない不具合を避けるため、特定のバージョン番号とビルド番号にリンクすることをお勧めします。 -## NPM +## npm -Vue による大規模アプリケーションを構築するときには、NPM を利用したインストールを推奨します。[Webpack](https://webpack.js.org/) または [Rollup](https://rollupjs.org/) のようなモジュールバンドラーとうまく組み合わせることができます。Vue は[単一ファイルコンポーネント](../guide/single-file-component.html)を作成するための、付随するツールも提供しています。 +Vue による大規模アプリケーションを構築するときには、npm を利用したインストールを推奨します。[Webpack](https://webpack.js.org/) または [Rollup](https://rollupjs.org/) のようなモジュールバンドラーとうまく組み合わせることができます。Vue は[単一ファイルコンポーネント](../guide/single-file-component.html)を作成するための、付随するツールも提供しています。 ```bash # 最新安定版 From 89056ce6115f9d4e7044986ec2b42879039ac47d Mon Sep 17 00:00:00 2001 From: Ben Hong Date: Fri, 9 Oct 2020 08:24:51 -0400 Subject: [PATCH 08/16] docs: update number of methods recommended --- src/guide/installation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index fb5ccbf7..3e73a0d3 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -2,7 +2,7 @@ Vue.js is built by design to be incrementally adoptable. This means that it can be integrated into a project multiple ways depending on the requirements. -There are two primary ways of adding Vue.js to a project: +There are three primary ways of adding Vue.js to a project: 1. Import it as a [CDN package](#cdn) on the page 2. Install it using [npm](#npm) @@ -73,7 +73,7 @@ vue upgrade --next 次のコマンドをターミナルで実行すると Vite ですぐに Vue プロジェクトをセットアップできます。 -NPM の場合: +npm の場合: ```bash $ npm init vite-app <プロジェクト名> @@ -93,7 +93,7 @@ $ yarn dev ## さまざまなビルドについて -[NPM パッケージの `dist/` ディレクトリ](https://cdn.jsdelivr.net/npm/vue@3.0.0-rc.1/dist/) には、Vue.js の多くのさまざまなビルドが見つかります。利用用途ごとに `dist` ファイルの使い分けの概要を説明します。 +[npm パッケージの `dist/` ディレクトリ](https://cdn.jsdelivr.net/npm/vue@3.0.0-rc.1/dist/) には、Vue.js の多くのさまざまなビルドが見つかります。利用用途ごとに `dist` ファイルの使い分けの概要を説明します。 ### CDN を利用、またはバンドラーを使用しない場合 From 510b7e539f76e1405ba633ddb6e13506835fa0df Mon Sep 17 00:00:00 2001 From: Isaac Levy Date: Wed, 11 Nov 2020 07:46:30 -0500 Subject: [PATCH 09/16] update jsdelivr link (#684) point to current vue release --- src/guide/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 3e73a0d3..e1557f1b 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -93,7 +93,7 @@ $ yarn dev ## さまざまなビルドについて -[npm パッケージの `dist/` ディレクトリ](https://cdn.jsdelivr.net/npm/vue@3.0.0-rc.1/dist/) には、Vue.js の多くのさまざまなビルドが見つかります。利用用途ごとに `dist` ファイルの使い分けの概要を説明します。 +[npm パッケージの `dist/` ディレクトリ](https://cdn.jsdelivr.net/npm/vue@3.0.2/dist/) には、Vue.js の多くのさまざまなビルドが見つかります。利用用途ごとに `dist` ファイルの使い分けの概要を説明します。 ### CDN を利用、またはバンドラーを使用しない場合 From d18f9c6d9c61229c9b0b474fcc2dfbe7e7c169ed Mon Sep 17 00:00:00 2001 From: Han Han Date: Tue, 19 Jan 2021 01:19:07 +0800 Subject: [PATCH 10/16] Use `@vitejs/app` instead of `vite-app` (#818) When I use `vite-app`, `Tailwind CSS` can't work. And I see on the website of `vite`, now they use `@vitejs/app`. --- src/guide/installation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index e1557f1b..632b8cbe 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -76,7 +76,7 @@ vue upgrade --next npm の場合: ```bash -$ npm init vite-app <プロジェクト名> +$ npm init @vitejs/app <プロジェクト名> $ cd <プロジェクト名> $ npm install $ npm run dev @@ -85,8 +85,8 @@ $ npm run dev または Yarn の場合: ```bash -$ yarn create vite-app -$ cd +$ yarn create @vitejs/app <プロジェクト名> +$ cd <プロジェクト名> $ yarn $ yarn dev ``` From 14e16ffa3df953f5e3187b9a8aca7f2df251ae01 Mon Sep 17 00:00:00 2001 From: moosemanf <35728959+moosemanf@users.noreply.github.com> Date: Wed, 24 Feb 2021 09:17:14 +0100 Subject: [PATCH 11/16] Update installation.md (#841) --- src/guide/installation.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/guide/installation.md b/src/guide/installation.md index 632b8cbe..c51db6c0 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -90,6 +90,11 @@ $ cd <プロジェクト名> $ yarn $ yarn dev ``` +It might occur, that when your username has a space in it like 'Mike Baker' that vite cannot succeed. Have a try with + +```bash +$ create-vite-app +``` ## さまざまなビルドについて From c131d9ac6decbbf5475ac9e665919a898dfab584 Mon Sep 17 00:00:00 2001 From: kangetsu121 <34597587+kangetsu121@users.noreply.github.com> Date: Tue, 2 Mar 2021 15:28:21 +0900 Subject: [PATCH 12/16] chore(installation): unify and fix some markdown styles (#918) * chore(installation): unify to use backquates in 'Explanation of Different Builds' * chore(installation): remove some markdown linter warnings --- src/guide/installation.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index c51db6c0..0280c522 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -90,7 +90,8 @@ $ cd <プロジェクト名> $ yarn $ yarn dev ``` -It might occur, that when your username has a space in it like 'Mike Baker' that vite cannot succeed. Have a try with + +It might occur, that when your username has a space in it like 'Mike Baker' that vite cannot succeed. Have a try with ```bash $ create-vite-app From f1afb2fcbb8edaa631426bc19795016e38718f20 Mon Sep 17 00:00:00 2001 From: skirtle <65301168+skirtles-code@users.noreply.github.com> Date: Sun, 7 Mar 2021 23:03:47 +0000 Subject: [PATCH 13/16] docs: add self hosting Vue as an option in the installation guide (#923) --- src/guide/installation.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/src/guide/installation.md b/src/guide/installation.md index 0280c522..308bd853 100644 --- a/src/guide/installation.md +++ b/src/guide/installation.md @@ -2,11 +2,12 @@ Vue.js is built by design to be incrementally adoptable. This means that it can be integrated into a project multiple ways depending on the requirements. -There are three primary ways of adding Vue.js to a project: +There are four primary ways of adding Vue.js to a project: 1. Import it as a [CDN package](#cdn) on the page -2. Install it using [npm](#npm) -3. Use the official [CLI](#cli) to scaffold a project, which provides batteries-included build setups for a modern frontend workflow (e.g., hot-reload, lint-on-save, and much more) +2. Download the JavaScript files and [host them yourself](#download-and-self-host) +3. Install it using [npm](#npm) +4. Use the official [CLI](#cli) to scaffold a project, which provides batteries-included build setups for a modern frontend workflow (e.g., hot-reload, lint-on-save, and much more) ## リリースノート @@ -36,6 +37,12 @@ Vue を使用する場合は、ブラウザに [Vue Devtools](https://github.com 本番環境では、新しいバージョンによる意図しない不具合を避けるため、特定のバージョン番号とビルド番号にリンクすることをお勧めします。 +## Download and Self Host + +If you want to avoid using build tools but can't use a CDN in production then you can download the relevant `.js` file and host it using your own web server. You can then include it using a `