# lucene-dev mailing list archives

##### Site index · List index
Message view
Top
From "Houston Putman (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (SOLR-11217) Mathematical notation not supported in Solr Ref Guide
Date Thu, 10 Aug 2017 15:42:02 GMT

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

Houston Putman commented on SOLR-11217:
---------------------------------------

I originally used some notation in the analytics component documentation, but I removed that
section eventually. It just caused me quite a bit of pain trying to figure it out, and wanted
to save others from it in the future.

Given how cumbersome the PDF solution is, disallowing mathematical notation might be the right
move. Since I don't see very many places where it would be useful. However some ML components
might find it useful.

> 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-unsubscribe@lucene.apache.org