Added an article explaining how to use Bower in Symfony #5159

wouterj · 2015-04-08T17:38:30Z

Q	A
Doc fix?	no
New docs?	yes
Applies to	all
Fixed tickets	-

The documentation was only documenting Assetic to manage assets. I feel like the community is moving away from Assetic and is starting to use tools like Bower, Gulp, Grunt, etc. This first article starts at documenting how to work with these tools within your Symfony application.

cordoval · 2015-04-08T18:32:33Z

cookbook/frontend/bower.rst

+
+.. tip::
+
+    If you don't want to have NodeJS on your computer, you can also BowerPHP_


can also use/install

cordoval · 2015-04-08T18:39:59Z

good job overall 👍 @wouterj , looking forward to Gulp and the other articles

javiereguiluz · 2015-04-08T19:47:48Z

cookbook/frontend/bower.rst

+========================
+
+Symfony and all its packages are perfectly managed by Composer. Bower is a
+dependency management tool for front-end dependencies, like Twitter Bootstrap


They no longer call it Twitter Bootstrap but just Bootstrap

wouterj · 2015-04-08T20:06:20Z

Thanks @cordoval and @javiereguiluz! I've applied almost all of your comments

cordoval · 2015-04-08T20:09:34Z

👍

rvanlaak · 2015-04-10T07:13:31Z

👍

Another helpfull note to ease the dependency deployment process would be to add the bower install command to the composer.json file scripts section:

    "scripts": {
        "post-install-cmd": [
            "bower install"
        ],
        "post-update-cmd": [
            "bower install"
        ]
    },

xabbuh · 2015-04-11T10:10:26Z

cookbook/frontend/bower.rst

+    an alpha state. If you're using BowerPHP, use ``bowerphp`` instead of
+    ``bower`` in the examples.
+
+Configuring Bower in your Project


I don't think so, see #5155 (comment)

Zeichen32 · 2015-04-13T19:56:49Z

There is also a very nice composer plugin, which does not require bower or npm to receive assets:
https://github.com/francoispluchino/composer-asset-plugin

wouterj · 2015-04-13T20:55:10Z

Thanks for your comment @Zeichen32! However, I hate using Composer for anything other than PHP packages. So if anything, I wouldn't write something that recommends that :) The main point of all these different package managers is because they have another repository backend.

javiereguiluz · 2015-04-13T21:00:26Z

@Zeichen32 thanks for your proposal. Don't worry about @wouterj's comment. I think he's right, because this article about Bower uses "pure JavaScript stuff". However, soon there will be another article (see #5166) which will use "pure PHP stuff". I'll gladly add a note about the project you mention that allows us to not touch JavaScript for anything!

Zeichen32 · 2015-04-13T21:44:13Z

@javiereguiluz You're right, i did not notice the other article. 😉

weaverryan · 2015-05-03T21:51:22Z

cookbook/frontend/bower.rst

+Installing Bower
+----------------
+
+Bower_ is built on top of NodeJS_. Make sure you have that installed and


It seems like Node.js seems to be the normal way to write it?

👍 it's even what they use on their project's site

weaverryan · 2015-05-03T22:08:44Z

@wouterj I like the initiative!

aitboudad · 2015-05-11T17:37:11Z

👍

wouterj · 2015-05-23T08:34:27Z

Thanks @weaverryan for your review. I've updated the article.

xabbuh · 2015-05-23T08:38:47Z

cookbook/frontend/bower.rst

+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To create a ``bower.json`` file, just run ``bower init``. Now you're ready to
+start adding things to your project. For example, to add `Bootstrap`_ to your


The referenced URL at the end of the document is missing.

cordoval · 2015-05-23T09:55:11Z

one of the things I have noticed lately is the move out of bower to npm. I don't think bower should be recommended anymore since unless you lock via sha1's this will could just be as unstable for things on production. npm however has shrinkwrap which will ensure things get locked rightly. So I would say to add a note about this to really address things the right way. The situation in the js world is as if there were two composers. One with more right to claim package management already in this case npm. Of course you need to install node for both anyways so I wonder what is the point of using bower.

wouterj · 2015-05-23T09:57:11Z

Npm is created for Node.js development, with all kind of extra features for Node.js. Bower on the other hand is written in Node.js, but created specifically for managing front-end packages, with all kind of features that are related to this.

Npm for instance downloads the complete package, including all build files, source, etc. Bower will only install things that are really needed, like the dist files. This means that when using npm, you also need to create a build script to only move the needed dist files to the web/assets/ directory.

I'm a big -1 on recommending npm instead of bower.

cordoval · 2015-05-23T09:59:52Z

I would agree with you were it not the case that npm is already installed. It is imo like recommending a wrong practice [to install more stuff than needed]. I have also seen lots of packages migrating to the right npm package managing, though not all. Also there is a PR in bower trying to do the lock which is not merged so big disadvantage. And you are bypassing the stability that a lock feature begs for which is desired to make the frontend truly stable for production. Otherwise everytime you run bower install you could be getting new stuff even on production. But your choice 👴

… (WouterJ) This PR was merged into the 2.3 branch. Discussion ---------- Added an article explaining how to use Bower in Symfony | Q | A | --- | --- | Doc fix? | no | New docs? | yes | Applies to | all | Fixed tickets | - The documentation was only documenting Assetic to manage assets. I feel like the community is moving away from Assetic and is starting to use tools like Bower, Gulp, Grunt, etc. This first article starts at documenting how to work with these tools within your Symfony application. Commits ------- d34b772 Created Bower article

weaverryan · 2015-05-23T13:04:25Z

