sphinx-doc/sphinx

MathML default output for Math

Open

#6.092 aberto em 21 de fev. de 2019

Ver no GitHub
 (22 comments) (0 reactions) (0 assignees)Python (1.985 forks)batch import
builder:htmlextensions:mathematicshelp wantedmarkuptype:enhancementtype:proposal

Métricas do repositório

Stars
 (5.625 stars)
Métricas de merge de PR
 (Mesclagem média 10d 11h) (11 fundiu PRs em 30d)

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?

Guia do colaborador

Direção de pesquisa
Pesquise como o Sphinx atualmente lida com a saída matemática (por exemplo, MathJax, imgmath). Identifique o caminho do código para a saída matemática e onde um novo construtor MathML poderia ser integrado. Estude a especificação MathML para HTML5 e as bibliotecas MathML existentes em Python.
Pilha de tecnologia
python
Domain
documentation
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
PythonSphinx extension development
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
40