diff --git a/docs/guide-ar/start-installation.md b/docs/guide-ar/start-installation.md index b8eb08af2c..3596552780 100644 --- a/docs/guide-ar/start-installation.md +++ b/docs/guide-ar/start-installation.md @@ -121,7 +121,7 @@ composer create-project --prefer-dist yiisoft/yii2-app-basic basic --------------------------

- تعتمد ال Yii على حزم Bower و/أو NPM لتثبيت مكتبات ال (CSS و JavaScript). ويستخدم ال composer للحصول على هذه المكتبات ، مما يسمح بالحصول على إصدارات ال PHP و CSS/JavaScript في نفس الوقت. ويمكن تحقيق ذلك إما عن طريق استخدام asset-packagist.org أو من خلال ال composer asset plugin، يرجى الرجوع إلى Assets documentation لمزيد من التفاصيل. + تعتمد ال Yii على حزم Bower و/أو NPM لتثبيت مكتبات ال (CSS و JavaScript). ويستخدم ال composer للحصول على هذه المكتبات ، مما يسمح بالحصول على إصدارات ال PHP و CSS/JavaScript في نفس الوقت. ويمكن تحقيق ذلك إما عن طريق استخدام asset-packagist.org أو من خلال ال composer asset plugin، يرجى الرجوع إلى Assets documentation لمزيد من التفاصيل.

قد ترغب في إدارة ال assets عبر ال native Bower/NPM أو استخدام ال CDN أو تجنب تثبيت ال assets بالكامل من حلال ال Composer ، ويمكن ذلك من خلال إضافة الأسطر التالية إلى "composer.json":

