Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(2320)

Unified Diff: chrome/browser/resources/md_downloads/vulcanize_readme.md

Issue 1378993003: Vulcanize new Material Design downloads UI (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@vulcanize2
Patch Set: -crisper.html Created 5 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: chrome/browser/resources/md_downloads/vulcanize_readme.md
diff --git a/chrome/browser/resources/md_downloads/vulcanize_readme.md b/chrome/browser/resources/md_downloads/vulcanize_readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..858d6f06f8e6a51819c4581f43c959f1b3b00560
--- /dev/null
+++ b/chrome/browser/resources/md_downloads/vulcanize_readme.md
@@ -0,0 +1,44 @@
+# Vulcanizing Material Design downloads
+
+`vulcanize` is an npm module used to combine resources. In order to make the
+Material Design downloads page sufficiently fast, we run vulcanize on the source
+files to combine them and reduce blocking load/parse time.
+
+## Required software
+
+Vulcanization currently requires:
+- node.js: v0.10.25 (can be found with `node --version`)
+- npm: 1.3.10 (can be found with `npm --version`)
+- vulcanize: 1.12.3 (can be found with `vulcanize --version`)
+- crisper: 1.0.7 (can be found with `npm info crisper`)
+
+## Installing required software
+
+For instructions on installing node and npm, see
+[here](https://docs.npmjs.com/getting-started/installing-node).
+
+Once you've installed npm, you can get `crisper` and `vulcanize` via:
+
+```bash
+$ sudo npm install -g crisper vulcanize
+```
+
+## Combining resources with vulcanize
+
+To combine all the CSS/HTML/JS for the downloads page to make it production
+fast, you can run the commands:
+
+```bash
+$ chrome/browser/resources/md_downloads/vulcanize.py # from src/
+```
+
+This should overwrite the following files:
+
+- chrome/browser/resources/md_downloads/
+ - vulcanized.html (all <link rel=import> and stylesheets inlined)
+ - crisper.js (all JavaScript, extracted from vulcanized.html)
+
+## Testing downloads without vulcanizing
+
+If you're locally working on the downloads page, you can simply load this URL to
+bypass the vulcanized version: `chrome://downloads/dev.html`
« no previous file with comments | « chrome/browser/resources/md_downloads/vulcanize.py ('k') | chrome/browser/resources/md_downloads/vulcanized.html » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698