codinginbarn/bookstack-hacks
Fork 0
forked from bookstack/hacks
Code Pull requests Activity

Add LaTeX/MathJax hack

Browse source 
Signed-off-by: AKP <tom@tdpain.net>
This commit is contained in:
AKP 2023-02-27 11:53:58 +00:00
commit 1dffc6b7b7
No known key found for this signature in database
GPG key ID: AA5726202C8879B7
2 changed files with 45 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
content/mathjax/head.html Normal file
View file

@ -0,0 +1,9 @@
<script>
MathJax = {
tex: {
inlineMath: [['$', '$']],
},
};
</script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js">
</script>

36
content/mathjax/index.md Normal file
View file

@ -0,0 +1,36 @@
+++
title = "Render LaTeX with MathJax"
author = "@codemicro"
date = 2023-02-27T00:00:00Z
updated = 2023-02-27T00:00:00Z
tested = "v23.02"
+++
This hack will allow LaTeX equations and markup to be rendered within a page on
Bookstack.
Inline math can be surrounded with `$` and math blocks can be surrounded with
`$$`.
This can be used with both the WYSISYG editor and the Markdown editor and will
affect everything on a given page, meaning this can be used in titles,
book/chapter headings, etc.
#### Considerations
This loads MathJax the MathJax JavaScript from a CDN, and will do so for every
page load.
Live previews of the rendered LaTeX markup will not be rendered in the Markdown
editor's preview.
Using this markup may create difficulties when using the search engine to find
certain pages.
#### Options
It is possible to configure MathJax as documented [here](https://docs.mathjax.org/en/latest/web/configuration.html).
#### Code
{{<hack file="head.html" type="head">}}