diff --git a/docs/guide-es/structure-assets.md b/docs/guide-es/structure-assets.md index 0231d53c43..81bb0397ef 100644 --- a/docs/guide-es/structure-assets.md +++ b/docs/guide-es/structure-assets.md @@ -207,7 +207,7 @@ la opción de publicación `beforeCopy`, solo los subdirectorios `fonts` y `css` ### Bower y NPM Assets -La mayoría de paquetes JavaScript/CSS se gestionan con [Bower](http://bower.io/) y/o [NPM](https://www.npmjs.org/). +La mayoría de paquetes JavaScript/CSS se gestionan con [Bower](http://bower.io/) y/o [NPM](https://www.npmjs.com/). Si tu aplicación o extensión usa estos paquetes, se recomienda seguir los siguientes pasos para gestionar los assets en la librería: diff --git a/docs/guide-es/structure-extensions.md b/docs/guide-es/structure-extensions.md index 31d7585478..61d005e463 100644 --- a/docs/guide-es/structure-extensions.md +++ b/docs/guide-es/structure-extensions.md @@ -193,7 +193,7 @@ La extensión depende de Yii (por supuesto). Por ello se debe añadir (`yiisoft/ apropiadas (ej. `1.*`, `@stable`) para cada paquete dependiente. Se deben usar dependencias estables en versiones estables de nuestras extensiones. -La mayoría de paquetes JavaScript/CSS se gestionan usando [Bower](http://bower.io/) y/o [NPM](https://www.npmjs.org/), +La mayoría de paquetes JavaScript/CSS se gestionan usando [Bower](http://bower.io/) y/o [NPM](https://www.npmjs.com/), en lugar de Composer. Yii utiliza el [Composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin) para habilitar la gestión de estos tipos de paquetes a través de Composer. Si la extensión depende de un paquete Bower, se puede, simplemente, añadir la dependencia de el archivo `composer.json` como se muestra a continuación: diff --git a/docs/guide-fr/start-installation.md b/docs/guide-fr/start-installation.md index 655796137a..a7e8b86956 100644 --- a/docs/guide-fr/start-installation.md +++ b/docs/guide-fr/start-installation.md @@ -91,7 +91,7 @@ Mais il y a d'autres options d'installation disponibles : Installer les Assets (ici bibliothèques CSS et JavaScript) ----------------- -Yii s'appuie sur les paquets [Bower](http://bower.io/) et/ou [NPM](https://www.npmjs.org/) pour l'installation des bibliothèques CSS et JavaScript. +Yii s'appuie sur les paquets [Bower](http://bower.io/) et/ou [NPM](https://www.npmjs.com/) pour l'installation des bibliothèques CSS et JavaScript. Il utilise Composer pour les obtenir, permettant ainsi aux versions de paquet de PHP et à celles de CSS/JavaScript, d'être résolues en même temps. Cela peut être obtenue soit en utilisant [asset-packagist.org](https://asset-packagist.org) ou [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/). diff --git a/docs/guide-fr/structure-assets.md b/docs/guide-fr/structure-assets.md index 1ea514dd90..d05cab4bb3 100644 --- a/docs/guide-fr/structure-assets.md +++ b/docs/guide-fr/structure-assets.md @@ -206,7 +206,7 @@ L'exemple ci-dessus définit un paquet de ressources pour le [paquet "fontawesom ### Installation des ressources Bower et NPM -La plupart des paquets JavaScript/CSS sont gérés par le gestionnaire de paquets [Bower](http://bower.io/) et/ou le gestionnaire de paquets [NPM](https://www.npmjs.org/). Dans le monde PHP, nous disposons de Composer, qui gère les dépendances, mais il est possible de charger des paquets Bower et NPM comme des paquets PHP en utilisant `composer.json`. +La plupart des paquets JavaScript/CSS sont gérés par le gestionnaire de paquets [Bower](http://bower.io/) et/ou le gestionnaire de paquets [NPM](https://www.npmjs.com/). Dans le monde PHP, nous disposons de Composer, qui gère les dépendances, mais il est possible de charger des paquets Bower et NPM comme des paquets PHP en utilisant `composer.json`. Pour cela, nous devons configurer quelque peu notre composer. Il y a deux options possibles : diff --git a/docs/guide-fr/structure-extensions.md b/docs/guide-fr/structure-extensions.md index cbf06f8a7b..418e93ac93 100644 --- a/docs/guide-fr/structure-extensions.md +++ b/docs/guide-fr/structure-extensions.md @@ -148,7 +148,7 @@ Losqu'un utilisateur exécute `composer install` pour installer une extension, l Bien sûr, votre extension dépend de Yii. C'est pourquoi, vous devez lister (`yiisoft/yii2`) dans l'entrée `require` dans `composer.json`. Si votre extension dépend aussi d'autres extensions ou bibliothèques de tierces parties, vous devez les lister également. Assurez-vous que vous de lister également les contraintes de versions appropriées (p. ex. `1.*`, `@stable`) pour chacun des paquets dont votre extension dépend. Utilisez des dépendances stables lorsque votre extension est publiée dans une version stable. -La plupart des paquets JavaScript/CSS sont gérés par [Bower](http://bower.io/) et/ou [NPM](https://www.npmjs.org/), +La plupart des paquets JavaScript/CSS sont gérés par [Bower](http://bower.io/) et/ou [NPM](https://www.npmjs.com/), plutôt que par Composer. Yii utilise le [greffon *assets* de Composer(https://github.com/francoispluchino/composer-asset-plugin) pour activer la gestion de ce genre de paquets par Composer. Si votre extension dépend d'un paquet Bower, vous pouvez simplement lister la dépendance dans `composer.json` comme ceci : ```json diff --git a/docs/guide-ja/start-installation.md b/docs/guide-ja/start-installation.md index 0a53d4f84a..dc21601c32 100644 --- a/docs/guide-ja/start-installation.md +++ b/docs/guide-ja/start-installation.md @@ -114,7 +114,7 @@ composer create-project --prefer-dist yiisoft/yii2-app-basic basic アセットをインストールする -------------------------- -Yii は、アセット (CSS および JavaScript) ライブラリのインストールについて [Bower](http://bower.io/) および/または [NPM](https://www.npmjs.org/) のパッケージに依存しています。 +Yii は、アセット (CSS および JavaScript) ライブラリのインストールについて [Bower](http://bower.io/) および/または [NPM](https://www.npmjs.com/) のパッケージに依存しています。 Yii はこれらのライブラリを取得するのに Composer を使って、PHP と CSS/JavaScript のパッケージ・バージョンを同時に解決できるようにしています。 このことは、[asset-packagist.org](https://asset-packagist.org) または [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/) を使用することによって達成されます。 詳細は [アセットのドキュメント](structure-assets.md) を参照して下さい。 diff --git a/docs/guide-ja/structure-assets.md b/docs/guide-ja/structure-assets.md index f0f9083bb2..ae228da612 100644 --- a/docs/guide-ja/structure-assets.md +++ b/docs/guide-ja/structure-assets.md @@ -207,7 +207,7 @@ class FontAwesomeAsset extends AssetBundle ### Bower と NPM のアセットのインストール -ほとんどの JavaScript/CSS パッケージは、[Bower](http://bower.io/) および/または [NPM](https://www.npmjs.org/) によって管理されています。 +ほとんどの JavaScript/CSS パッケージは、[Bower](http://bower.io/) および/または [NPM](https://www.npmjs.com/) によって管理されています。 PHP の世界には PHP の依存を管理する Composer がありますが、PHP のパッケージと全く同じように `composer.json` を使って Bower のパッケージも NPM のパッケージもロードすることが可能です。 diff --git a/docs/guide-ja/structure-extensions.md b/docs/guide-ja/structure-extensions.md index 7de1c53809..8b01e6b7d7 100644 --- a/docs/guide-ja/structure-extensions.md +++ b/docs/guide-ja/structure-extensions.md @@ -184,7 +184,7 @@ Yii のアプリケーションは、このファイルによって、どんな それぞれの依存パッケージについて、適切なバージョン制約 (例えば `1.*` や `@stable`) を指定することも忘れてはなりません。 あなたのエクステンションを安定バージョンとしてリリースする場合は、安定した依存パッケージを使ってください。 -たいていの JavaScript/CSS パッケージは、Composer ではなく、[Bower](http://bower.io/) および/または [NPM](https://www.npmjs.org/) を使って管理されています。 +たいていの JavaScript/CSS パッケージは、Composer ではなく、[Bower](http://bower.io/) および/または [NPM](https://www.npmjs.com/) を使って管理されています。 Yii は [Composer アセット・プラグイン](https://github.com/francoispluchino/composer-asset-plugin) を使って、この種のパッケージを Composer によって管理することを可能にしています。 あなたのエクステンションが Bower パッケージに依存している場合でも、次のように、 `composer.json` に依存パッケージをリストアップすることが簡単に出来ます。 diff --git a/docs/guide-pt-BR/start-installation.md b/docs/guide-pt-BR/start-installation.md index c670e07f58..2c2db06fd8 100644 --- a/docs/guide-pt-BR/start-installation.md +++ b/docs/guide-pt-BR/start-installation.md @@ -120,7 +120,7 @@ No entanto, existem outras opções de instalação disponíveis: Instalando Recursos Estáticos (Assets) ----------------- -Yii utiliza os pacotes [Bower](http://bower.io/) e/ou [NPM](https://www.npmjs.org/) para a instalação das bibliotecas de recursos estáticos (CSS and JavaScript). +Yii utiliza os pacotes [Bower](http://bower.io/) e/ou [NPM](https://www.npmjs.com/) para a instalação das bibliotecas de recursos estáticos (CSS and JavaScript). Ele usa composer para obter essa bibliotecas, permitindo que versões de pacotes PHP, CSS e Javascrtip possam ser definidas/instaladas ao mesmo tempo. Isto é possível por usar ou [asset-packagist.org](https://asset-packagist.org) ou [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/). Por favor, consulta a [documentação sobre Assets](structure-assets.md) para mais detalhes. diff --git a/docs/guide-pt-BR/structure-assets.md b/docs/guide-pt-BR/structure-assets.md index 304e7f0950..7e187b3e76 100644 --- a/docs/guide-pt-BR/structure-assets.md +++ b/docs/guide-pt-BR/structure-assets.md @@ -257,7 +257,7 @@ publicação `beforeCopy`, apenas os subdiretórios `fonts` e `css` serão publi ### Assets do Bower e NPM A maioria dos pacotes JavaScript/CSS são gerenciados pelo [Bower](http://bower.io/) -e/ou [NPM](https://www.npmjs.org/). +e/ou [NPM](https://www.npmjs.com/). Se sua aplicação ou extensão estiver usando um destes pacotes, é recomendado que você siga os passos a seguir para gerenciar os assets na biblioteca: diff --git a/docs/guide-pt-BR/structure-extensions.md b/docs/guide-pt-BR/structure-extensions.md index 336099307d..1b88161594 100644 --- a/docs/guide-pt-BR/structure-extensions.md +++ b/docs/guide-pt-BR/structure-extensions.md @@ -220,7 +220,7 @@ para cada pacote dependente. Utilize dependências estáveis quando sua extensã estiver em uma versão estável. A maioria dos pacotes JavaScript/CSS são gerenciados pelo [Bower](http://bower.io/) -e/ou pelo [NPM](https://www.npmjs.org/), ao invés do Composer. O Yii usa o +e/ou pelo [NPM](https://www.npmjs.com/), ao invés do Composer. O Yii usa o [plugin de asset do Composer](https://github.com/francoispluchino/composer-asset-plugin) para habilitar a gerência destes tipos de pacotes através do Composer. Se sua extensão depender do pacote do Bower, você pode simplesmente listar a dependência diff --git a/docs/guide-ru/structure-assets.md b/docs/guide-ru/structure-assets.md index aa4c412f63..4a403721e2 100644 --- a/docs/guide-ru/structure-assets.md +++ b/docs/guide-ru/structure-assets.md @@ -166,7 +166,7 @@ class FontAwesomeAsset extends AssetBundle ### Установка ресурсов Bower и NPM -Большинство JavaScript/CSS пакетов управляются [Bower](http://bower.io/) и/или [NPM](https://www.npmjs.org/). +Большинство JavaScript/CSS пакетов управляются [Bower](http://bower.io/) и/или [NPM](https://www.npmjs.com/). В мире PHP мы испольуем Composer для управления зависимостями, но он не позволяет устанавливать пакеты Bower и NPM, просто указывая их в `composer.json`. Чтобы получить такую возможность, нужно немного настроить Composer. Существует два варианта: diff --git a/docs/guide-zh-CN/start-installation.md b/docs/guide-zh-CN/start-installation.md index 4144f8e2de..ac71dec474 100644 --- a/docs/guide-zh-CN/start-installation.md +++ b/docs/guide-zh-CN/start-installation.md @@ -114,7 +114,7 @@ composer create-project --prefer-dist yiisoft/yii2-app-basic basic 安装 Assets ----------- -Yii依靠 [Bower](http://bower.io/) 和/或 [NPM](https://www.npmjs.org/) 软件包来安装 asset(CSS 和 JavaScript)库。 +Yii依靠 [Bower](http://bower.io/) 和/或 [NPM](https://www.npmjs.com/) 软件包来安装 asset(CSS 和 JavaScript)库。 它使用Composer来获取这些库,允许 PHP 和 CSS/JavaScript 包版本同时解析。 这可以通过使用 [asset-packagist.org](https://asset-packagist.org) 或 [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/) 来实现。 有关更多详细信息,请参阅 [Assets 文档](structure-assets.md)。 diff --git a/docs/guide-zh-CN/structure-assets.md b/docs/guide-zh-CN/structure-assets.md index 822bebd277..016263ae83 100644 --- a/docs/guide-zh-CN/structure-assets.md +++ b/docs/guide-zh-CN/structure-assets.md @@ -207,7 +207,7 @@ class FontAwesomeAsset extends AssetBundle ### Bower 和 NPM 资源安装 -大多数 JavaScript/CSS 包使用 [Bower](http://bower.io/) 或 [NPM](https://www.npmjs.org/) 来管理。 +大多数 JavaScript/CSS 包使用 [Bower](http://bower.io/) 或 [NPM](https://www.npmjs.com/) 来管理。 在 PHP 中,我们用 Composer 来管理 PHP 依赖。像 PHP 包一样, 也可以使用 `composer.json` 管理 Bower 和 NPM 包。 diff --git a/docs/guide/start-installation.md b/docs/guide/start-installation.md index 7d14124edc..4c9b9a388b 100644 --- a/docs/guide/start-installation.md +++ b/docs/guide/start-installation.md @@ -114,7 +114,7 @@ But there are other installation options available: Installing Assets ----------------- -Yii relies on [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.org/) packages for the asset (CSS and JavaScript) libraries installation. +Yii relies on [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.com/) packages for the asset (CSS and JavaScript) libraries installation. It uses Composer to obtain these libraries, allowing PHP and CSS/JavaScript package versions to resolve at the same time. This can be achieved either by usage of [asset-packagist.org](https://asset-packagist.org) or [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/). Please refer to [Assets documentation](structure-assets.md) for more details. diff --git a/docs/guide/structure-assets.md b/docs/guide/structure-assets.md index 8f178c836c..85d4d9af7f 100644 --- a/docs/guide/structure-assets.md +++ b/docs/guide/structure-assets.md @@ -207,7 +207,7 @@ the `only` publishing option, only the `fonts` and `css` subdirectories will be ### Bower and NPM Assets installation -Most JavaScript/CSS packages are managed by [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.org/) package +Most JavaScript/CSS packages are managed by [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.com/) package managers. In PHP world we have Composer, that manages PHP dependencies, but it is possible to load both Bower and NPM packages using `composer.json` just as PHP packages. diff --git a/docs/guide/structure-extensions.md b/docs/guide/structure-extensions.md index a0f1095639..616f65b56f 100644 --- a/docs/guide/structure-extensions.md +++ b/docs/guide/structure-extensions.md @@ -184,7 +184,7 @@ If your extension also depends on other extensions or third-party libraries, you Make sure you also list appropriate version constraints (e.g. `1.*`, `@stable`) for each dependent package. Use stable dependencies when your extension is released in a stable version. -Most JavaScript/CSS packages are managed using [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.org/), +Most JavaScript/CSS packages are managed using [Bower](http://bower.io/) and/or [NPM](https://www.npmjs.com/), instead of Composer. Yii uses the [Composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin) to enable managing these kinds of packages through Composer. If your extension depends on a Bower package, you can simply list the dependency in `composer.json` like the following: