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 <mgai...@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 <dturnb...@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 <mgai...@hotmail.com> wrote: > > > MG>see below > > > ------------------------------ > *From:* Doug Turnbull <dturnb...@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) >
