You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@spark.apache.org by DB Tsai <db...@dbtsai.com> on 2014/04/23 08:26:01 UTC
Jekyll documentation generation error
Hi guys,
I'm trying to update LBFGS documentation so I need to generate html
document to see if everything looks great. However, mv I get the following
error.
Conversion error: There was an error converting 'docs/cluster-overview.md'.
error: MaRuKu encountered problem(s) while converting your markup.. Use
--trace to view backtrace
I'm using ruby 2.1.1p76 and jekyll 1.5.1 installed by gem as instruction.
Do I miss anything?
Also, in the instruction, if we want to skip the api docs, we can do the
following.
# Skip generating API docs (which takes a while)
$ SKIP_SCALADOC=1 jekyll build
But what does"SKIP_SCALADOC=1" mean? export SKIP_SCALADOC=1?
Thanks.
Sincerely,
DB Tsai
-------------------------------------------------------
My Blog: https://www.dbtsai.com
LinkedIn: https://www.linkedin.com/in/dbtsai
Re: Jekyll documentation generation error
Posted by DB Tsai <db...@dbtsai.com>.
Matei, thanks. It works with kramdown.
Sincerely,
DB Tsai
-------------------------------------------------------
My Blog: https://www.dbtsai.com
LinkedIn: https://www.linkedin.com/in/dbtsai
On Tue, Apr 22, 2014 at 11:38 PM, Matei Zaharia <ma...@gmail.com>wrote:
> Try doing “gem install kramdown”. The maruku gem for Markdown throws these
> errors, but Kramdown doesn’t.
>
> Matei
>
> On Apr 22, 2014, at 11:31 PM, DB Tsai <db...@dbtsai.com> wrote:
>
> > This is the trace.
> >
> > Conversion error: There was an error converting 'docs/
> cluster-overview.md
> > '.
> >
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:45:in
> > `print_errors_and_fail': MaRuKu encountered problem(s) while converting
> > your markup. (MaRuKu::Exception)
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:50:in
> > `convert'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown.rb:39:in
> > `convert'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:57:in
> > `transform'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:153:in
> > `do_layout'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/page.rb:115:in
> > `render'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:239:in
> > `block in render'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
> > `each'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
> > `render'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:39:in
> > `process'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/command.rb:18:in
> > `process_site'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:23:in
> > `build'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:7:in
> > `process'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/bin/jekyll:77:in
> > `block (2 levels) in <top (required)>'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
> > `call'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
> > `call'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:155:in
> > `run'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:422:in
> > `run_active_command'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:82:in
> > `run!'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/delegates.rb:8:in
> > `run!'
> >
> > from
> >
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/import.rb:10:in
> > `block in <top (required)>'
> >
> >
> > Sincerely,
> >
> > DB Tsai
> > -------------------------------------------------------
> > My Blog: https://www.dbtsai.com
> > LinkedIn: https://www.linkedin.com/in/dbtsai
> >
> >
> > On Tue, Apr 22, 2014 at 11:26 PM, DB Tsai <db...@dbtsai.com> wrote:
> >
> >> Hi guys,
> >>
> >> I'm trying to update LBFGS documentation so I need to generate html
> >> document to see if everything looks great. However, mv I get the
> following
> >> error.
> >>
> >> Conversion error: There was an error converting 'docs/
> cluster-overview.md
> >> '.
> >> error: MaRuKu encountered problem(s) while converting your markup.. Use
> >> --trace to view backtrace
> >>
> >>
> >> I'm using ruby 2.1.1p76 and jekyll 1.5.1 installed by gem as
> instruction.
> >> Do I miss anything?
> >>
> >> Also, in the instruction, if we want to skip the api docs, we can do the
> >> following.
> >>
> >> # Skip generating API docs (which takes a while)
> >> $ SKIP_SCALADOC=1 jekyll build
> >>
> >> But what does"SKIP_SCALADOC=1" mean? export SKIP_SCALADOC=1?
> >>
> >> Thanks.
> >>
> >>
> >>
> >>
> >> Sincerely,
> >>
> >> DB Tsai
> >> -------------------------------------------------------
> >> My Blog: https://www.dbtsai.com
> >> LinkedIn: https://www.linkedin.com/in/dbtsai
> >>
>
>
Re: Jekyll documentation generation error
Posted by Matei Zaharia <ma...@gmail.com>.
Try doing “gem install kramdown”. The maruku gem for Markdown throws these errors, but Kramdown doesn’t.
Matei
On Apr 22, 2014, at 11:31 PM, DB Tsai <db...@dbtsai.com> wrote:
> This is the trace.
>
> Conversion error: There was an error converting 'docs/cluster-overview.md
> '.
>
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:45:in
> `print_errors_and_fail': MaRuKu encountered problem(s) while converting
> your markup. (MaRuKu::Exception)
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:50:in
> `convert'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown.rb:39:in
> `convert'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:57:in
> `transform'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:153:in
> `do_layout'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/page.rb:115:in
> `render'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:239:in
> `block in render'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
> `each'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
> `render'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:39:in
> `process'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/command.rb:18:in
> `process_site'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:23:in
> `build'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:7:in
> `process'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/bin/jekyll:77:in
> `block (2 levels) in <top (required)>'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
> `call'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
> `call'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:155:in
> `run'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:422:in
> `run_active_command'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:82:in
> `run!'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/delegates.rb:8:in
> `run!'
>
> from
> /Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/import.rb:10:in
> `block in <top (required)>'
>
>
> Sincerely,
>
> DB Tsai
> -------------------------------------------------------
> My Blog: https://www.dbtsai.com
> LinkedIn: https://www.linkedin.com/in/dbtsai
>
>
> On Tue, Apr 22, 2014 at 11:26 PM, DB Tsai <db...@dbtsai.com> wrote:
>
>> Hi guys,
>>
>> I'm trying to update LBFGS documentation so I need to generate html
>> document to see if everything looks great. However, mv I get the following
>> error.
>>
>> Conversion error: There was an error converting 'docs/cluster-overview.md
>> '.
>> error: MaRuKu encountered problem(s) while converting your markup.. Use
>> --trace to view backtrace
>>
>>
>> I'm using ruby 2.1.1p76 and jekyll 1.5.1 installed by gem as instruction.
>> Do I miss anything?
>>
>> Also, in the instruction, if we want to skip the api docs, we can do the
>> following.
>>
>> # Skip generating API docs (which takes a while)
>> $ SKIP_SCALADOC=1 jekyll build
>>
>> But what does"SKIP_SCALADOC=1" mean? export SKIP_SCALADOC=1?
>>
>> Thanks.
>>
>>
>>
>>
>> Sincerely,
>>
>> DB Tsai
>> -------------------------------------------------------
>> My Blog: https://www.dbtsai.com
>> LinkedIn: https://www.linkedin.com/in/dbtsai
>>
Re: Jekyll documentation generation error
Posted by DB Tsai <db...@dbtsai.com>.
This is the trace.
Conversion error: There was an error converting 'docs/cluster-overview.md
'.
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:45:in
`print_errors_and_fail': MaRuKu encountered problem(s) while converting
your markup. (MaRuKu::Exception)
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown/maruku_parser.rb:50:in
`convert'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/converters/markdown.rb:39:in
`convert'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:57:in
`transform'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/convertible.rb:153:in
`do_layout'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/page.rb:115:in
`render'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:239:in
`block in render'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
`each'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:238:in
`render'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/site.rb:39:in
`process'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/command.rb:18:in
`process_site'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:23:in
`build'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/lib/jekyll/commands/build.rb:7:in
`process'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/jekyll-1.5.1/bin/jekyll:77:in
`block (2 levels) in <top (required)>'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
`call'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:180:in
`call'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/command.rb:155:in
`run'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:422:in
`run_active_command'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/runner.rb:82:in
`run!'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/delegates.rb:8:in
`run!'
from
/Users/dbtsai/.rbenv/versions/2.1.1/lib/ruby/gems/2.1.0/gems/commander-4.1.6/lib/commander/import.rb:10:in
`block in <top (required)>'
Sincerely,
DB Tsai
-------------------------------------------------------
My Blog: https://www.dbtsai.com
LinkedIn: https://www.linkedin.com/in/dbtsai
On Tue, Apr 22, 2014 at 11:26 PM, DB Tsai <db...@dbtsai.com> wrote:
> Hi guys,
>
> I'm trying to update LBFGS documentation so I need to generate html
> document to see if everything looks great. However, mv I get the following
> error.
>
> Conversion error: There was an error converting 'docs/cluster-overview.md
> '.
> error: MaRuKu encountered problem(s) while converting your markup.. Use
> --trace to view backtrace
>
>
> I'm using ruby 2.1.1p76 and jekyll 1.5.1 installed by gem as instruction.
> Do I miss anything?
>
> Also, in the instruction, if we want to skip the api docs, we can do the
> following.
>
> # Skip generating API docs (which takes a while)
> $ SKIP_SCALADOC=1 jekyll build
>
> But what does"SKIP_SCALADOC=1" mean? export SKIP_SCALADOC=1?
>
> Thanks.
>
>
>
>
> Sincerely,
>
> DB Tsai
> -------------------------------------------------------
> My Blog: https://www.dbtsai.com
> LinkedIn: https://www.linkedin.com/in/dbtsai
>