sphinx-doc/sphinx

MathML default output for Math

Open

#6092 aperta il 21 feb 2019

Vedi su GitHub
 (22 commenti) (0 reazioni) (0 assegnatari)Python (1985 fork)batch import
builder:htmlextensions:mathematicshelp wantedmarkuptype:enhancementtype:proposal

Metriche repository

Star
 (5625 star)
Metriche merge PR
 (Merge medio 10g 11h) (11 PR mergiate in 30 g)

Descrizione

From the docs:

"Since mathematical notation isn’t natively supported by HTML in any way..."

That's not totally true. MathML is a part of the HTML5 spec, though browser support is spotty to say the least. Since the alternative without installing plugins is just math not working, maybe a good default would be to follow the spec for the output format?

Guida contributor

Direzione di ricerca
Studia come Sphinx gestisce attualmente l'output matematico (ad esempio MathJax, imgmath). Identifica il percorso del codice per l'output matematico e dove un nuovo builder MathML potrebbe essere integrato. Studia la specifica MathML per HTML5 e le librerie MathML esistenti in Python.
Tech stack
python
Dominio
documentation
Tipo issue
Funzionalità
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
3
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-2 giorni
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
PythonSphinx extension development
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
40