According to the KaTeX documentation, it supports prerendering HTML server side so tha

yes, it injects HTML, compare <div class="

Option to pre-render? about sphinxcontrib-katex HOT 5 CLOSED

hagenw commented on May 24, 2024

Option to pre-render?

from sphinxcontrib-katex.

Comments (5)

hagenw commented on May 24, 2024

Hi, thanks for the suggestion.
So far it is not supported. For me as a non-expert regarding Node.js, the documentation provided by KaTeX was not sufficient to consider it.

Are you able to create a pull request for it?

from sphinxcontrib-katex.

ezyang commented on May 24, 2024

I'd have to look into it. What I expect to happen is that we invoke KaTeX via nodejs, it gives a bunch of html, and then we need to dump it into the Sphinx generated HTML. So, shouldn't be too bad, if this extension is setup to inject raw html (which it should be?)

from sphinxcontrib-katex.

hagenw commented on May 24, 2024

yes, it injects HTML, compare

sphinxcontrib-katex/sphinxcontrib/katex.py

Lines 77 to 102 in ba0db20

 def html_visit_math(self, node): 

 self.body.append(self.starttag(node, 'span', '', CLASS='math')) 

 self.body.append(self.builder.config.katex_inline[0] + 

 self.encode(get_latex(node)) + 

 self.builder.config.katex_inline[1] + '</span>') 

 raise nodes.SkipNode 

 def html_visit_displaymath(self, node): 

 self.body.append(self.starttag(node, 'div', CLASS='math')) 

 if node['nowrap']: 

 self.body.append(self.encode(get_latex(node))) 

 self.body.append('</div>') 

 raise nodes.SkipNode 

 # necessary to e.g. set the id property correctly 

 if node['number']: 

 number = get_node_equation_number(self, node) 

 self.body.append('<span class="eqno">(%s)' % number) 

 self.add_permalink_ref(node, _('Permalink to this equation')) 

 self.body.append('</span>') 

 self.body.append(self.builder.config.katex_display[0]) 

 self.body.append(get_latex(node)) 

 self.body.append(self.builder.config.katex_display[1]) 

 self.body.append('</div>\n') 

 raise nodes.SkipNode

from sphinxcontrib-katex.

ezyang commented on May 24, 2024

This ended up being pretty easy. I'll post a shitty version of the patch (that breaks some existing functionality and is not configurable) and maybe we can talk about how to support the other bits correctly.

from sphinxcontrib-katex.

hagenw commented on May 24, 2024

KaTeX server side pre-rendering is included with sphinxcontrib-katex 0.5.0.

from sphinxcontrib-katex.

Option to pre-render? about sphinxcontrib-katex HOT 5 CLOSED

Comments (5)

Related Issues (14)

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent

	def html_visit_math(self, node):
	self.body.append(self.starttag(node, 'span', '', CLASS='math'))
	self.body.append(self.builder.config.katex_inline[0] +
	self.encode(get_latex(node)) +
	self.builder.config.katex_inline[1] + '</span>')
	raise nodes.SkipNode


	def html_visit_displaymath(self, node):
	self.body.append(self.starttag(node, 'div', CLASS='math'))
	if node['nowrap']:
	self.body.append(self.encode(get_latex(node)))
	self.body.append('</div>')
	raise nodes.SkipNode

	# necessary to e.g. set the id property correctly
	if node['number']:
	number = get_node_equation_number(self, node)
	self.body.append('<span class="eqno">(%s)' % number)
	self.add_permalink_ref(node, _('Permalink to this equation'))
	self.body.append('</span>')
	self.body.append(self.builder.config.katex_display[0])
	self.body.append(get_latex(node))
	self.body.append(self.builder.config.katex_display[1])
	self.body.append('</div>\n')
	raise nodes.SkipNode