Mastodon/Mathjax
| Mastodon/Mathjax | |
|---|---|
| Description | Borrowing mathjax from mathstodon :) |
| Part Of | Mastdon/Hacking |
| Contributors | Jonny Saunders |
| Has Git Repository | https://github.com/NeuromatchAcademy/mastodon |
| Completion Status | Completed |
| Active Status | Completed |
| Approval Status | Approved |
Up to: Mastodon/Hacking
Description
Mathstodon has nice mathjax support. We don't :(
Let's use theirs!
Usage
- Anything within a tag like
\( x = y \)for inline equations or\[ x = y \]for lined equations should be rendered by mathjax! - There is also an equation insert button on the compose box below the emoji bar!
Code
- Pull Requests:
- Original: https://github.com/NeuromatchAcademy/mastodon/pull/2
- (Supercedes original) Pulled into local
mathstodon-4.0.2branch, removing font before pulling to feature branch: https://github.com/NeuromatchAcademy/mastodon/pull/3 - Pulling into dev: https://github.com/NeuromatchAcademy/mastodon/pull/6
- Feature Branch: https://github.com/NeuromatchAcademy/mastodon/tree/feature-mathtex
Details of Implementation
glitch-soc uses "flavors" to style the frontend, which is different than base mastodon! To do this we'll need to move the mathstodon implementation into the 'glitch' flavor.
To do that, we can take account of what the mathstodon implementation does:
New Components
Scripts
app/javascript/mastodon/features/compose/util/autolatex/autolatex.js- utility functions for writing latex
Components
app/javascript/mastodon/components/autosuggest_latex.js- autosuggestions menuapp/javascript/mastodon/features/compose/components/latex_dropdown.js- latex dropdown menuapp/javascript/mastodon/features/compose/containers/latex_dropdown_container.jscontainer for ^
Integration
On Feeds
app/javascript/mastodon/components/status_content.js- renders mathjax present in any existing status
Composing
app/javascript/mastodon/actions/compose.jsimports autolatex and integrated in the compose componentapp/javascript/mastodon/components/autosuggest_input.jsAdds additional AutosuggestLatex componentapp/javascript/mastodon/components/autosuggest_textarea.jsText area that import AutosuggestLatexapp/javascript/mastodon/features/compose/components/compose_form.jsAdds latex selection buttonapp/javascript/mastodon/features/compose/containers/compose_form_container.jsContainer for ^
Git Patching the Glitch Flavor
Dang that's complicated. So why don't we try to just apply the diff from the mathstodon changes in the main code directory and apply them in the 'glitch' flavor subdirectory, which seems to have the same structure?
https://www.howtogeek.com/devops/how-to-apply-git-commit-diffs-to-different-files/
Patches
- Fix problems with CSP
TODO
- Pare down the pull request to just select the mathjax parts
- Actually make the merge work
- Merge it!
References
- How to actually goddamn initialize mathjax when loaded in an es6 module: https://github.com/mathjax/MathJax/issues/2194#issuecomment-530623540
Stumpted
Aight i'm totally flummoxed about how to get Mastodon/Mathjax#Stumpted to load. it <really really> wants you to use the <script> tag loading method, which i would rather not do since that makes it way less portable or else requires a call-out to an external CDN, but I can't get the startup functions to trigger programmatically, and i've tried all the various things in their docs as well as some other stuff that isn't. I am tempted to just rewrite the mathstodon stuff using a react component that i was able to find but idk <@451520217139511306> u know anything else about this?
Discord
Mastodon/Mathjax: information in this thread about different possible implementation approaches
Mastodon/Hacking#Dev Environment: Details on setting up Vagrant for local development
Wikibot#TODO: implement n-back archiving of threads and previous posts, the parser already supports it