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 <casstarg...@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 <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) >> > > -- Lucene/Solr Search Committer, Consultant, Developer, Author, Speaker LinkedIn: http://linkedin.com/in/davidwsmiley | Book: http://www.solrenterprisesearchserver.com
