sphinx-doc/sphinx

MathML default output for Math

Open

#6 092 ouverte le 21 févr. 2019

Voir sur GitHub
 (22 commentaires) (0 réactions) (0 assignés)Python (1 985 forks)batch import
builder:htmlextensions:mathematicshelp wantedmarkuptype:enhancementtype:proposal

Métriques du dépôt

Stars
 (5 625 stars)
Métriques de merge PR
 (Merge moyen 10j 11h) (11 PRs mergées en 30 j)

Description

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?

Guide contributeur

Direction de recherche
Étudiez comment Sphinx gère actuellement la sortie mathématique (par exemple MathJax, imgmath). Identifiez le chemin de code pour la sortie mathématique et où un nouveau constructeur MathML pourrait être intégré. Étudiez la spécification MathML pour HTML5 et les bibliothèques MathML existantes en Python.
Stack technique
python
Domaine
documentation
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-2 jours
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
PythonSphinx extension development
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
40