Building Polymer Docs Locally (for offline use)

[Joseph Dries III]

Hi,

So I started following the instructions at https://github.com/Polymer/docs to build a local copy of the docset — I'm going to be offline a lot over the next week, and I wanted to have a working set of documentation to really dig into Polymer.

However, I keep running into the following problems:

1. "git clone https://github.com/Polymer/docs.git --recursive" does not find the private-tools repo. I *think* that's OK, but it happens every time I try from scratch to build things.

2. vulcanize is not properly installed given the existing documentation, nor the .json dependency files. grunt-vulcanize is, but there's still an error that is thrown that vulcanize is not found. Doing a "sudo npm install -g vulcanize" fixes that error.

3. When I do a ./scripts/setup.sh, it errors out with the following problem:

Running "vulcanize:build" (vulcanize) task

Warning: ENOENT, no such file or directory '/Users/user/www/polymer-project.org/docs/components/core-icons/iconsets/social-icons.html' Use --force to continue.

Aborted due to warnings.

Any advice? I see that file is referenced in several index files, as well as several demo files. But I don't see where it originates from.

[Rob Dodson]

Unfortunately we're a little between updates at the moment so you'll need to checkout the perf branch to clear up any dependency issues:

$ git clone https://github.com/Polymer/docs.git --recursive
$ cd docs
$ git checkout perf
$ ./scripts/setup.sh
$ grunt

If all goes well you should be able to view the docs on localhost:3000. Also, make sure you're running Jekyll 2.0+ (you may need to run gem update jekyll or sudo gem update jekyll)

We should have the perf branch merged in soon but if you need the docs this instant, this is the easiest way to get them up and running. Hope that helps!

Follow Polymer on Google+: plus.google.com/107187849809354688692
---
You received this message because you are subscribed to the Google Groups "Polymer" group.
To unsubscribe from this group and stop receiving emails from it, send an email to polymer-dev...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/polymer-dev/455a4d6c-e362-469f-96eb-12b68d759fcc%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[ravinde...@gmail.com]

Hi Rob

 

I have problem with Building Polymer Docs Locally (for offline use), i followed same step's what are you given there but when i am typing "$ git checkout perf ",     It showing a error it's  "error: pathspec 'perf' did not match any file(s) known to git."  

I installed the dependencies also like ---> Git --->Bower 

I will be grateful for any help you can provide 

Thankyou

Ravinder

[Rob Dodson]

This is a pretty old thread. You don't need to check out perf anymore, just checkout master.

Follow Polymer on Google+: plus.google.com/107187849809354688692

---
You received this message because you are subscribed to the Google Groups "Polymer" group.
To unsubscribe from this group and stop receiving emails from it, send an email to polymer-dev...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/polymer-dev/f95b711f-1cc6-4a6a-9be6-b679f9df8f71%40googlegroups.com.

[ravinde...@gmail.com]

Hi Rob 

Thank you so much for responding my request so quickly, I just did what you said "It worked...!"  but, i got another issue with 

 " ./scripts/setup.sh"  when i typed this cmd it show pop window with name of " unlock password "

In that window it say's like " an application want access to private key 'ravinde...@gmail.com' but  it's locked " , I got same issue while i am try to installed  bower app, I didn't get app trying to say 

can you help me out to solve this problem too

Thankyou & regards 

Ravinder

 

[Rob Dodson]

are you on mac or windows? If you're on a mac it may require you to type your system password to run npm install, same goes for bower

Follow Polymer on Google+: plus.google.com/107187849809354688692

---
You received this message because you are subscribed to the Google Groups "Polymer" group.
To unsubscribe from this group and stop receiving emails from it, send an email to polymer-dev...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/polymer-dev/0af2f2f7-b45f-441a-a54a-39c198add4fa%40googlegroups.com.

[Eric Bidelman]

BTW, the instructions in the docs/ README should be up to date. If you follow those, it should get you up and running.

To view this discussion on the web visit https://groups.google.com/d/msgid/polymer-dev/CAJj5OwBdrNL5vWHPs2yVm5gZQvOmZidHJzmP7QCO5cmz-Mi6yA%40mail.gmail.com.