[ 
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 
your suggestion. I've asked the jekyll-asciidoc project what their 
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
For additional commands, e-mail: dev-h...@lucene.apache.org

Reply via email to