prestodb/presto

Sphinx 8 will drop support for representing paths as strings. Use "pathlib.Path" or "os.fspath" instead.

Open

#22,475 建立於 2024年4月10日

在 GitHub 查看
 (6 留言) (0 反應) (0 負責人)Java (5,240 fork)batch import
beginner-taskbootcampcleanupdocsgood first issue

倉庫指標

Star
 (15,558 star)
PR 合併指標
 (平均合併 34天 14小時) (30 天內合併 120 個 PR)

描述

Warning in build

/Users/elharo/presto/presto-docs/presto-docs-venv/lib/python3.9/site-packages/sphinx_material/init.py:74: RemovedInSphinx80Warning: Sphinx 8 will drop support for representing paths as strings. Use "pathlib.Path" or "os.fspath" instead. filename = app.outdir + "/sitemap.xml" Generating sitemap for 483 pages in /Users/elharo/presto/presto-docs/target/html/sitemap.xml build succeeded, 738 warnings.

貢獻者指南

研究方向
將 `sphinx material/ init .py` 第74行的字串拼接替換為 `pathlib.Path` 或 `os.fspath`，以修復棄用警告。使用 `Path(app.outdir) / "sitemap.xml"`。
技術棧
python
領域
documentation
議題類型
文件
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
1
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1 小時以內
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
活躍
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
清晰
前置要求
PythonSphinxGit
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
80