prestodb/presto

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

开放

#22,475 创建于 2024年4月10日

在 GitHub 查看贡献者指南
 (6 条评论) (0 个反应) (0 位负责人)Java (5,240 个派生)batch import
beginner-taskbootcampcleanupdocsgood first issue

仓库指标

星标
 (15,558 个星标)
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