Merged! I think this is an easy win because people can easily find this article, but it's short and avoids any major maintenance of duplication. I would like to see more articles like this that answer a question a user has, even if the answer is simply pointing them to another tool(s) to use.

About npm versus bower, Wouter explained it perfectly. Here is the SO explaining it: http://stackoverflow.com/questions/18641899/what-is-the-difference-between-bower-and-npm#answers-header

But, I did open #5294, which discusses the problem if having no lock file (currently) for Bower.

Thanks!

…eaverryan) This PR was merged into the 2.3 branch. Discussion ---------- Tweaks to bower entry - specifically committing deps | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no | Applies to | 2.3+ | Fixed tickets | n/a This follows after #5159. The biggest addition is a short conversation about committing Bower assets. Thanks! Commits ------- 7f4b55e Many tweaks thanks to the team! d526765 Small tweaks, but mostly adding a section about committing Bower assets

@wouterj

…ith Assetic (javiereguiluz) This PR was merged into the 2.3 branch. Discussion ---------- Proposed a new article about using pure PHP libraries with Assetic | Q | A | ------------- | --- | Doc fix? | no | New docs? | yes | Applies to | all | Fixed tickets | - In #5159 @wouterj proposes to create a new Cookbook section dedicated to frontend articles. I think it's a great idea and in this pull request I propose an article showing how to use pure PHP libraries to combine, compile and minimize CSS, SCSS and JS files. Commits ------- f5c4d93 Fixed an indentation problem 4b8b3fb Moved the article back to the Assetic section 07087dd Avoid the ugly double back slashes 85e6a54 Added more configuration formats bc6ffbe Rewords and code improvements 3ea9c86 Fixed some typos and grammar issues 1f6e16c Minor fixes cc5b630 Reworded some wrong statements 044cd73 The file extension is not needed 14d0346 Fixed the Twig lexer name 798b5b5 Added the missin index file 86da338 Proposed a new article about using pure PHP libraries with Assetic

wouterj added the Status: Needs Work label Apr 8, 2015

wouterj force-pushed the frontend branch 2 times, most recently from 2d28844 to 38a11f6 Compare April 8, 2015 17:59

cordoval reviewed Apr 8, 2015
View reviewed changes

javiereguiluz reviewed Apr 8, 2015
View reviewed changes

wouterj force-pushed the frontend branch from 38a11f6 to 6cc1f3e Compare April 8, 2015 20:05

wouterj added Status: Reviewed and removed Status: Needs Work labels Apr 8, 2015

javiereguiluz mentioned this pull request Apr 10, 2015

Proposed a new article about using pure PHP libraries with Assetic #5166

Merged

xabbuh reviewed Apr 11, 2015
View reviewed changes

wouterj force-pushed the frontend branch from 6cc1f3e to 4febc8e Compare April 13, 2015 09:56

weaverryan reviewed May 3, 2015
View reviewed changes

weaverryan added Status: Needs Work and removed Status: Reviewed labels May 3, 2015

wouterj force-pushed the frontend branch from 4febc8e to c84f007 Compare May 23, 2015 08:33

wouterj added Status: Reviewed and removed Status: Needs Work labels May 23, 2015

xabbuh reviewed May 23, 2015
View reviewed changes

Created Bower article

d34b772

wouterj force-pushed the frontend branch from c84f007 to d34b772 Compare May 23, 2015 08:39

weaverryan merged commit d34b772 into symfony:2.3 May 23, 2015

weaverryan mentioned this pull request May 23, 2015

Tweaks to bower entry - specifically committing deps #5294

Merged

wouterj deleted the frontend branch May 23, 2015 14:54

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added an article explaining how to use Bower in Symfony #5159

Added an article explaining how to use Bower in Symfony #5159

wouterj commented Apr 8, 2015

cordoval Apr 8, 2015

cordoval commented Apr 8, 2015

javiereguiluz Apr 8, 2015

wouterj commented Apr 8, 2015

cordoval commented Apr 8, 2015

rvanlaak commented Apr 10, 2015

xabbuh Apr 11, 2015

wouterj Apr 13, 2015

Zeichen32 commented Apr 13, 2015

wouterj commented Apr 13, 2015

javiereguiluz commented Apr 13, 2015

Zeichen32 commented Apr 13, 2015

weaverryan May 3, 2015

xabbuh May 4, 2015

weaverryan commented May 3, 2015

aitboudad commented May 11, 2015

wouterj commented May 23, 2015

xabbuh May 23, 2015

wouterj May 23, 2015

cordoval commented May 23, 2015

wouterj commented May 23, 2015

cordoval commented May 23, 2015

weaverryan commented May 23, 2015


		.. tip::

		If you don't want to have NodeJS on your computer, you can also BowerPHP_

Added an article explaining how to use Bower in Symfony #5159

Added an article explaining how to use Bower in Symfony #5159

Conversation

wouterj commented Apr 8, 2015

Choose a reason for hiding this comment

cordoval commented Apr 8, 2015

Choose a reason for hiding this comment

wouterj commented Apr 8, 2015

cordoval commented Apr 8, 2015

rvanlaak commented Apr 10, 2015

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Zeichen32 commented Apr 13, 2015

wouterj commented Apr 13, 2015

javiereguiluz commented Apr 13, 2015

Zeichen32 commented Apr 13, 2015

Choose a reason for hiding this comment

Choose a reason for hiding this comment

weaverryan commented May 3, 2015

aitboudad commented May 11, 2015

wouterj commented May 23, 2015

Choose a reason for hiding this comment

Choose a reason for hiding this comment

cordoval commented May 23, 2015

wouterj commented May 23, 2015

cordoval commented May 23, 2015

weaverryan commented May 23, 2015