[ 
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-unsubscr...@lucene.apache.org
For additional commands, e-mail: dev-h...@lucene.apache.org

Reply via email to