You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by Doug Turnbull <dt...@opensourceconnections.com> on 2017/12/02 02:17:32 UTC
Solr Ref Guide not building
Hello!
I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
believe I've installed the required dependencies and double checked the
README in the solr-ref-guide. Unfortunately, running ant build-site I
immediately get this error, seemingly on the first adoc file encountered:
[exec] jekyll 3.5.0 | Error: No header received back.
[exec] Conversion error: Jekyll::AsciiDoc::Converter encountered an
error while converting 'about-filters.adoc':
I feel like I must be doing something stupid (I'll assume user error on my
part). But if there's anything obvious I'm doing wrong, please let me know
A more complete log can be found here
https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
Thanks for any help
-Doug
--
Consultant, OpenSource Connections. Contact info at
http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
Re: Solr Ref Guide not building
Posted by Doug Turnbull <dt...@opensourceconnections.com>.
For building HTML, the ref guide specifies the following. Here's what I
have with corresponding versions
** Prerequisites: `Ruby` (v2.1 or higher) and the following gems must be
installed:
doug@wiz$~/ws/lucene-solr/solr/solr-ref-guide(mas) $ ruby --version
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-darwin16]
*** `jekyll`: v3.5, not v4.x. Use `gem install --force --version 3.5.0
jekyll` to force install of Jekyll 3.5.0.
*** `jekyll-asciidoc`: v2.1 or higher. Use `gem install jekyll-asciidoc` to
install.
doug@wiz$~/ws/lucene-solr/solr/solr-ref-guide(mas) $ gem list | grep jekyll
jekyll (3.5.0, 3.0.3)
jekyll-asciidoc (2.1.0)
*** `pygments.rb`: v1.1.2 or higher. Use `gem install pygments.rb` to
install.
doug@wiz$~/ws/lucene-solr/solr/solr-ref-guide(mas) $ gem list | grep
pygments
pygments.rb (1.2.0)
Then I follow the instructions in "Building the Guide"
== Building the Guide
For details on building the ref guide, see `ant -p`.
There are currently four available targets:
* `ant default`: builds both the PDF and HTML versions of the Solr Ref
Guide.
* `ant build-site`: builds only the HTML version.
And run "ant build-site" and get the output from my original email
Thanks,
-Doug
On Sat, Dec 2, 2017 at 1:16 PM Ishan Chattopadhyaya <
ichattopadhyaya@gmail.com> wrote:
> I'm facing some errors building the ref-guide as well:
>
> -build-raw-pdf:
> [asciidoctor:convert] Render SolrRefGuide-all.adoc from
> /home/ishan/code/lucene-solr/solr/build/solr-ref-guide/content/pdf to
> /home/ishan/code/lucene-solr/solr/build/solr-ref-guide/pdf-tmp with
> backend=pdf
> [asciidoctor:convert] asciidoctor: ERROR: about-this-guide.adoc: line 1:
> invalid part, must have at least one section (e.g., chapter, appendix, etc.)
> [asciidoctor:convert] asciidoctor: ERROR: solr-glossary.adoc: line 1:
> invalid part, must have at least one section (e.g., chapter, appendix, etc.)
>
>
> On Sat, Dec 2, 2017 at 11:42 PM, Doug Turnbull <
> dturnbull@opensourceconnections.com> wrote:
>
>> Thanks.
>>
>> I don’t mind poking around the ref guide config, but I'm following the
>> readme and building master. I'm hesitant to change config files as part of
>> my PR, which probably will break the ref guide build for others :)
>>
>> Best
>> -Doug
>>
>>
>> On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com> wrote:
>>
>>>
>>> MG>see below
>>>
>>>
>>> ------------------------------
>>> *From:* Doug Turnbull <dt...@opensourceconnections.com>
>>> *Sent:* Friday, December 1, 2017 9:17 PM
>>> *To:* dev@lucene.apache.org
>>> *Subject:* Solr Ref Guide not building
>>>
>>> Hello!
>>>
>>> I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
>>> believe I've installed the required dependencies and double checked the
>>> README in the solr-ref-guide. Unfortunately, running ant build-site I
>>> immediately get this error, seemingly on the first adoc file encountered:
>>>
>>>
>>> [exec] jekyll 3.5.0 | Error: No header received back.
>>> [exec] Conversion error: Jekyll::AsciiDoc::Converter encountered
>>> an error while converting 'about-filters.adoc':
>>> MG>possible ant build snafu
>>> MG>configuration file:
>>> /Users/doug/ws/lucene-solr/solr/build/solr-ref-guide/content/_config.yml
>>> MG>Deprecation: The 'gems' configuration option has been renamed to
>>> 'plugins'.
>>> MG>Please update your config file accordingly.
>>> MG>check output config.yml for 'gems' and sub in 'plugins'
>>> MG>also check ant input solr-ref-guide/config.yml.template for 'gems'
>>> instead of 'plugins'
>>>
>>> I feel like I must be doing something stupid (I'll assume user error on
>>> my part). But if there's anything obvious I'm doing wrong, please let me
>>> know
>>>
>>> A more complete log can be found here
>>> https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
>>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>>> doug-being-dumb.txt
>>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>>> gist.github.com
>>>
>>>
>>> Thanks for any help
>>>
>>> -Doug
>>> --
>>> Consultant, OpenSource Connections. Contact info at
>>> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
>>> http://bit.ly/dougs_cal)
>>> <http://o19s.com/about-us/doug-turnbull/>
>>> Doug Turnbull <http://o19s.com/about-us/doug-turnbull/>
>>> o19s.com
>>> Search relevance consultant. Author of Relevant Search. Doug crafts
>>> search/recommendation solutions that “get” users. To do this, Doug uses
>>> Solr/Elasticsearc...
>>>
>>> --
>> Consultant, OpenSource Connections. Contact info at
>> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
>> http://bit.ly/dougs_cal)
>>
>
> --
Consultant, OpenSource Connections. Contact info at
http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
Re: Solr Ref Guide not building
Posted by Ishan Chattopadhyaya <ic...@gmail.com>.
I'm facing some errors building the ref-guide as well:
-build-raw-pdf:
[asciidoctor:convert] Render SolrRefGuide-all.adoc from
/home/ishan/code/lucene-solr/solr/build/solr-ref-guide/content/pdf to
/home/ishan/code/lucene-solr/solr/build/solr-ref-guide/pdf-tmp with
backend=pdf
[asciidoctor:convert] asciidoctor: ERROR: about-this-guide.adoc: line 1:
invalid part, must have at least one section (e.g., chapter, appendix, etc.)
[asciidoctor:convert] asciidoctor: ERROR: solr-glossary.adoc: line 1:
invalid part, must have at least one section (e.g., chapter, appendix, etc.)
On Sat, Dec 2, 2017 at 11:42 PM, Doug Turnbull <
dturnbull@opensourceconnections.com> wrote:
> Thanks.
>
> I don’t mind poking around the ref guide config, but I'm following the
> readme and building master. I'm hesitant to change config files as part of
> my PR, which probably will break the ref guide build for others :)
>
> Best
> -Doug
>
>
> On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com> wrote:
>
>>
>> MG>see below
>>
>>
>> ------------------------------
>> *From:* Doug Turnbull <dt...@opensourceconnections.com>
>> *Sent:* Friday, December 1, 2017 9:17 PM
>> *To:* dev@lucene.apache.org
>> *Subject:* Solr Ref Guide not building
>>
>> Hello!
>>
>> I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
>> believe I've installed the required dependencies and double checked the
>> README in the solr-ref-guide. Unfortunately, running ant build-site I
>> immediately get this error, seemingly on the first adoc file encountered:
>>
>>
>> [exec] jekyll 3.5.0 | Error: No header received back.
>> [exec] Conversion error: Jekyll::AsciiDoc::Converter encountered
>> an error while converting 'about-filters.adoc':
>> MG>possible ant build snafu
>> MG>configuration file: /Users/doug/ws/lucene-solr/
>> solr/build/solr-ref-guide/content/_config.yml
>> MG>Deprecation: The 'gems' configuration option has been renamed to
>> 'plugins'.
>> MG>Please update your config file accordingly.
>> MG>check output config.yml for 'gems' and sub in 'plugins'
>> MG>also check ant input solr-ref-guide/config.yml.template for 'gems'
>> instead of 'plugins'
>>
>> I feel like I must be doing something stupid (I'll assume user error on
>> my part). But if there's anything obvious I'm doing wrong, please let me
>> know
>>
>> A more complete log can be found here https://gist.github.com/
>> softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>> doug-being-dumb.txt
>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>> gist.github.com
>>
>>
>> Thanks for any help
>>
>> -Doug
>> --
>> Consultant, OpenSource Connections. Contact info at
>> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
>> http://bit.ly/dougs_cal)
>> <http://o19s.com/about-us/doug-turnbull/>
>> Doug Turnbull <http://o19s.com/about-us/doug-turnbull/>
>> o19s.com
>> Search relevance consultant. Author of Relevant Search. Doug crafts
>> search/recommendation solutions that “get” users. To do this, Doug uses
>> Solr/Elasticsearc...
>>
>> --
> Consultant, OpenSource Connections. Contact info at
> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
> http://bit.ly/dougs_cal)
>
Re: Solr Ref Guide not building
Posted by David Smiley <da...@gmail.com>.
It may be worth considering having us publish a docker image with what's
needed for generating the ref guide. Optional of course; and needn't be
"official".
On Sun, Dec 3, 2017 at 10:57 AM Cassandra Targett <ca...@gmail.com>
wrote:
> Ishan's errors happen every time and are harmless & can be ignored.
> They're from Asciidoctor trying to enforce rules it has for the document
> type that we use (book). The problem is actually in the pages _before_ the
> ones that throw the error, and it's because those pages don't have sections
> in them.
>
> The issue about 'plugins' vs 'gems' is also known, but the older syntax is
> just deprecated and doesn't hurt anything right now. I tried at one point
> to change it, but ran into an error I forget now and didn't have time to
> fix it. I will eventually, but it's not causing Doug's problem since I
> never see that error locally and our build systems also never see it.
>
> I googled the error you're getting, Doug, and wonder what Python version
> you're using? It seems there is an issue about using Python 3 and the
> pygments.rb syntax highlighter gem (see also
> https://github.com/jekyll/jekyll/issues/2604). If you're using 2.7.x,
> I'll keep looking.
>
> On Sat, Dec 2, 2017 at 1:15 PM, Martin Gainty <mg...@hotmail.com> wrote:
>
>>
>> as evidenced by the warning you're getting..your yaml scripts appear to
>> reference deprecated ruby gems
>>
>> personally i dont care to implement ruby gems since these binaries work
>> on ONLY the OS/ARCH they were originally targeted for
>>
>> a well designed software architecture implementing plugins will flexibly
>> build to any number of OS/ARCH with no need to <re>build for each specific
>> target OS/ARCH with makefile(s) (as is the case for ruby gems) .
>>
>>
>> The caveat for implementing plugins is "as long as the JDK remains the
>> same" you should see no behaviour delta(s) as you implement your plugin
>> from one OS/ARCH to another..
>>
>>
>> hth
>> Martin
>> ______________________________________________
>>
>>
>> ------------------------------
>> *From:* Doug Turnbull <dt...@opensourceconnections.com>
>> *Sent:* Saturday, December 2, 2017 1:12 PM
>> *To:* dev@lucene.apache.org
>> *Subject:* Re: Solr Ref Guide not building
>>
>> Thanks.
>>
>> I don’t mind poking around the ref guide config, but I'm following the
>> readme and building master. I'm hesitant to change config files as part of
>> my PR, which probably will break the ref guide build for others :)
>>
>> Best
>> -Doug
>>
>>
>> On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com> wrote:
>>
>>
>> MG>see below
>>
>>
>> ------------------------------
>> *From:* Doug Turnbull <dt...@opensourceconnections.com>
>> *Sent:* Friday, December 1, 2017 9:17 PM
>> *To:* dev@lucene.apache.org
>> *Subject:* Solr Ref Guide not building
>>
>> Hello!
>>
>> I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
>> believe I've installed the required dependencies and double checked the
>> README in the solr-ref-guide. Unfortunately, running ant build-site I
>> immediately get this error, seemingly on the first adoc file encountered:
>>
>>
>> [exec] jekyll 3.5.0 | Error: No header received back.
>> [exec] Conversion error: Jekyll::AsciiDoc::Converter encountered
>> an error while converting 'about-filters.adoc':
>> MG>possible ant build snafu
>> MG>configuration file:
>> /Users/doug/ws/lucene-solr/solr/build/solr-ref-guide/content/_config.yml
>> MG>Deprecation: The 'gems' configuration option has been renamed to
>> 'plugins'.
>> MG>Please update your config file accordingly.
>> MG>check output config.yml for 'gems' and sub in 'plugins'
>> MG>also check ant input solr-ref-guide/config.yml.template for 'gems'
>> instead of 'plugins'
>>
>> I feel like I must be doing something stupid (I'll assume user error on
>> my part). But if there's anything obvious I'm doing wrong, please let me
>> know
>>
>> A more complete log can be found here
>> https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>> doug-being-dumb.txt
>> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
>> gist.github.com
>>
>>
>> Thanks for any help
>>
>> -Doug
>> --
>> Consultant, OpenSource Connections. Contact info at
>> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
>> http://bit.ly/dougs_cal)
>> <http://o19s.com/about-us/doug-turnbull/>
>> Doug Turnbull <http://o19s.com/about-us/doug-turnbull/>
>> o19s.com
>> Search relevance consultant. Author of Relevant Search. Doug crafts
>> search/recommendation solutions that “get” users. To do this, Doug uses
>> Solr/Elasticsearc...
>>
>> --
>> Consultant, OpenSource Connections. Contact info at
>> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
>> http://bit.ly/dougs_cal)
>>
>
> --
Lucene/Solr Search Committer, Consultant, Developer, Author, Speaker
LinkedIn: http://linkedin.com/in/davidwsmiley | Book:
http://www.solrenterprisesearchserver.com
Re: Solr Ref Guide not building
Posted by Cassandra Targett <ca...@gmail.com>.
Ishan's errors happen every time and are harmless & can be ignored. They're
from Asciidoctor trying to enforce rules it has for the document type that
we use (book). The problem is actually in the pages _before_ the ones that
throw the error, and it's because those pages don't have sections in them.
The issue about 'plugins' vs 'gems' is also known, but the older syntax is
just deprecated and doesn't hurt anything right now. I tried at one point
to change it, but ran into an error I forget now and didn't have time to
fix it. I will eventually, but it's not causing Doug's problem since I
never see that error locally and our build systems also never see it.
I googled the error you're getting, Doug, and wonder what Python version
you're using? It seems there is an issue about using Python 3 and the
pygments.rb syntax highlighter gem (see also
https://github.com/jekyll/jekyll/issues/2604). If you're using 2.7.x, I'll
keep looking.
On Sat, Dec 2, 2017 at 1:15 PM, Martin Gainty <mg...@hotmail.com> wrote:
>
> as evidenced by the warning you're getting..your yaml scripts appear to
> reference deprecated ruby gems
>
> personally i dont care to implement ruby gems since these binaries work on
> ONLY the OS/ARCH they were originally targeted for
>
> a well designed software architecture implementing plugins will flexibly
> build to any number of OS/ARCH with no need to <re>build for each specific
> target OS/ARCH with makefile(s) (as is the case for ruby gems) .
>
>
> The caveat for implementing plugins is "as long as the JDK remains the
> same" you should see no behaviour delta(s) as you implement your plugin
> from one OS/ARCH to another..
>
>
> hth
> Martin
> ______________________________________________
>
>
> ------------------------------
> *From:* Doug Turnbull <dt...@opensourceconnections.com>
> *Sent:* Saturday, December 2, 2017 1:12 PM
> *To:* dev@lucene.apache.org
> *Subject:* Re: Solr Ref Guide not building
>
> Thanks.
>
> I don’t mind poking around the ref guide config, but I'm following the
> readme and building master. I'm hesitant to change config files as part of
> my PR, which probably will break the ref guide build for others :)
>
> Best
> -Doug
>
>
> On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com> wrote:
>
>
> MG>see below
>
>
> ------------------------------
> *From:* Doug Turnbull <dt...@opensourceconnections.com>
> *Sent:* Friday, December 1, 2017 9:17 PM
> *To:* dev@lucene.apache.org
> *Subject:* Solr Ref Guide not building
>
> Hello!
>
> I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
> believe I've installed the required dependencies and double checked the
> README in the solr-ref-guide. Unfortunately, running ant build-site I
> immediately get this error, seemingly on the first adoc file encountered:
>
>
> [exec] jekyll 3.5.0 | Error: No header received back.
> [exec] Conversion error: Jekyll::AsciiDoc::Converter encountered an
> error while converting 'about-filters.adoc':
> MG>possible ant build snafu
> MG>configuration file: /Users/doug/ws/lucene-solr/
> solr/build/solr-ref-guide/content/_config.yml
> MG>Deprecation: The 'gems' configuration option has been renamed to
> 'plugins'.
> MG>Please update your config file accordingly.
> MG>check output config.yml for 'gems' and sub in 'plugins'
> MG>also check ant input solr-ref-guide/config.yml.template for 'gems'
> instead of 'plugins'
>
> I feel like I must be doing something stupid (I'll assume user error on my
> part). But if there's anything obvious I'm doing wrong, please let me know
>
> A more complete log can be found here https://gist.github.com/
> softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
> doug-being-dumb.txt
> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
> gist.github.com
>
>
> Thanks for any help
>
> -Doug
> --
> Consultant, OpenSource Connections. Contact info at
> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
> http://bit.ly/dougs_cal)
> <http://o19s.com/about-us/doug-turnbull/>
> Doug Turnbull <http://o19s.com/about-us/doug-turnbull/>
> o19s.com
> Search relevance consultant. Author of Relevant Search. Doug crafts
> search/recommendation solutions that “get” users. To do this, Doug uses
> Solr/Elasticsearc...
>
> --
> Consultant, OpenSource Connections. Contact info at
> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
> http://bit.ly/dougs_cal)
>
Re: Solr Ref Guide not building
Posted by Martin Gainty <mg...@hotmail.com>.
as evidenced by the warning you're getting..your yaml scripts appear to reference deprecated ruby gems
personally i dont care to implement ruby gems since these binaries work on ONLY the OS/ARCH they were originally targeted for
a well designed software architecture implementing plugins will flexibly build to any number of OS/ARCH with no need to <re>build for each specific target OS/ARCH with makefile(s) (as is the case for ruby gems) .
The caveat for implementing plugins is "as long as the JDK remains the same" you should see no behaviour delta(s) as you implement your plugin from one OS/ARCH to another..
hth
Martin
______________________________________________
________________________________
From: Doug Turnbull <dt...@opensourceconnections.com>
Sent: Saturday, December 2, 2017 1:12 PM
To: dev@lucene.apache.org
Subject: Re: Solr Ref Guide not building
Thanks.
I don’t mind poking around the ref guide config, but I'm following the readme and building master. I'm hesitant to change config files as part of my PR, which probably will break the ref guide build for others :)
Best
-Doug
On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com>> wrote:
MG>see below
________________________________
From: Doug Turnbull <dt...@opensourceconnections.com>>
Sent: Friday, December 1, 2017 9:17 PM
To: dev@lucene.apache.org<ma...@lucene.apache.org>
Subject: Solr Ref Guide not building
Hello!
I'm trying to update the Solr Ref guide with my change for SOLR-11662. I believe I've installed the required dependencies and double checked the README in the solr-ref-guide. Unfortunately, running ant build-site I immediately get this error, seemingly on the first adoc file encountered:
[exec] jekyll 3.5.0 | Error: No header received back.
[exec] Conversion error: Jekyll::AsciiDoc::Converter encountered an error while converting 'about-filters.adoc':
MG>possible ant build snafu
MG>configuration file: /Users/doug/ws/lucene-solr/solr/build/solr-ref-guide/content/_config.yml
MG>Deprecation: The 'gems' configuration option has been renamed to 'plugins'.
MG>Please update your config file accordingly.
MG>check output config.yml for 'gems' and sub in 'plugins'
MG>also check ant input solr-ref-guide/config.yml.template for 'gems' instead of 'plugins'
I feel like I must be doing something stupid (I'll assume user error on my part). But if there's anything obvious I'm doing wrong, please let me know
A more complete log can be found here https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
[https://avatars1.githubusercontent.com/u/629060?s=400&v=4]<https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
doug-being-dumb.txt<https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
gist.github.com<http://gist.github.com>
Thanks for any help
-Doug
--
Consultant, OpenSource Connections. Contact info at http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
[http://opensourceconnections.com/images/logo/OSC-logomark-color.png]<http://o19s.com/about-us/doug-turnbull/>
Doug Turnbull<http://o19s.com/about-us/doug-turnbull/>
o19s.com<http://o19s.com>
Search relevance consultant. Author of Relevant Search. Doug crafts search/recommendation solutions that “get” users. To do this, Doug uses Solr/Elasticsearc...
--
Consultant, OpenSource Connections. Contact info at http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
Re: Solr Ref Guide not building
Posted by Doug Turnbull <dt...@opensourceconnections.com>.
Thanks.
I don’t mind poking around the ref guide config, but I'm following the
readme and building master. I'm hesitant to change config files as part of
my PR, which probably will break the ref guide build for others :)
Best
-Doug
On Sat, Dec 2, 2017 at 7:37 AM Martin Gainty <mg...@hotmail.com> wrote:
>
> MG>see below
>
>
> ------------------------------
> *From:* Doug Turnbull <dt...@opensourceconnections.com>
> *Sent:* Friday, December 1, 2017 9:17 PM
> *To:* dev@lucene.apache.org
> *Subject:* Solr Ref Guide not building
>
> Hello!
>
> I'm trying to update the Solr Ref guide with my change for SOLR-11662. I
> believe I've installed the required dependencies and double checked the
> README in the solr-ref-guide. Unfortunately, running ant build-site I
> immediately get this error, seemingly on the first adoc file encountered:
>
>
> [exec] jekyll 3.5.0 | Error: No header received back.
> [exec] Conversion error: Jekyll::AsciiDoc::Converter encountered an
> error while converting 'about-filters.adoc':
> MG>possible ant build snafu
> MG>configuration file:
> /Users/doug/ws/lucene-solr/solr/build/solr-ref-guide/content/_config.yml
> MG>Deprecation: The 'gems' configuration option has been renamed to
> 'plugins'.
> MG>Please update your config file accordingly.
> MG>check output config.yml for 'gems' and sub in 'plugins'
> MG>also check ant input solr-ref-guide/config.yml.template for 'gems'
> instead of 'plugins'
>
> I feel like I must be doing something stupid (I'll assume user error on my
> part). But if there's anything obvious I'm doing wrong, please let me know
>
> A more complete log can be found here
> https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
> doug-being-dumb.txt
> <https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
> gist.github.com
>
>
> Thanks for any help
>
> -Doug
> --
> Consultant, OpenSource Connections. Contact info at
> http://o19s.com/about-us/doug-turnbull/; Free/Busy (
> http://bit.ly/dougs_cal)
> <http://o19s.com/about-us/doug-turnbull/>
> Doug Turnbull <http://o19s.com/about-us/doug-turnbull/>
> o19s.com
> Search relevance consultant. Author of Relevant Search. Doug crafts
> search/recommendation solutions that “get” users. To do this, Doug uses
> Solr/Elasticsearc...
>
> --
Consultant, OpenSource Connections. Contact info at
http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
Re: Solr Ref Guide not building
Posted by Martin Gainty <mg...@hotmail.com>.
MG>see below
________________________________
From: Doug Turnbull <dt...@opensourceconnections.com>
Sent: Friday, December 1, 2017 9:17 PM
To: dev@lucene.apache.org
Subject: Solr Ref Guide not building
Hello!
I'm trying to update the Solr Ref guide with my change for SOLR-11662. I believe I've installed the required dependencies and double checked the README in the solr-ref-guide. Unfortunately, running ant build-site I immediately get this error, seemingly on the first adoc file encountered:
[exec] jekyll 3.5.0 | Error: No header received back.
[exec] Conversion error: Jekyll::AsciiDoc::Converter encountered an error while converting 'about-filters.adoc':
MG>possible ant build snafu
MG>configuration file: /Users/doug/ws/lucene-solr/solr/build/solr-ref-guide/content/_config.yml
MG>Deprecation: The 'gems' configuration option has been renamed to 'plugins'.
MG>Please update your config file accordingly.
MG>check output config.yml for 'gems' and sub in 'plugins'
MG>also check ant input solr-ref-guide/config.yml.template for 'gems' instead of 'plugins'
I feel like I must be doing something stupid (I'll assume user error on my part). But if there's anything obvious I'm doing wrong, please let me know
A more complete log can be found here https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073
[https://avatars1.githubusercontent.com/u/629060?s=400&v=4]<https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
doug-being-dumb.txt<https://gist.github.com/softwaredoug/36fe87f0d63403e7be22d5a2ff8af073>
gist.github.com
Thanks for any help
-Doug
--
Consultant, OpenSource Connections. Contact info at http://o19s.com/about-us/doug-turnbull/; Free/Busy (http://bit.ly/dougs_cal)
[http://opensourceconnections.com/images/logo/OSC-logomark-color.png]<http://o19s.com/about-us/doug-turnbull/>
Doug Turnbull<http://o19s.com/about-us/doug-turnbull/>
o19s.com
Search relevance consultant. Author of Relevant Search. Doug crafts search/recommendation solutions that “get” users. To do this, Doug uses Solr/Elasticsearc...