From 7bb3e5c2482c7b73ed2dd26ff4be4613e7f44872 Mon Sep 17 00:00:00 2001 From: Cassandra Targett Date: Thu, 17 May 2018 15:02:30 -0500 Subject: [PATCH] Ref Guide: add step to install asciidoctor before jekyll-asciidoc to prevent wrong version of gem being installed as a dependency --- solr/solr-ref-guide/README.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/solr/solr-ref-guide/README.adoc b/solr/solr-ref-guide/README.adoc index b1613965d19..279ad68dca3 100644 --- a/solr/solr-ref-guide/README.adoc +++ b/solr/solr-ref-guide/README.adoc @@ -25,7 +25,8 @@ These files are processed with AsciiDoctor in 2 different ways: * Via Jekyll to build an HTML browsable version of the Ref Guide. ** Prerequisites: `Ruby` (v2.1 or higher) and the following gems must be installed: -*** `jekyll`: v3.5, not v4.x. Use `gem install --force --version 3.5.0 jekyll` to force install of Jekyll 3.5.0. +*** `jekyll`: v3.5, not v4.x. Use `gem install jekyll --force --version 3.5.0` to force install of Jekyll 3.5.0. +*** `asciidoctor`: v1.5.6.2, not 1.5.7 or higher. Use `gem install asciidoctor --force --version 1.5.6.2`. NOTE: You must do this before installing `jekyll-asciidoc` or you'll get a version of Asciidoctor that we can't use yet. *** `jekyll-asciidoc`: v2.1 or higher. Use `gem install jekyll-asciidoc` to install. *** `pygments.rb`: v1.1.2 or higher. Use `gem install pygments.rb` to install. * Via `asciidoctor-ant` to build the officially released PDF version of the Ref Guide.