812
Comment:
|
1259
|
Deletions are marked like this. | Additions are marked like this. |
Line 9: | Line 9: |
== Adding new YUI3 JavaScript modules == | == Adding new JavaScript modules == |
Line 11: | Line 11: |
A special script, `utilities/yui_deps.py`, looks in the main site template for `<script>` lines that point to YUI3. The corresponding minified script files are extracted from the current YUI3 build and added to `launchpad.js`. | To add a new JavaScript module simply add a new `<script>` line to `lib/lp/app/templates/base-layout-macros.pt` in the large `<devmode>` JavaScript block. The file you add to the list will be automatically included in the `launchpad.js` roll-up and used by both the test runner and the LP production site. |
Line 13: | Line 13: |
To add a new YUI3 dependency, just add a new `<script>` line to the main site template. | Two special scripts, `utilities/yui_deps.py` and `utilities/lp-deps.py`, look in `lib/lp/app/templates/base-layout-macros.pt` for `<script>` lines. The corresponding minified script files (the version of the file ending with "-min.js") will be added to `launchpad.js`. After making your changes you will probably want to run: {{{ $ make clean_js && make jsbuild }}} |
Line 19: | Line 24: |
After making your changes you will probably want to run: {{{ $ make css_combine }}} |
The Launchpad JavaScript Build System
Most of the Launchpad JavaScript is bundled, minified, and distributed in one large stand-alone file: launchpad.js.
Adding new JavaScript modules
To add a new JavaScript module simply add a new <script> line to lib/lp/app/templates/base-layout-macros.pt in the large <devmode> JavaScript block. The file you add to the list will be automatically included in the launchpad.js roll-up and used by both the test runner and the LP production site.
Two special scripts, utilities/yui_deps.py and utilities/lp-deps.py, look in lib/lp/app/templates/base-layout-macros.pt for <script> lines. The corresponding minified script files (the version of the file ending with "-min.js") will be added to launchpad.js.
After making your changes you will probably want to run:
$ make clean_js && make jsbuild
Adding a new CSS file
Launchpad combines and minifies all of its CSS files into 'combo.css' before publishing them. You can add a new CSS file to the list by editing buildout-templates/bin/combine-css.in
After making your changes you will probably want to run:
$ make css_combine