JuliaDocs/Documenter.jl

Option for CDN-free builds

Open

#2,159 建立於 2023年6月29日

在 GitHub 查看
 (2 留言) (7 反應) (0 負責人)Julia (910 star) (513 fork)batch import
Format: HTMLType: Enhancementhelp wanted

描述

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.

貢獻者指南

技術棧
無
領域
documentation
議題類型
feature
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
half day
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
mostly clear
前置要求
Familiarity with Documenter.jlBasic Julia knowledge
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
60
研究方向
Investigate the Documenter.jl build pipeline, likely in the HTML generation module, to understand how CDN assets are included. Look for existing configuration options and consider adding a new flag or build step to either bundle assets locally or omit external dependencies. Review any comments on the issue for additional context.