idyll-lang/idyll

Katex in static output

Open

#655 aberto em 1 de jul. de 2020

Ver no GitHub
 (3 comments) (0 reactions) (0 assignees)JavaScript (97 forks)batch import
CLIGood First PRbughelp wanted

Métricas do repositório

Stars
 (1.977 stars)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

The Katex CSS does not properly load in the static output of Idyll Equations leading to duplicated equations. It is linked via a URL that does not work under the file:// protocol.

To Reproduce

  1. idyll create
  2. accept defaults to produce a basic article
  3. replace index.idyll with a file containing only "[Equation]x = x + 1[/Equation]"
  4. run "idyll build"
  5. open with "firefox build/index.html"
  6. the equation displays twice

The equation displays twice because the Katex stylesheet appears to be included with a URL that does not work under the file:// protocol. Could the CSS be included in the stylesheet produced by "idyll build" instead?

    <link
      rel="stylesheet"
      href="//cdnjs.cloudflare.com/ajax/libs/KaTeX/0.9.0/katex.min.css"
    />

Expected behavior Equation appears once / css is loadable.

Desktop (please complete the following information):

  • OS: Arch Linux
  • Browser: Firefox
  • Version: 77.0.1

Guia do colaborador

Direção de pesquisa
A correção é incluir o CSS do Katex na folha de estilos gerada, em vez de usar uma URL relativa ao protocolo. Examine o processo de build no Idyll, particularmente no módulo construtor onde a tag <link> é inserida. Certifique se de que o CSS seja empacotado localmente ou que a URL seja alterada para https absoluto. Verifique também se há recursos externos semelhantes que possam quebrar sob o protocolo file://.
Pilha de tecnologia
javascriptcss
Domain
frontend
Tipo Issue
Bug
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
basic HTML/CSSunderstanding of static build process
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
80