From 6534689ec8ec5991fe91503fc077e6c7f27d7b3b Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Mon, 16 Oct 2017 07:30:48 +0900 Subject: [PATCH 01/27] translated Polymer-Project.org "Tools overview" --- polymer-project.org/Polymer/polymer-cli.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 polymer-project.org/Polymer/polymer-cli.md diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md new file mode 100644 index 0000000..828a307 --- /dev/null +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -0,0 +1,20 @@ +## Polymer CLI + +> Polymer CLI is the official command line tool for Polymer projects and Web Components. + +Polymer CLIはPolymerプロジェクトとWebコンポーネント用の公式のコマンドラインツールです。 + +> It includes a build pipeline, a boilerplate generator for creating elements and apps, a linter, a development server, and a test runner. + +ビルドパイプライン、カスタムエレメントとアプリケーションを作成するためのボイラープレート、リンター、開発サーバー、テストランナーが含まれています。 + + +> Follow these instructions to install the Polymer CLI on a Linux or MacOS operating system. + +Linuxまたは、MacOSオペレーティングシステムにPolymer CLIをインストールするには、以下の手順に従ってください。 + + +> For a suggested way to run the Polymer CLI on Windows 10, see the instructions below on Installing Polymer CLI pre-requisites on Windows 10. + +Windows 10でPolymer CLIを実行するための推奨方法については、下記の[Windows 10でのPolymer CLIのインストール](https://www.polymer-project.org/2.0/docs/tools/polymer-cli#windows-10)に関する説明を参照してください。 + From cf6acdd57efa28ed93dee9388009a28b8e66cef6 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Tue, 17 Oct 2017 07:31:12 +0900 Subject: [PATCH 02/27] translated Polymer-Project.org "Tools overview" --- polymer-project.org/Polymer/polymer-cli.md | 62 ++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md index 828a307..a791b2a 100644 --- a/polymer-project.org/Polymer/polymer-cli.md +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -18,3 +18,65 @@ Linuxまたは、MacOSオペレーティングシステムにPolymer CLIをイ Windows 10でPolymer CLIを実行するための推奨方法については、下記の[Windows 10でのPolymer CLIのインストール](https://www.polymer-project.org/2.0/docs/tools/polymer-cli#windows-10)に関する説明を参照してください。 + + +## Install Polymer CLI + +> Make sure you have installed a version of Node.js supported by Polymer. To check the version of Node.js that you have installed, run: + +- PolymerがサポートしているNode.jsのバージョンをインストールしていることを確認してください。インストールしたNode.jsのバージョンを確認するには、次のコマンドを実行します。 + +``` + node --version +``` + +> See the official node version support policy for more details. + +詳細は[公式Nodeバージョンサポートポリシー](https://www.polymer-project.org/2.0/docs/tools/node-support)を参照してください。 + +> Update npm. + +- npmをアップデートします + +``` + npm install npm@latest -g +``` + +> Ensure that Git is installed. + +- Gitがインストールされていることを確認してください。 + +``` +git --version +``` + +> If it isn't, you can find it on the Git downloads page. + +または、[Git downloads ページ](https://git-scm.com/downloads)で見つけることができます。 + + +> Install the latest version of Bower. + +- Bowerの最新バージョンをインストールします。 + +``` +npm install -g bower +``` + +> Install Polymer CLI. + +- Polymer CLIをインストールします + +``` +npm install -g polymer-cli +``` + +> Bower deprecation warning.In the output from this command, you may see an npm warning about Bower being deprecated. You can safely ignore this warning. See Bower.io for more information. + + **Bower deprecation warning** + このコマンド出力はBowerの廃止予定に関するnpmの警告なのですが、この警告は無視しても問題ありません。詳細については、[Bower.io](https://bower.io/blog/)を参照してください。 + + +> You're all set. Run polymer help to view a list of commands. + +インストールは以上です。`polymer help`を実行して、コマンドのリストを表示してみましょう。 \ No newline at end of file From 4aa87871452e6789fc17d02e668e8444e3e782c0 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Wed, 18 Oct 2017 07:17:13 +0900 Subject: [PATCH 03/27] translated Polymer-Project.org "Tools overview" --- polymer-project.org/Polymer/polymer-cli.md | 53 +++++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md index a791b2a..b3dc178 100644 --- a/polymer-project.org/Polymer/polymer-cli.md +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -79,4 +79,55 @@ npm install -g polymer-cli > You're all set. Run polymer help to view a list of commands. -インストールは以上です。`polymer help`を実行して、コマンドのリストを表示してみましょう。 \ No newline at end of file +インストールは以上です。`polymer help`を実行して、コマンドのリストを表示してみましょう。 + + +> CLI project types + +## CLI project types + +> Polymer CLI works with two types of projects: + +Polymer CLIは2種類のプロジェクトで動作します。 + + +> Elements projects. + +エレメントプロジェクト + +> In an element project, you expose a single element or group of related elements which you intend to use in other element or app projects, or distribute on a registry like Bower or NPM. + +エレメントプロジェクト, 他のエレメントプロジェクトやアプリプロジェクトで使用する単一エレメントまたは関連エレメントのグループを公開するか、BowerやNPMなどに配布します。 + +> Elements are reusable and organized to be used alongside other elements, so components are referenced outside the project. + +エレメントは他のエレメントとともに使用するために再利用可能で構成されているため、コンポーネントはプロジェクトの外部で参照されます。 + + + +> See the guide to creating an element project with the Polymer CLI for more information. + +詳細については、[Polymer CLIを使用したエレメントプロジェクトの作成](https://www.polymer-project.org/2.0/docs/tools/create-element-polymer-cli)に関するガイドを参照してください。 + + + +> Application projects. + +アプリケーションプロジェクト + +> In an app project, you build an application, composed of Polymer elements, which you intend to deploy as a website. + +アプリケーションプロジェクトでは、Polymerで構成されたアプリケーションを作成できます。このアプリケーションはWebサイトとして展開します。 + +> Applications are self-contained, organized with components inside the application. + +アプリケーションは自己完結型で、アプリケーション内のコンポーネントで構成されています。 + + + +> See the guide to creating an application project with the Polymer CLI for more information. + +詳細については、[Polymer CLIを使用してアプリケーションプロジェクトを作成する](https://www.polymer-project.org/2.0/docs/tools/create-app-polymer-cli)ためのガイドを参照してください。 + + + From 6e6ba60159f0f94e9c638a3c7cc712ba219926bf Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Thu, 19 Oct 2017 08:43:53 +0900 Subject: [PATCH 04/27] translated Polymer-Project.org "polymer-cli" --- polymer-project.org/Polymer/polymer-cli.md | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md index b3dc178..59abc3a 100644 --- a/polymer-project.org/Polymer/polymer-cli.md +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -130,4 +130,27 @@ Polymer CLIは2種類のプロジェクトで動作します。 詳細については、[Polymer CLIを使用してアプリケーションプロジェクトを作成する](https://www.polymer-project.org/2.0/docs/tools/create-app-polymer-cli)ためのガイドを参照してください。 +## Commands +> See the documentation on Polymer CLI commands for a list of commands and how to use them. + +コマンドとそれらの使用方法については、[Polymer CLI commands](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands)を参照してください。 + + +> Installing Polymer CLI pre-requisites on Windows 10 + +## Windows 10にPolymer CLIをインストールする前提条件 + +> There are multiple ways to install the pre-requisites for the Polymer CLI on a Windows 10 system. + +Windows 10システムでPolymer CLIの前提条件をインストールするには、複数の方法があります。 + +> This method uses Bash on the Windows Subsystem for Linux. + +ここでは、WindowsサブシステムのBashを使用します。 + + + +> For complete and up-to-date installation instructions for Bash on the Windows Subsystem for Linux, we recommend you review the Bash on ubuntu on Windows documentation. + +Bashの最新のインストール手順については、[WindowsのUbuntuに関するドキュメント](https://msdn.microsoft.com/en-us/commandline/wsl/about)を参照してください。 From 0459c4cfc21587de7b7ea2e0b1a47e5150cdc226 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Fri, 20 Oct 2017 12:09:38 +0900 Subject: [PATCH 05/27] translated Polymer-Project.org "polymer-cli" --- polymer-project.org/Polymer/polymer-cli.md | 42 ++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md index 59abc3a..7866fc6 100644 --- a/polymer-project.org/Polymer/polymer-cli.md +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -154,3 +154,45 @@ Windows 10システムでPolymer CLIの前提条件をインストールする > For complete and up-to-date installation instructions for Bash on the Windows Subsystem for Linux, we recommend you review the Bash on ubuntu on Windows documentation. Bashの最新のインストール手順については、[WindowsのUbuntuに関するドキュメント](https://msdn.microsoft.com/en-us/commandline/wsl/about)を参照してください。 + +> Enable Bash on Windows 10 + +### Windows 10で`Bash`を有効にする + +> Check your OS build by selecting Start > System > OS Build. +> Make sure you have an x64 installation of Windows 10 with OS build > 14393. + +> Open Settings > Update and Security > For developers and select Developer Mode. + +> From the Start Menu, search for Turn Windows features on or off and select Windows Subsystem for Linux (beta). + +> Restart your computer. + +> Log in as Administrator. + +> From a PowerShell prompt, run the following command: + +> Open a Bash prompt: + +> Follow the prompts to create a new user. + +1. `Start > System > OS Build`の順に選択してOSの情報を確認する +1. `Settings > Update and Security > For developers`を開き、`Developer Mode`を選択します +1. Startメニューから、`Windows features on or off`を探して、`Windows Subsystem for Linux (beta)`を選択します。 +1. コンピューターを再起動します +1. `Administrator`でログインします +1. PowerShellプロンプトから、下記のコマンドを実行します +``` +Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux +``` +7. Bashプロンプトを開きます +``` +bash +``` +8. プロンプトに従って新しいユーザーを作成します。 + +> Your Bash installation is complete. +> You can start now start a new Bash prompt by typing bash from the Start menu. + +これでBashのインストールは完了です。 +Startメニューからbashと入力すると、新しいBashプロンプトを起動することができます。 From 7f716a7fa99df8848ab4b4791024aaf1e8878118 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sat, 21 Oct 2017 15:49:37 +0900 Subject: [PATCH 06/27] translated Polymer-Project.org "polymer-cli" --- polymer-project.org/Polymer/polymer-cli.md | 47 ++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli.md b/polymer-project.org/Polymer/polymer-cli.md index 7866fc6..9bbc727 100644 --- a/polymer-project.org/Polymer/polymer-cli.md +++ b/polymer-project.org/Polymer/polymer-cli.md @@ -196,3 +196,50 @@ bash これでBashのインストールは完了です。 Startメニューからbashと入力すると、新しいBashプロンプトを起動することができます。 + + + +> Install Node with nvm + +### nvmでNodeをインストールする + +> For complete and up-to-date instructions, refer to the official documentation for installing Node with nvm. + +最新の手順については、[nvmの公式ドキュメント](https://github.com/creationix/nvm)を参照してください。 + +> Type the following command to use an install script: + +1. 次のコマンドを入力して、インストールスクリプトを使用します。 + +``` +curl -o- https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash +``` + +> Restart your terminal by closing and re-opening your Bash prompt. + +2. ターミナルを再起動してください。 + +> Install the latest version of Node: + +3. Nodeの最新バージョンをインストールします。 + +``` +nvm install node +``` + + +> Optional: Set a default browser + +### オプション：デフォルトブラウザ開く + +> Optionally, set a default browser so polymer serve --open has something to open. Use your own Path variable. + +オプションで、`polymer serve --open`よりデフォルトブラウザで開くように設定します。Path変数を使用します。 + +``` +echo $'\n'export BROWSER=/mnt/c/Program\\\ Files\\\ \\\(x86\\\)/Google/Chrome/Application/chrome.exe >> ~/.bashrc +``` + + + + \ No newline at end of file From d34e6953ac3c16697e76a97d140faea589cecf59 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Tue, 24 Oct 2017 07:18:12 +0900 Subject: [PATCH 07/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 polymer-project.org/Polymer/polymer-cli-commands.md diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md new file mode 100644 index 0000000..d196fc0 --- /dev/null +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -0,0 +1,23 @@ +## Polymer CLI コマンド + +> This section explains various useful Polymer CLI commands that you'll want to incorporate into your development workflow while you build your element or app project. + +ここでは、エレメントまたはアプリケーションを構築する際に、開発に役立つPolymer CLIコマンドについて説明します。 + +> The commands are intended for both element and app projects unless otherwise noted. + +コマンドは、特に明記しない限り、エレメントとアプリケーションの両方を対象としています。 + +polymer build (プロジェクトのみ) +polymer init +polymer install +polymer lint +polymer serve +polymer test +Global options for Polymer CLI commands + + + + + + From c5410a46fa9e00ddfaa722d7a772edad68636a2b Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Thu, 26 Oct 2017 08:23:55 +0900 Subject: [PATCH 08/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index d196fc0..7c87658 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -16,8 +16,61 @@ polymer serve polymer test Global options for Polymer CLI commands +### polymer build +> This command is for app projects only. +_このコマンドはアプリケーションのみを対象としております_ + +> Generates a production-ready build of your app. + +プロダクション対応のアプリケーションを生成します。 + +> This process includes minifying the HTML, CSS, and JS of the application dependencies, +> and generating a service worker to pre-cache dependencies. + +このプロセスでは、アプリケーションのHTML、CSS、JSを縮小し、依存関係をキャッシュするサービスワーカーを生成します。 + +> Polymer CLI's build process is designed for apps that follow the PRPL pattern. + +Polymer CLIのビルドプロセスは、PRPLパターンに沿ってアプリケーションを設計しています。 + +> To make sure your app builds properly, create a polymer.json file at the top-level of your project and store your build configurations there. + +アプリケーションが適切にビルドされていることを確認するには、プロジェクトの先頭にpolymer.jsonファイルを作成し、そこにビルド設定を保存します。 + +> See the polymer.json specification for more information. + +詳細については、[polymer.jsonの仕様](https://www.polymer-project.org/2.0/docs/tools/polymer-json)を参照してください + + + +> You can also pass equivalent values via the following command-line flags. + +次のcommand-lineフラグを使用して同等の値を渡すこともできます。 + +> This can be useful for building simple projects on your machine but you will need to include the flag every time you run the command. + +これはシンプルなプロジェクトを構築するのに便利ですが、コマンドを実行するたびにフラグを含める必要があります。 + +> For most projects a polymer.json configuration file will be easier to work with and share across your team. + +多くのプロジェクトでは、polymer.jsonを作成することで設定を共有しやすくなります。 + +- --add-service-worker +- --bundle +- --css-minify +- --entrypoint +- --html-minify +- --insert-prefetch-links +- --js-compile +- --js-minify +- --shell +- --fragment + +> A set of presets have been provided to cover common configurations - see the section below on build presets. + +共通の設定をカバーするプリセットが用意されています。以下のビルドプリセットのセクションを参照してください。 From e1dcd81ebf958e8e7f95132eaabaee0f2846d45c Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Fri, 27 Oct 2017 12:00:27 +0900 Subject: [PATCH 09/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 7c87658..57cf119 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -73,4 +73,30 @@ Polymer CLIのビルドプロセスは、PRPLパターンに沿ってアプリ 共通の設定をカバーするプリセットが用意されています。以下のビルドプリセットのセクションを参照してください。 +#### --add-service-worker + +> Generate a service worker for your application to cache all files and assets on the client. + +アプリケーションのすべてのファイルをキャッシュするサービスワーカーを生成します。 + +> Polymer CLI will generate a service worker for your build using the sw-precache library. + +Polymer CLIは、[sw-precache](https://github.com/GoogleChrome/sw-precache)ライブラリを使用してビルド用のサービスワーカーを生成します。 + +> To customize your service worker, create a `sw-precache-config.js` file in your project directory that exports your configuration. + +サービスワーカーに変更を加えるには、プロジェクトディレクトリにsw-precache-config.jsファイルを作成します。 + +> See the sw-precache README for a list of all supported options. + +サポートされているオプションについては、sw-precacheの[README](https://github.com/GoogleChrome/sw-precache)を参照してください。 + + +> Note that the sw-precache library uses a cache-first strategy for maximum speed and makes some other assumptions about how your service worker should behave. + +sw-precacheライブラリは、高速化のために[cache-first](http://jakearchibald.com/2014/offline-cookbook/#cache-falling-back-to-network)を使用します。サービスワーカーに他の用途を持たせる場合に注意してください。 + +> Read the "Considerations" section of the sw-precache README to make sure that this is suitable for your application. + +このオプションがアプリケーションに適していることを確認するには、sw-precache READMEの [Considerationsセクション](https://github.com/GoogleChrome/sw-precache#considerations)を読んでください。 From 829f9cd96ce59bc3702510a9d866c3e67f99e861 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sat, 28 Oct 2017 09:21:13 +0900 Subject: [PATCH 10/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 57cf119..95cc7b2 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -100,3 +100,21 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear このオプションがアプリケーションに適していることを確認するには、sw-precache READMEの [Considerationsセクション](https://github.com/GoogleChrome/sw-precache#considerations)を読んでください。 + +#### --bundle + +> By default, fragments are unbundled. + +デフォルトでは、フラグメントはバンドルされていません。 + +> This is optimal for HTTP/2-compatible servers and clients. + +これは、HTTP/2互換のサーバーとクライアントに最適です。 + +> If the --bundle flag is supplied, all fragments are bundled together to reduce the number of file requests. + +--bundleフラグを指定すると、すべてのフラグメントがバンドルされ、ファイルリクエストの数が削減されます。 + +> This is optimal for sending to clients or serving from servers that are not HTTP/2 compatible. + +これは、クライアントへの送信やHTTP/2と互換性のないサーバーからの配信に最適です。 \ No newline at end of file From 75a829d27f29b0d623283327bffc8f670a3c5452 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sun, 29 Oct 2017 10:14:47 +0900 Subject: [PATCH 11/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 32 ++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 95cc7b2..9a69578 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -117,4 +117,34 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear > This is optimal for sending to clients or serving from servers that are not HTTP/2 compatible. -これは、クライアントへの送信やHTTP/2と互換性のないサーバーからの配信に最適です。 \ No newline at end of file +これは、クライアントへの送信やHTTP/2と互換性のないサーバーからの配信に最適です。 + + +#### --css-minify + +> Minify inlined and external CSS. + +インラインCSS含め、CSSを縮小します。 + + +#### --entrypoint + +> A filename. + +ファイル名を指定します + +> This is the main entrypoint into your application for all routes. + +ここで指定したファイルがアプリケーションのエントリポイントになります。 + +> Often times this is your index.html file. + +デフォルトは`index.html`になっています。 + +> This file should import the app shell file specified in the shell option. + +このファイルは、シェルオプションで指定されたアプリケーション[シェル](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#shell)ファイルをインポートする必要があります。 + +> It should be minimal since it's loaded and cached for each route. + +また、ルートごとに読み込まれキャッシュされるため、ファイルサイズを最小限に抑える必要があります。 From 3b813d88b78fa7a1b6d8d766f1d270471a049827 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Mon, 30 Oct 2017 07:38:59 +0900 Subject: [PATCH 12/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 9a69578..693f9e1 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -148,3 +148,21 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear > It should be minimal since it's loaded and cached for each route. また、ルートごとに読み込まれキャッシュされるため、ファイルサイズを最小限に抑える必要があります。 + + +#### --html-minify + +> Minify HTMl by removing comments and whitespace. + +コメントと空白を削除してHTMlを縮小します。 + + +#### --insert-prefetch-links + +> Insert prefetch link elements into your fragments so that all dependencies are prefetched immediately. + +すべての依存関係がすぐにプリフェッチされるように、プリフェッチリンクエレメントをフラグメントに挿入します。 + +> Add dependency prefetching by inserting tags into entrypoint and tags into fragments and shell for all dependencies. + +``タグをエントリポイントに挿入し、``タグをすべての依存関係のフラグメントとシェルに挿入して、依存関係のプリフェッチを追加します。 \ No newline at end of file From 4dfdacb0d2e7661d645a51788051f5c63726ddb0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K-Tanaka=20=28aka=20E=CC=81couffes=29?= Date: Fri, 3 Nov 2017 17:24:03 +0900 Subject: [PATCH 13/27] #98 [add] original file --- .../docs/tools/polymer-cli-commands.md | 277 ++++++++++++++++++ 1 file changed, 277 insertions(+) create mode 100644 polymer-project.org/docs/tools/polymer-cli-commands.md diff --git a/polymer-project.org/docs/tools/polymer-cli-commands.md b/polymer-project.org/docs/tools/polymer-cli-commands.md new file mode 100644 index 0000000..127b21a --- /dev/null +++ b/polymer-project.org/docs/tools/polymer-cli-commands.md @@ -0,0 +1,277 @@ +--- +title: Polymer CLI Commands +--- + + + +This section explains various useful Polymer CLI commands that you'll want to incorporate into your +development workflow while you build your element or app project. + +The commands are intended for both element and app projects unless otherwise +noted. + +* [polymer build (for app projects only)](#build) +* [polymer init](#init) +* [polymer install](#install) +* [polymer lint](#lint) +* [polymer serve](#serve) +* [polymer test](#tests) +* [Global options for Polymer CLI commands](#global) + +## polymer build {#build} + +*This command is for app projects only.* + +Generates a production-ready build of your app. This process includes minifying the HTML, CSS, and +JS of the application dependencies, and generating a service worker to pre-cache dependencies. + +Polymer CLI's build process is designed for apps that follow the [PRPL pattern](/{{{polymer_version_dir}}}/toolbox/prpl). + +To make sure your app builds properly, create a `polymer.json` file +at the top-level of your project and store your build configurations there. [See the polymer.json +specification for more information](polymer-json). + +You can also pass equivalent values via the following command-line flags. This can be useful for +building simple projects on your machine but you will need to include the flag every time you run +the command. For most projects a `polymer.json` configuration file will be easier to work with and +share across your team. + +* [--add-service-worker](#service-workers) +* [--bundle](#bundles) +* [--css-minify](#css-minify) +* [--entrypoint](#entrypoint) +* [--html-minify](#html-minify) +* [--insert-prefetch-links](#prefetch) +* [--js-compile](#js-compile) +* [--js-minify](#js-minify) +* [--shell](#shell) +* [--fragment](#fragment) + +A set of presets have been provided to cover common configurations - see the section below +on [build presets](#presets). + +### --add-service-worker {#service-workers} + +Generate a service worker for your application to cache all files and assets on the client. + +Polymer CLI will generate a service worker for your build using the +[sw-precache](https://github.com/GoogleChrome/sw-precache) library. To customize your service +worker, create a `sw-precache-config.js` file in your project directory that exports your +configuration. See the [sw-precache README](https://github.com/GoogleChrome/sw-precache) for a list +of all supported options. + +Note that the sw-precache library uses a cache-first strategy for maximum speed and makes some +other assumptions about how your service worker should behave. Read the +["Considerations"](https://github.com/GoogleChrome/sw-precache#considerations) section of the +sw-precache README to make sure that this is suitable for your application. + +### --bundle {#bundles} + +By default, fragments are unbundled. This is optimal for HTTP/2-compatible servers and clients. + +If the `--bundle` flag is supplied, all fragments are bundled together to reduce the number of file +requests. This is optimal for sending to clients or serving from servers that are not HTTP/2 +compatible. + +### --css-minify {#css-minify} + +Minify inlined and external CSS. + +### --entrypoint {#entrypoint} + +A filename. This is the main entrypoint into your application for all routes. Often times this is +your `index.html` file. This file should import the app shell file specified in the +[`shell`](#shell) option. It should be minimal since it's loaded and cached for each route. + +### --html-minify {#html-minify} + +Minify HTMl by removing comments and whitespace. + +### --insert-prefetch-links {#prefetch} +Insert prefetch link elements into your fragments so that all dependencies are prefetched +immediately. Add dependency prefetching by inserting `` tags into entrypoint +and `` tags into fragments and shell for all dependencies. + +### --js-compile {#js-compile} + +Use babel to compile all ES6 JS down to ES5 for older browsers. + +### --js-minify {#js-minify} + +Minify inlined and external JavaScript. + +### --shell {#shell} + +The app shell file containing common code for the app. + +### --fragment {#fragment} + +This flag supports dynamic dependencies. It is an array of any HTML filenames that are not +statically linked from the app shell (that is, imports loaded on demand by `importHref`). + +If a fragment has static dependencies, provided the fragment is defined in this property, the +Polymer build analyzer will find them. You only need to list the file imported by importHref. + +In a Polymer app, the files listed in the fragments flag usually contain one or more element +definitions that may or may not be required during the user’s interaction with the app, and can +thus be lazily loaded. + +### Build presets {#presets} + +```bash +polymer build --preset preset-name +``` + +**Build presets** provide an easy way to create common build configurations. When you provide a valid preset for your build, it will use the flags in that preset. We currently support 3 different presets: + +- **es5-bundled:** + --js-minify --js-compile --css-minify --bundled --add-service-worker --add-push-manifest --insert-prefetch-links + +- **es6-bundled:** + --js-minify --css-minify --html-minify --bundled --add-service-worker --add-push-manifest --insert-prefetch-links + +- **es6-unbundled:** + --js-minify --css-minify --html-minify --add-service-worker --add-push-manifest --insert-prefetch-links + +### Examples {#examples} + +Create a bundled build for browsers that support ES5: + +`polymer build --preset es5-bundled` + +Create an unbundled build for browsers that support ES6: + +`polymer build --preset es6-unbundled` + +## polymer init {#init} + +Initializes a Polymer project from one of several templates. Pre-bundled templates range from just bare-bones to fully featured applications like the [Polymer Shop app](/{{{polymer_version_dir}}}/toolbox/case-study). + +Run `polymer init` to choose a template from a list of all installed templates. Or, if you know the template name before hand, you can provide it as a command argument to select it automatically. + +See the [polymer-cli readme](https://github.com/Polymer/polymer-cli#polymer-init-template) for more information on the `polymer init` command. + +See also: + +* [Create an element project with the Polymer CLI](create-element-polymer-cli) +* [Create an application project with the Polymer CLI](create-app-polymer-cli) +* [Case study of the Polymer Shop app](/{{{polymer_version_dir}}}/toolbox/case-study) + +## polymer install {#install} + +Installs Bower dependencies. Running `polymer install` is equivalent to running `bower install`. + +The `--variants` flag allows you to install dependency variants. See the documentation on [managing dependencies for hybrid elements](/{{{polymer_version_dir}}}/docs/devguide/hybrid-elements#dependency-variants) for more information. + +The `--offline` flag tells the install command not to hit the network to retrieve components. If components are not cached, the install will fail. + +## polymer lint {#lint} + +Analyze your project for syntax errors, missing imports, bad databinding expressions and more. `polymer lint` helps with identifying issues across your HTML, JS, and CSS based on an in-depth analysis of web components in source code. It does not reinvent the wheel though, it focuses on issues specific to web components and Polymer, so it is a good adjunct to other tools like [`eslint`](http://eslint.org/) and [`htmlhint`](http://htmlhint.com/). + +Use it like so: + + polymer lint --rules=polymer-2 + +This will lint all of the code in your project with the `polymer-2` ruleset, which is appropriate for projects using Polymer 2.0. If your code is hybrid and should work with either Polymer 1.x or 2.x then `polymer-2-hybrid` is a better choice, as it will warn you about use of features that do not exist in Polymer 2.x. + +You can pass flags to the linter like `--rules` but even better is to put the configuration in `polymer.json` so that all you need to do is run `polymer lint`. Putting your configuration in `polymer.json` also means that other tools, like IDE plugins can use the same lint configuration. + +Here's what that looks like: + +```json +{ + "lint": { + "rules": ["polymer-2"], + "ignoreWarnings": [] + } +} +``` + +- `rules`: An array of lint rules and rule collections to run on your project. For most projects, one of `polymer-2`, `polymer-2-hybrid`, or `polymer-1` is all that's needed here. +- `ignoreWarnings`: An array of warning codes to ignore. + +### Warning Codes: + +The output of `polymer lint` looks like this: + +``` + + ~~~~~~~~~~~~~~~ + +index.html(83,12) warning [undefined-elements] - The element iron-collapse is not defined +``` + +This means that on line 83 of `index.html` there's an `` tag, but the linter can't find the definition of the `iron-collapse` custom element. This probably means that there's a missing HTML import in `index.html`. To ignore this warning, add `undefined-elements` to the `ignoreWarnings` array in `polymer.json`. + +## polymer serve {#serve} + +Runs a local web server. + +If you want to view a live demo of your element or app, run the local web server: + + polymer serve + +To view the demo, point your browser to one of the following URLs. + +Element project demo: + +
http://localhost:8080/components/my-el/demo/
+ +Element project API reference: + +
localhost:8080/components/my-el/
+ +App project demo: + + http://localhost:8080 + +### Server options {#server-options} + +This section shows examples of using various `polymer serve` options. + +Serve from port 3000: + + polymer serve --port 3000 + +If you have configured a custom hostname on your machine, Polymer CLI can serve it with the +`--hostname` argument (for example, app project demo is available at `http://test:8080`): + + polymer serve --hostname test + +Open up a page other than the default `index.html` in a specific browser +(Apple Safari, in this case): + + polymer serve --open app.html --browser Safari + +## polymer test {#tests} + +Runs tests. + +If you want to run tests on your element or app project, `cd` to the base directory of your project +and run: + + polymer test + +Polymer CLI automatically runs all of the tests that it finds in the `test` directory. You'll see +the results of the tests in your CLI. + +If you create your own tests, they should also go in the `test` directory. + +The underlying library that powers `polymer test` is called `web-component-tester` (`wct`). Learn +more about creating unit tests with `wct` +in [Test your elements](tests). + +## Global options for Polymer CLI commands {#global} + +You can see a list of global options by running `polymer help`. Most of them +are self-explanatory. + +The following commands are currently only supported for the `polymer build` +command, with planned support for other commands in the future. + +* `entry` +* `shell` +* `fragment` + +See [`polymer build`](#build) for more information on how to use these options. From a04fea888abbfff0568f84a3ebb8460c2d79bff2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K-Tanaka=20=28aka=20E=CC=81couffes=29?= Date: Fri, 3 Nov 2017 17:55:37 +0900 Subject: [PATCH 14/27] =?UTF-8?q?kawakami=E3=81=95=E3=82=93=E7=BF=BB?= =?UTF-8?q?=E8=A8=B3=E5=88=86=E3=82=92=E3=80=81=E3=83=87=E3=83=97=E3=83=AD?= =?UTF-8?q?=E3=82=A4=E7=94=A8=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB=E3=81=AB?= =?UTF-8?q?=E7=A7=BB=E6=A4=8D=20#98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Official Document Polymer Tools Polymer CLI Commands --- .../docs/tools/polymer-cli-commands.md | 60 ++++++------------- 1 file changed, 19 insertions(+), 41 deletions(-) diff --git a/polymer-project.org/docs/tools/polymer-cli-commands.md b/polymer-project.org/docs/tools/polymer-cli-commands.md index 127b21a..c9e9ef8 100644 --- a/polymer-project.org/docs/tools/polymer-cli-commands.md +++ b/polymer-project.org/docs/tools/polymer-cli-commands.md @@ -1,16 +1,14 @@ --- -title: Polymer CLI Commands +title: Polymer CLI コマンド --- -This section explains various useful Polymer CLI commands that you'll want to incorporate into your -development workflow while you build your element or app project. +ここでは、エレメントまたはアプリケーションを構築する際に、開発に役立つPolymer CLIコマンドについて説明します。 -The commands are intended for both element and app projects unless otherwise -noted. +コマンドは、特に明記しない限り、エレメントとアプリケーションの両方を対象としています。 -* [polymer build (for app projects only)](#build) +* [polymer build (プロジェクトのみ)](#build) * [polymer init](#init) * [polymer install](#install) * [polymer lint](#lint) @@ -20,21 +18,15 @@ noted. ## polymer build {#build} -*This command is for app projects only.* +*このコマンドはアプリケーションのみを対象としております。* -Generates a production-ready build of your app. This process includes minifying the HTML, CSS, and -JS of the application dependencies, and generating a service worker to pre-cache dependencies. +プロダクション対応のアプリケーションを生成します。このプロセスでは、アプリケーションのHTML、CSS、JSを縮小し、依存関係をキャッシュするサービスワーカーを生成します。 -Polymer CLI's build process is designed for apps that follow the [PRPL pattern](/{{{polymer_version_dir}}}/toolbox/prpl). +Polymer CLIのビルドプロセスは、[PRPLパターン](/{{{polymer_version_dir}}}/toolbox/prpl)に沿ってアプリケーションを設計しています。 -To make sure your app builds properly, create a `polymer.json` file -at the top-level of your project and store your build configurations there. [See the polymer.json -specification for more information](polymer-json). +アプリケーションが適切にビルドされていることを確認するには、プロジェクトの先頭に`polymer.json`ファイルを作成し、そこにビルド設定を保存します。詳細については、[polymer.jsonの仕様](https://www.polymer-project.org/2.0/docs/tools/polymer-json)を参照してください。 -You can also pass equivalent values via the following command-line flags. This can be useful for -building simple projects on your machine but you will need to include the flag every time you run -the command. For most projects a `polymer.json` configuration file will be easier to work with and -share across your team. +次のcommand-lineフラグを使用して同等の値を渡すこともできます。これはシンプルなプロジェクトを構築するのに便利ですが、コマンドを実行するたびにフラグを含める必要があります。 多くのプロジェクトでは、`polymer.json`を作成することで設定を共有しやすくなります。 * [--add-service-worker](#service-workers) * [--bundle](#bundles) @@ -47,50 +39,36 @@ share across your team. * [--shell](#shell) * [--fragment](#fragment) -A set of presets have been provided to cover common configurations - see the section below -on [build presets](#presets). +共通の設定をカバーするプリセットが用意されています。以下の[ビルドプリセット](#presets)のセクションを参照してください。 ### --add-service-worker {#service-workers} -Generate a service worker for your application to cache all files and assets on the client. +アプリケーションのすべてのファイルをキャッシュするサービスワーカーを生成します。 -Polymer CLI will generate a service worker for your build using the -[sw-precache](https://github.com/GoogleChrome/sw-precache) library. To customize your service -worker, create a `sw-precache-config.js` file in your project directory that exports your -configuration. See the [sw-precache README](https://github.com/GoogleChrome/sw-precache) for a list -of all supported options. +Polymer CLIは、[sw-precache](https://github.com/GoogleChrome/sw-precache)ライブラリを使用してビルド用のサービスワーカーを生成します。サービスワーカーに変更を加えるには、プロジェクトディレクトリに`sw-precache-config.js`ファイルを作成します。サポートされているオプションについては、sw-precacheの[README](https://github.com/GoogleChrome/sw-precache)を参照してください。 -Note that the sw-precache library uses a cache-first strategy for maximum speed and makes some -other assumptions about how your service worker should behave. Read the -["Considerations"](https://github.com/GoogleChrome/sw-precache#considerations) section of the -sw-precache README to make sure that this is suitable for your application. +sw-precacheライブラリは、高速化のために[cache-first](http://jakearchibald.com/2014/offline-cookbook/#cache-falling-back-to-network)を使用します。サービスワーカーに他の用途を持たせる場合に注意してください。このオプションがアプリケーションに適していることを確認するには、sw-precache READMEの [Considerationsセクション](https://github.com/GoogleChrome/sw-precache#considerations)を読んでください。 ### --bundle {#bundles} -By default, fragments are unbundled. This is optimal for HTTP/2-compatible servers and clients. +デフォルトでは、フラグメントはバンドルされていません。これは、HTTP/2互換のサーバーとクライアントに最適です。 -If the `--bundle` flag is supplied, all fragments are bundled together to reduce the number of file -requests. This is optimal for sending to clients or serving from servers that are not HTTP/2 -compatible. +`--bundle`フラグを指定すると、すべてのフラグメントがバンドルされ、ファイルリクエストの数が削減されます。これは、クライアントへの送信やHTTP/2と互換性のないサーバーからの配信に最適です。 ### --css-minify {#css-minify} -Minify inlined and external CSS. +インラインCSS含め、CSSを縮小します。 ### --entrypoint {#entrypoint} -A filename. This is the main entrypoint into your application for all routes. Often times this is -your `index.html` file. This file should import the app shell file specified in the -[`shell`](#shell) option. It should be minimal since it's loaded and cached for each route. +ファイル名を指定します。ここで指定したファイルがアプリケーションのエントリポイントになります。デフォルトは`index.html`になっています。このファイルは、シェルオプションで指定されたアプリケーション[シェル](https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#shell)ファイルをインポートする必要があります。また、ルートごとに読み込まれキャッシュされるため、ファイルサイズを最小限に抑える必要があります。 ### --html-minify {#html-minify} -Minify HTMl by removing comments and whitespace. +コメントと空白を削除してHTMlを縮小します。 ### --insert-prefetch-links {#prefetch} -Insert prefetch link elements into your fragments so that all dependencies are prefetched -immediately. Add dependency prefetching by inserting `` tags into entrypoint -and `` tags into fragments and shell for all dependencies. +すべての依存関係がすぐにプリフェッチされるように、プリフェッチリンクエレメントをフラグメントに挿入します。``タグをエントリポイントに挿入し、``タグをすべての依存関係のフラグメントとシェルに挿入して、依存関係のプリフェッチを追加します。 ### --js-compile {#js-compile} From 6406a319b8ba993717d726019ad7d64955e53b74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K-Tanaka=20=28aka=20E=CC=81couffes=29?= Date: Fri, 3 Nov 2017 23:45:57 +0900 Subject: [PATCH 15/27] translated Polymer-Project.org "polymer-cli-commands" --- polymer-project.org/docs/tools/polymer-cli-commands.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/polymer-project.org/docs/tools/polymer-cli-commands.md b/polymer-project.org/docs/tools/polymer-cli-commands.md index c9e9ef8..8c797aa 100644 --- a/polymer-project.org/docs/tools/polymer-cli-commands.md +++ b/polymer-project.org/docs/tools/polymer-cli-commands.md @@ -72,11 +72,11 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear ### --js-compile {#js-compile} -Use babel to compile all ES6 JS down to ES5 for older browsers. +babelを使用して、すべてのES6 JSをオールドブラウザのES5までコンパイルします。 ### --js-minify {#js-minify} -Minify inlined and external JavaScript. +インラインJavaScriptおよび外部JavaScriptを縮小します。 ### --shell {#shell} @@ -184,13 +184,13 @@ This means that on line 83 of `index.html` there's an `` tag, but ## polymer serve {#serve} -Runs a local web server. +ローカルWebサーバーを実行します。 -If you want to view a live demo of your element or app, run the local web server: +エレメントまたはアプリのライブデモを表示するには、ローカルWebサーバーを実行します： polymer serve -To view the demo, point your browser to one of the following URLs. +デモを表示するには、ブラウザで次のいずれかのURLを指定します。 Element project demo: From 8e23de43c34664e928bd16eb0f67775ba1881f95 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Wed, 8 Nov 2017 09:03:54 +0900 Subject: [PATCH 16/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 693f9e1..807fa97 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -165,4 +165,22 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear > Add dependency prefetching by inserting tags into entrypoint and tags into fragments and shell for all dependencies. -``タグをエントリポイントに挿入し、``タグをすべての依存関係のフラグメントとシェルに挿入して、依存関係のプリフェッチを追加します。 \ No newline at end of file +``タグをエントリポイントに挿入し、``タグをすべての依存関係のフラグメントとシェルに挿入して、依存関係のプリフェッチを追加します。 + +#### --js-compile + +> Use babel to compile all ES6 JS down to ES5 for older browsers. + +古いブラウザ向けに、ES6をES5にコンパイルする`babel`を使います。 + +#### --js-minify + +> Minify inlined and external JavaScript. + +インラインJavaScriptと外部JavaScriptを縮小します。 + +#### --shell + +> The app shell file containing common code for the app. + +アプリの共通コードを含むアプリケーションシェルファイルを指定します。 From 2536a794329e75a8e8a34039429bc9a7f5abc375 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sat, 11 Nov 2017 18:51:19 +0900 Subject: [PATCH 17/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 59 +++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 807fa97..d1a74bd 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -184,3 +184,62 @@ sw-precacheライブラリは、高速化のために[cache-first](http://jakear > The app shell file containing common code for the app. アプリの共通コードを含むアプリケーションシェルファイルを指定します。 + + +#### --fragment + +> This flag supports dynamic dependencies. + +このフラグは動的依存関係をサポートします。 + +> It is an array of any HTML filenames that are not statically linked from the app shell (that is, imports loaded on demand by importHref). + +これは、アプリケーションシェルから静的にリンクされていない、HTMLファイル名の入った配列です。（つまり、`importHref`より必要に応じて読み込まれたものでえす） + + +> If a fragment has static dependencies, provided the fragment is defined in this property, the Polymer build analyzer will find them. + +フラグメントに静的な依存関係がある場合、フラグメントがこのプロパティで定義されている場合は、Polymerビルドアナライザがそれらを検出します。 + +> You only need to list the file imported by importHref. + +importHrefでインポートされたファイルをリストするだけです。 + + + +> In a Polymer app, + +Polymer アプリケーションでは + +> the files listed in the fragments flag usually contain one or more element definitions that may or may not be required during the user’s interaction with the app, and can thus be lazily loaded. + +フラグメントフラグに羅列されているファイルには、通常、ユーザがアプリケーションとやりとりしている間に必要となるかもしれない要素定義が含まれていて、遅延ロードすることができます。 + +#### プリセットを作成する + +``` +polymer build --preset preset-name +``` + +> Build presets provide an easy way to create common build configurations. + +ビルドプリセットは、共通のビルド構成を簡単に作成する方法を提供します。 + +> When you provide a valid preset for your build, it will use the flags in that preset. + +ビルドに有効なプリセットを指定すると、そのプリセットのフラグが使用されます。 + +> We currently support 3 different presets: + +現在、3種類のプリセットをサポートしています + +#### 例 + +> Create a bundled build for browsers that support ES5: + +ES5をサポートするブラウザのバンドルビルドを作成します。 + +> Create an unbundled build for browsers that support ES6 + +ES6をサポートするブラウザのバンドルしないビルドを作成します。 + From a457da8f313be2f3e5159f65a705d69e333d99a8 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Mon, 13 Nov 2017 08:24:12 +0900 Subject: [PATCH 18/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index d1a74bd..6ecef93 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -243,3 +243,48 @@ ES5をサポートするブラウザのバンドルビルドを作成します ES6をサポートするブラウザのバンドルしないビルドを作成します。 +### polymer init + +> Initializes a Polymer project from one of several templates. + +いくつかのテンプレートの1つからPolymerプロジェクトを初期化します。 + +> Pre-bundled templates range from just bare-bones to fully featured applications like the Polymer Shop app. + +用意されているテンプレートには、基本的なものから[Polymer Shopアプリ](https://www.polymer-project.org/2.0/toolbox/case-study)のような完全に機能するアプリケーションまで、色々のものがあります。 + + + +> Run polymer init to choose a template from a list of all installed templates. + +`polymer init`を実行しますと、インストールされているテンプレートの中からひとつを選択します。 + +> Or, if you know the template name before hand, you can provide it as a command argument to select it automatically. + +または、テンプレート名がわかっている場合は、それをコマンド引数として指定することができます。 + +> See the polymer-cli readme for more information on the polymer init command. + +`polymer init`コマンドの詳細については、[polymer-cli readme](https://github.com/Polymer/polymer-cli#polymer-init-template)を参照してください。 + +> See also + +以下も参考にして下さい + +> Create an element project with the Polymer CLI + +[Polymer CLIを使用したエレメントプロジェクトの作成](https://www.polymer-project.org/2.0/docs/tools/create-element-polymer-cli) + +> Create an application project with the Polymer CLI + +[Polymer CLIを使用したアプリケーションプロジェクトの作成](https://www.polymer-project.org/2.0/docs/tools/create-app-polymer-cli) + +> Case study of the Polymer Shop app + +[Polymer Shopアプリのケーススタディ](https://www.polymer-project.org/2.0/toolbox/case-study) + + + + + + From c7c653a3bd6c503d942299b395c0d41ccac545d2 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Tue, 14 Nov 2017 10:36:57 +0900 Subject: [PATCH 19/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 6ecef93..5327076 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -284,7 +284,25 @@ ES6をサポートするブラウザのバンドルしないビルドを作成 [Polymer Shopアプリのケーススタディ](https://www.polymer-project.org/2.0/toolbox/case-study) +### polymer install +> Installs Bower dependencies. Running polymer install is equivalent to running bower install. +Bowerよりインストールを行います。`polymer install`は、`bower install`と同じように動きます。 +> The --variants flag allows you to install dependency variants. +`--variants`フラグを使用すると、バージョン依存をインストール出来ます。 + +> See the documentation on managing dependencies for hybrid elements for more information. + +詳細については、[ハイブリッドエレメントの依存関係の管理](https://www.polymer-project.org/2.0/docs/devguide/hybrid-elements#dependency-variants)に関するドキュメントを参照してください。 + + +> The --offline flag tells the install command not to hit the network to retrieve components. + +`--offline`フラグは、ネットワークからコンポーネントを取得させないようにします。 + +> If components are not cached, the install will fail. + +これは、コンポーネントがキャッシュされていない場合には、インストールは失敗します。 From 5202490d8981aafa348eccb46d228f59c3cc23d5 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Wed, 15 Nov 2017 08:58:53 +0900 Subject: [PATCH 20/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 5327076..f073cdd 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -306,3 +306,29 @@ Bowerよりインストールを行います。`polymer install`は、`bower ins > If components are not cached, the install will fail. これは、コンポーネントがキャッシュされていない場合には、インストールは失敗します。 + + +### polymer lint + +> Analyze your project for syntax errors, missing imports, bad databinding expressions and more. + +プロジェクトの構文、インポート、データバインディングなどにエラーが無いかをチェックします。 + +> polymer lint helps with identifying issues across your HTML, JS, and CSS based on an in-depth analysis of web components in source code. + +`polymer lint`は、ソースコード内のWebコンポーネントの分析から、HTML、JS、およびCSSの問題を特定するのに役立ちます。 + +> It does not reinvent the wheel though, it focuses on issues specific to web components and Polymer, so it is a good adjunct to other tools like eslint and htmlhint. + +`polymer lint`は、WebコンポーネントとPolymerに焦点を当てており、`eslint`や`htmlhint`のような他のlintツールのような機能は持っておりません。 + +> Use it like so: + +使い方 + +``` + polymer lint --rules=polymer-2 +``` + + + From 897cb37c32ece946a3630b69ff1c9df02b6d01eb Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Thu, 16 Nov 2017 07:44:50 +0900 Subject: [PATCH 21/27] translated Polymer-Project.org "polymer-cli-commands" --- polymer-project.org/Polymer/polymer-cli-commands.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index f073cdd..c4069f7 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -330,5 +330,15 @@ Bowerよりインストールを行います。`polymer install`は、`bower ins polymer lint --rules=polymer-2 ``` +> This will lint all of the code in your project with the polymer-2 ruleset, which is appropriate for projects using Polymer 2.0. + +これにより、`polymer-2`のルールに適するように、プロジェクトをlintします。 + +> If your code is hybrid and should work with either Polymer 1.x or 2.x then polymer-2-hybrid is a better choice, as it will warn you about use of features that do not exist in Polymer 2.x. + +コードがハイブリッドで、Polymer 1.x、または、2.xで動作する必要がある場合は、Polymer 2.xには存在しない機能を使用すると警告されますので、`polymer-2-hybrid`を選択することをお勧めします。 + + + From f3ad02ebacca918249ac18bba28cda4c2d698d65 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Fri, 17 Nov 2017 08:07:26 +0900 Subject: [PATCH 22/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index c4069f7..2ecda90 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -339,6 +339,25 @@ Bowerよりインストールを行います。`polymer install`は、`bower ins コードがハイブリッドで、Polymer 1.x、または、2.xで動作する必要がある場合は、Polymer 2.xには存在しない機能を使用すると警告されますので、`polymer-2-hybrid`を選択することをお勧めします。 +> You can pass flags to the linter like --rules but even better is to put the configuration in polymer.json so that all you need to do is run polymer lint. + +linterに`--rules`のようなフラグを渡すことはできますが、`polymer.json`に設定を書くことで`polymer int`のみで実行が可能になります。 + +> Putting your configuration in polymer.json also means that other tools, like IDE plugins can use the same lint configuration. + +ここで設定した内容は、IDEプラグインのような、他のツールにも使うことができます。 + +> Here's what that looks like: + +設定の例: + +``` + "lint": { + "rules": ["polymer-2"], + "ignoreWarnings": [] + } +``` + From 77e9bc78d38f7c474cd498bf75f43d8e1779d72d Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sat, 18 Nov 2017 10:14:27 +0900 Subject: [PATCH 23/27] translated Polymer-Project.org "polymer-cli-commands" --- polymer-project.org/Polymer/polymer-cli-commands.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 2ecda90..76255fd 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -358,6 +358,15 @@ linterに`--rules`のようなフラグを渡すことはできますが、`poly } ``` +> rules: An array of lint rules and rule collections to run on your project. + +rules: lintルールを設定する配列。 + +> For most projects, one of polymer-2, polymer-2-hybrid, or polymer-1 is all that's needed here. + +多くのプロジェクトでは、`polymer-2`、`polymer-2-hybrid`、または`polymer-1`のいずれかが必要になります。 +> ignoreWarnings: An array of warning codes to ignore. +ignoreWarnings: 無効にしたい警告を指定する配列になります。 \ No newline at end of file From e2f70041b29b4e5ad345df3ec0069065436cf04a Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Sun, 19 Nov 2017 11:41:05 +0900 Subject: [PATCH 24/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index 76255fd..faf4222 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -369,4 +369,24 @@ rules: lintルールを設定する配列。 > ignoreWarnings: An array of warning codes to ignore. -ignoreWarnings: 無効にしたい警告を指定する配列になります。 \ No newline at end of file +ignoreWarnings: 無効にしたい警告を指定する配列になります。 + +#### Warning Codes: + +> The output of polymer lint looks like this: + +Warningが会った場合に、次のように表示されます + +> This means that on line 83 of index.html there's an tag, but the linter can't find the definition of the iron-collapse custom element. + +上記は、index.html 83行目に``タグがありますが、`iron-collapse`カスタムエレメントを見つけることが出来ません。と表しております。 + +> This probably means that there's a missing HTML import in index.html. + +`index.html`のHTMLインポートが間違っていることが予想されます。 + +> To ignore this warning, add undefined-elements to the ignoreWarnings array in polymer.json. + +この警告を無効にする場合は、`polymer.json`の`ignoreWarnings`配列に、`undefined-elements`を追加します。 + + From b79440b692dfdfe4472103bab18456aac37c0408 Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Tue, 21 Nov 2017 08:54:02 +0900 Subject: [PATCH 25/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index faf4222..d9d62e0 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -390,3 +390,60 @@ Warningが会った場合に、次のように表示されます この警告を無効にする場合は、`polymer.json`の`ignoreWarnings`配列に、`undefined-elements`を追加します。 +### polymer serve + +> Runs a local web server. + +ローカル環境でウェブサーバーを立ち上げます。 + +> If you want to view a live demo of your element or app, run the local web server: + +作ったアプリケーションのデモを確認したい場合に、ローカル環境のウェブサーバーで確認します。 + +``` +polymer serve +``` + +> To view the demo, point your browser to one of the following URLs. + +デモを表示するには、ブラウザで次のURLを指定します。 + +> Element project demo: + +エレメントプロジェクトのデモの場合 + +> Element project API reference: + +エレメントプロジェクトのAPIリファレンスの場合 + +> App project demo: + +アプリケーションプロジェクトの場合 + + +#### Server options + +> This section shows examples of using various polymer serve options. + +ここからは、`polymer serve`のオプションの使用例を見ていきましょう。 + +##### --port + +> Serve from port 3000: + +サーバーのポートを3000番に指定した場合。 + +##### --hostname + +> If you have configured a custom hostname on your machine, Polymer CLI can serve it with the --hostname argument (for example, app project demo is available at http://test:8080): + +ホスト名を独自に設定している場合は、`--hostname`引数から指定が行えます（例、appプロジェクトのデモでは、`http://test:8080`より利用できます）。 + +##### --open + +> Open up a page other than the default index.html in a specific browser (Apple Safari, in this case): + +特定のブラウザ（この場合は、Apple Safari）では、デフォルトページのindex.html以外のページを開きます。 + + + From ea1ea45823268ac93b84c74d98f58e55f7c4cc7a Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Wed, 22 Nov 2017 08:47:52 +0900 Subject: [PATCH 26/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index d9d62e0..f5719d4 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -445,5 +445,57 @@ polymer serve 特定のブラウザ（この場合は、Apple Safari）では、デフォルトページのindex.html以外のページを開きます。 +##### --compile + +> By default, the server will automatically use Babel to transpile any ES6 code down to ES5 for browsers that don't have native support for important ES6 features like classes. + +通常は、class構文などのES6の機能をサポートしていないブラウザのために、Babelを使用して自動的にES5にトランスパイルしています。 + +> This behavior can be explicitly turned on or off for all browsers via the --compile option. + +この動作は、--compileオプションを使用して、オンまたはオフにすることができます。 + +> Valid values are "auto", "always" and "never". + +設定値には "auto"、 "always"、 "never"があります。 + +> "auto" compiles JavaScript to ES5 for browsers that don't fully support ES6. + +"auto"は、ES6に対応していないブラウザに対しては、JavaScriptをES5にコンパイルします。 + +> Always compile ES6 to ES5: + +常にES6をES5にコンパイルする場合: + +> Never compile ES6 to ES5: + +ES6をES5にコンパイルしない場合: + +> (Default) Automatically compile to ES5 for browsers that don't fully support ES6: + +（デフォルト）ES6に対応していないブラウザの時に、自動的にコンパイルする場合: + + + +> Automatic compilation can cause problems when running in device emulation mode on Chrome. + +autoの場合は、Chromeのデバイスエミュレーションモードで実行すると、問題を引き起こす場合があります。 + +> If the browser sends another browser's user-agent string, the server may switch between compiled and uncompiled responses, leaving the browser with an inconsistent set of resources in its cache. + +ブラウザが別のブラウザのユーザエージェント文字列を送信すると、サーバはコンパイルされたレスポンスとコンパイルされていないレスポンスを切り替えて、キャッシュ内に一貫性のないリソースセットを残します。 + +> This issue may also occur in other browsers with device emulation capabilities. + +この問題は、デバイスエミュレーション機能を備えた他のブラウザでも発生する可能性があります。 + +> Use --compile always or --compile never to avoid this problem. + +この問題を回避するには、--compile alwaysまたは--compile neverを使用してください。 + + +> Run polymer help serve for the full list of available options. + +使用可能なオプションについては、`polymer help serve`を実行してください。 From cc8e0c9c83fed7869dde8ac403039f20c393b3bb Mon Sep 17 00:00:00 2001 From: Kazuyoshi Kawakami Date: Thu, 23 Nov 2017 11:22:11 +0900 Subject: [PATCH 27/27] translated Polymer-Project.org "polymer-cli-commands" --- .../Polymer/polymer-cli-commands.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/polymer-project.org/Polymer/polymer-cli-commands.md b/polymer-project.org/Polymer/polymer-cli-commands.md index f5719d4..16a3c2c 100644 --- a/polymer-project.org/Polymer/polymer-cli-commands.md +++ b/polymer-project.org/Polymer/polymer-cli-commands.md @@ -499,3 +499,53 @@ autoの場合は、Chromeのデバイスエミュレーションモードで実 使用可能なオプションについては、`polymer help serve`を実行してください。 +### polymer test + +> Runs tests. + +テストを実行します + +> If you want to run tests on your element or app project, cd to the base directory of your project and run: + +エレメントやプロジェクトのテストを実行したい場合は、ルートディレクトリに移動して以下のコマンドを実行してください + +``` +polymer test +``` + +> Polymer CLI automatically runs all of the tests that it finds in the test directory. + +Polymer CLIは、`test`ディレクトリで検出したすべてのテストを自動的に実行します。 + +> You'll see the results of the tests in your CLI. + +テスト結果はCLIに表示されます。 + +> If you create your own tests, they should also go in the test directory. + +独自のテストを作成する場合は、`test`ディレクトリに移動します。 + +> The underlying library that powers polymer test is called web-component-tester (wct). + +`polymer test`を実行する基礎となるライブラリは、`web-component-tester（wct）`と呼ばれます。 + +> Learn more about creating unit tests with wct in Test your elements. + +`wct`を使ったユニットテストの作り方については[Test your elements](https://www.polymer-project.org/2.0/docs/tools/tests)をご覧ください + + +### Polymer CLI コマンドのグローバルオプション + +> You can see a list of global options by running polymer help. Most of them are self-explanatory. + +`polymer help`を実行すると、グローバルオプションのリストが表示されます。 + +> The following commands are currently only supported for the polymer build command, with planned support for other commands in the future. + +次のコマンドは現在、`polymer build`コマンドでのみ使用できます。将来的には、他のコマンドでも使用できる予定になります。 + + +> See polymer build for more information on how to use these options. + +さらに詳しい情報を見たい方は、(polymer build)[https://www.polymer-project.org/2.0/docs/tools/polymer-cli-commands#build]でのオプションの項目をご覧ください。 +