JuliaDocs/Documenter.jl

Option for CDN-free builds

Aberta

#2.159 aberto em 29 de jun. de 2023

Ver no GitHub
 (2 comentários) (7 reações) (0 responsável)Julia (513 forks)batch import
Format: HTMLType: Enhancementhelp wanted

Métricas do repositório

Stars
 (910 estrelas)
Métricas de merge de PR
 (Mesclagem média 16d 9h) (3 fundiu PRs em 30d)

Description

The generated HTML/JS/CSS from the documentation builds depend on cdnjs and Google Fonts right now. It might be useful in some cases to build the docs without CDN-ed dependencies.

Something also worth considering is that we are kinda vulnerable to a CDN going offline or becoming inaccessible right now. So we could also consider bundling by default.

Guia do colaborador

Direção de pesquisa
Investigue o pipeline de build do Documenter.jl, provavelmente no módulo de geração HTML, para entender como os ativos de CDN são incluídos. Procure por opções de configuração existentes e considere adicionar um novo sinalizador ou etapa de build para agrupar ativos localmente ou omitir dependências externas. Revise quaisquer comentários na issue para contexto adicional.
Pilha de tecnologia
javascriptcss
Domain
tooling
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.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
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
JuliaGit
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75