Mailing-List: contact commits-help@lucene.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@lucene.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: ab@apache.org
To: commits@lucene.apache.org
Date: Fri, 13 Oct 2017 10:57:42 -0000
Message-Id: <bc89a50d20714f86b6c5f84f45ba064b@git.apache.org>
In-Reply-To: <d5b3980bd8394bcda8e4d973d58d0ce7@git.apache.org>
References: <d5b3980bd8394bcda8e4d973d58d0ce7@git.apache.org>
Subject: [3/8] lucene-solr:jira/solr-11285: Ref Guide: fix "how to edit
 Jekyll" docs so section-toc optional parameter displays in output
archived-at: Fri, 13 Oct 2017 10:57:45 -0000

Ref Guide: fix "how to edit Jekyll" docs so section-toc optional parameter displays in output


Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/05ce9684
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/05ce9684
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/05ce9684

Branch: refs/heads/jira/solr-11285
Commit: 05ce9684825434c5c2da1e4fa6d6c8eeb8386460
Parents: 4f52d2d
Author: Cassandra Targett <ctargett@apache.org>
Authored: Thu Oct 12 09:50:58 2017 -0500
Committer: Cassandra Targett <ctargett@apache.org>
Committed: Thu Oct 12 09:51:59 2017 -0500

----------------------------------------------------------------------
 solr/solr-ref-guide/src/meta-docs/jekyll.adoc | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/05ce9684/solr/solr-ref-guide/src/meta-docs/jekyll.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/meta-docs/jekyll.adoc b/solr/solr-ref-guide/src/meta-docs/jekyll.adoc
index f2a8b72..264a5cd 100644
--- a/solr/solr-ref-guide/src/meta-docs/jekyll.adoc
+++ b/solr/solr-ref-guide/src/meta-docs/jekyll.adoc
@@ -56,10 +56,17 @@ The Solr Ref Guide uses the front matter to define some custom attributes on a p
 There are also some optional custom attributes that can be defined in pages to affect the Table of Contents presentation in jekyll:
 
 * `page-toclevels` - changes how "deep" the TOC will be in terms of nested section/sub-section titles (default = 2)
-* `page-tocclass` - changes the CSS class applied to the TOC, default = "normal", resulting in the class name `toc-normal`. The other option is "right", to put the TOC on the right side of the page.
+* `page-tocclass` - changes the CSS class applied to the TOC. The default is `normal`, resulting in the class name `toc-normal` being used in the HTML. The other option is `right`, to put the TOC on the right side of the page.
 * `page-toc` - if this is false, then no TOCs will be generated for the page at all.
 
-NOTE: The special macro `{section-toc}` can be used anywhere in a page to create an "In this Section" TOC covering only the sub-headings in the same section.  `:page-toc: false` will also prevent this macro from working, so if you want no "top level" TOC, but you do want section TOCs, use `:page-toclevels: 0`
+[NOTE]
+====
+The special macro `\{section-toc}` can be used anywhere in a page to create an "In this Section" TOC covering only the sub-headings in the same section.
+
+Setting `:page-toc: false` will prevent this macro from working, so if you want no "top level" TOC, but you do want section TOCs, use `:page-toclevels: 0`.
+====
+
+The format for adding any parameter to the front matter is to use colons on both sides of the parameter, followed by the value for the parameter (such as `:page-toc: false`).
 
 === Layouts