Cheng-Yu Hsu created ZEPPELIN-813:
-------------------------------------
Summary: Update docs site dependencies
Key: ZEPPELIN-813
URL: https://issues.apache.org/jira/browse/ZEPPELIN-813
Project: Zeppelin
Issue Type: Improvement
Components: documentation
Affects Versions: 0.5.6, 0.5.5, 0.5.0, 0.6.0
Environment: Ruby 2.3.0p0 on Mac OS X 10.11.4
Reporter: Cheng-Yu Hsu
Priority: Minor
Fix For: 0.6.0
Hi,
I encountered some problems when trying to start the server for the docs (under
`./docs`).
```
$ bundle exec jekyll serve --watch
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/user_interaction.rb:328:
warning: constant ::TimeoutError is deprecated
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:365:in
`block in require_program': program version required
(Commander::Runner::CommandError)
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:364:in
`each'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:364:in
`require_program'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:52:in
`run!'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/delegates.rb:7:in
`run!'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/import.rb:10:in
`block in <top (required)>'
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml/syck_node_monkeypatch.rb:42:in
`<top (required)>': uninitialized constant Syck (NameError)
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:200:in
`require'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:200:in
`<module:YAML>'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:132:in
`<top (required)>'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/lib/jekyll.rb:21:in
`require'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/lib/jekyll.rb:21:in
`<top (required)>'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/bin/jekyll:7:in
`require'
from
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/bin/jekyll:7:in
`<top (required)>'
from /Users/cyhsutw/.rbenv/versions/2.3.0/bin/jekyll:23:in `load'
from /Users/cyhsutw/.rbenv/versions/2.3.0/bin/jekyll:23:in `<main>'
```
After analyizing the error, I found the issue was related to `safe_yaml` gem
(`uninitialized constant Syck (NameError)`).
According to the [documentation of Ruby
`stdlib`](http://ruby-doc.org/stdlib-2.2.2/libdoc/yaml/rdoc/YAML.html#module-YAML-label-History),
`Syck` is deprecated in `1.9.0` and is removed in `2.0.0`.
The maintainers of `safe_yaml` have
[fixed](https://github.com/dtao/safe_yaml/commit/26c235da7ad0529fe3aaa5a023503138cf8cf7c9)
this and it's backward compatible with older Ruby using `Syck`.
One solution to this issue is updating the `safe_yaml` gem.
Another solution is updating the `github-pages` gem to the latest version `69`,
which requires the `safe_yaml` gem to have version `1.0.4`.
Personally, I'd like to have the dependencies up-to-date if there's no
compatibility issues.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
