# [jira] [Commented] (SOLR-11217) Mathematical notation not supported in Solr Ref Guide

    [
https://issues.apache.org/jira/browse/SOLR-11217?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16120453#comment-16120453
] 

Cassandra Targett commented on SOLR-11217:
------------------------------------------

I hadn't realized until now that Asciidoctor had stem notation support built
into it. According to Asciidoctor docs
(http://asciidoctor.org/docs/user-manual/#activating-stem-support), it's as
simple as adding a {{:stem:}} attribute to a page (or globally, which we would
prefer). If I add that to a page and use Asciidoctor itself to convert the page
to HTML it works well.

In order to support it for Jekyll, we'd change the attribute slightly to
{{:page-stem:}}. Note we're not using Asciidoctor's converters to build our
HTML, we're using Jekyll's with a plugin from the Asciidoctor project to allow
Jekyll to support AsciiDoc formatted files. Adding the attribute to the page
front-matter (the stuff at the top of each file), however, has no impact
whatsoever.

It may be that this is not yet supported, or we need to add something as an
extension or plugin to Jekyll, or we may need to modify the templates as in
recommendation is: https://github.com/asciidoctor/jekyll-asciidoc/issues/163

> Mathematical notation not supported in Solr Ref Guide
> -----------------------------------------------------
>
>                 Key: SOLR-11217
>                 URL: https://issues.apache.org/jira/browse/SOLR-11217
>             Project: Solr
>          Issue Type: Bug
>      Security Level: Public(Default Security Level. Issues are Public)
>          Components: documentation
>            Reporter: Houston Putman
>            Priority: Minor
>
> The template used to build the Solr Ref Guide from the asciidoctor pages
> removes the needed javascript for mathematical notation.
> When building the webpage, asciidoctor puts a tag like the one below at the
> bottom of the html
> {code:html}
> <script
> src="#{cdn_base}/mathjax/2.6.0/MathJax.js?config=TeX-MML-AM_HTMLorMML"></script>
> {code}
> and some other tags as well.
> However these are not included in the sections that are inserted into the
> template, so they are left out and the mathematical notation is not converted
> to MathJax that can be viewed in a browser.
> This can be tested by adding any stem notation in an asciidoctor
> solr-ref-page, such as the following text:
> {code}
> asciimath:[sqrt(4) = 2].
> {code}

--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org