[
https://issues.apache.org/jira/browse/SOLR-15556?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17489840#comment-17489840
]
Houston Putman commented on SOLR-15556:
---------------------------------------
Ok spent the day tackling the {{stem}} support. There is a very nifty
asciidoctor.js extension that does pre-processed math syntax, meaning that we
don't have to include client-side code to do this (very important since this is
a major downside of mathjax):
[https://gitlab.com/djencks/asciidoctor-mathjax.js]
However we use math expressions in description lists, such as in
{{{}backup-restore.adoc{}}}. Unfortunately this extension has a bug that
description lists are not parsed to find stem expressions. Weirdly enough
someone made an issue about this exact issue yesterday. Finally got a fix
working locally and came up with a Merge Request, so we can continue on and
hope that this gets merged before the ref guide is officially published. And if
not, then we can rebuild the guide whenever it does.
You can track the PR here:
https://gitlab.com/djencks/asciidoctor-mathjax.js/-/merge_requests/9
> Ref Guide Redesign Phase 3: Replace Jekyll
> ------------------------------------------
>
> Key: SOLR-15556
> URL: https://issues.apache.org/jira/browse/SOLR-15556
> Project: Solr
> Issue Type: Improvement
> Components: documentation
> Reporter: Cassandra Targett
> Assignee: Cassandra Targett
> Priority: Blocker
> Fix For: 9.0
>
>
> The final step of my grand vision for redesigning the Ref Guide is to look at
> replacing Jekyll with a different static site generator.
> The primary reason why is because Jekyll is designed for blog posts, not for
> sites with hundreds of static pages like ours. Back in 2017 when I chose it,
> it was relatively straightforward to implement, a lot of information was
> available in Jekyll docs and the internet in general to customize it, and it
> was one of the few that supported Asciidoc format.
> However now there are a lot more options, including some which are
> specifically designed for large multi-version documentation sites like the
> Ref Guide.
> Included with this will be reorganizing the on-disk organization of the ref
> guide files themselves.
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org
