This repository has been archived by the owner on May 29, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Kate Jeffreys
committed
Oct 4, 2016
1 parent
5dcf341
commit d13b970
Showing
1 changed file
with
3 additions
and
74 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -74,79 +74,8 @@ Source: [github.com/Polymer/web-component-tester](https://github.com/Polymer/web | |
|
||
## Build and optimization {#build} | ||
|
||
This section lists commands used by the Polymer CLI command `polymer build`. | ||
You can use them directly if you need to customize your build process. | ||
This comment has been minimized.
Sorry, something went wrong. |
||
|
||
### <b>vulcanize</b>—optimize HTML Imports {#vulcanize} | ||
|
||
[vulcanize](https://github.com/polymer/vulcanize) is a tool for crushing an HTML Import file and its dependent HTML Imports into one file. Think of it as a build step for web components. Vulcanize reduces the number of requests made by your application by concatenating imports into a single file. | ||
|
||
Install: | ||
|
||
npm install -g vulcanize | ||
|
||
Usage (CLI): | ||
|
||
vulcanize --inline-scripts --inline-css --strip-comments \ | ||
elements.html > elements.build.html | ||
|
||
Vulcanize can be used from the CLI or ran programmatically from Node, `gulp-vulcanize`, or `grunt-vulcanize`. Read more about vulcanize in [Optimize for production](optimize-for-production). | ||
|
||
Source: [github.com/Polymer/vulcanize](https://github.com/Polymer/vulcanize) | ||
|
||
Related tools | ||
|
||
- [gulp-vulcanize](https://www.npmjs.com/package/gulp-vulcanize) | ||
- [grunt-vulcanize](https://www.npmjs.com/package/grunt-vulcanize) | ||
- [broccoli-vulcanize](https://www.npmjs.com/package/broccoli-vulcanize) | ||
|
||
### <b>crisper</b>—extract inline script from an HTML Import {#crisper} | ||
|
||
[crisper](https://github.com/PolymerLabs/crisper) is a tool for extracting inline scripts from an HTML file and splitting them into a separate file. This is useful for cases where you need CSP compliance. | ||
|
||
Install: | ||
|
||
npm install -g crisper | ||
|
||
Usage: | ||
|
||
crisper --html build.html --js build.js index.html | ||
|
||
Source: [github.com/PolymerLabs/crisper](https://github.com/PolymerLabs/crisper) | ||
|
||
Related tools | ||
|
||
- [gulp-crisper](https://www.npmjs.com/package/gulp-crisper) | ||
- [grunt-crisper](https://www.npmjs.com/package/grunt-crisper) | ||
|
||
### <b>polyclean</b>—minify JS/CSS/HTML {#polyclean} | ||
|
||
[polyclean](https://github.com/PolymerLabs/polyclean) provides basic Gulp plugins for minifying and cleaning JS, CSS, and HTML. | ||
|
||
Install: | ||
|
||
npm install -g polyclean | ||
|
||
Usage: | ||
|
||
vulcanize --inline-css --inline-scripts index.html | polyclean | ||
|
||
Source: [github.com/PolymerLabs/polyclean](https://github.com/PolymerLabs/polyclean) | ||
|
||
### <b>polybuild</b>—all-in-one build tool for optimizing apps {#polybuild} | ||
|
||
*Equivalent to Polymer CLI command `polymer build`.* | ||
|
||
[polybuild](https://github.com/PolymerLabs/polybuild) is an all-in-one build tool that combines vulcanize, crisper, and polyclean. Although less flexible than using the tools individually, polybuild is an easy solution if you want quick defaults. | ||
|
||
Install: | ||
|
||
npm install -g polybuild | ||
|
||
Usage: | ||
|
||
polybuild index.html --maximum-crush | ||
|
||
Source: [github.com/PolymerLabs/polybuild](https://github.com/PolymerLabs/polybuild) | ||
You can use `polymer-build` from the command line if you need to customize your build process. | ||
This comment has been minimized.
Sorry, something went wrong.
arthurevans
|
||
|
||
<a href="https://github.com/Polymer/polymer-build/blog/master/README.md" target="_blank">See the polymer-build README for instructions</a>. | ||
This comment has been minimized.
Sorry, something went wrong. |
||
|
||
Source: [github.com/Polymer/polymer-build](https://github.com/Polymer/polymer-build) |
Probably want to retain some form of this sentence...? Even just, "The Polymer CLI command
polymer build
uses the polymer-build library to build your project."