boostbook documentation is at serious risk of becoming impossible to use
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 20/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 停滞
- 技术栈
- java
调研方向
首先检查复制到 Ubuntu Bionic Docker 环境中的 BoostBook 设置脚本，以及列出的 docbook-xsl、docbook-xml 和 FOP 依赖项。确定是否可以用受支持的版本替换它们，或者是否需要其他文档系统；当文档构建不再依赖已确定的过时工具时，即视为完成。
由索引模型根据 Issue 内容生成。
描述
I would have opened an "issue" on the boostorg/boostbook project, however, that is not enabled.
I have been duplicating the boostbook setup scripts into the docker setup environment for Ubuntu Bionic and I have found that all of the packages that boostbook depends on are ancient.
| Package | Version | Last Modified | Host |
|---|---|---|---|
| docbook-xsl | 1.75.2 | 2009 | SourceForge |
| docbook-xml | 4.2 | 2002 | oasis-open.org |
| fop | 0.94 | 2007 | Apache |
These tools are quite old and it is only a matter of time before the older versions could be removed. These external sites are under no particular requirement to keep these older versions of software available. At some point some of these tools may no longer work with current operating system tools, for example fop says that it is for "JDK 1.4".
Each of these tools has a newer version. A project should be initiated to modernize the documentation build to use the latest versions of these tools, or switch to another documentation system perhaps (I saw a discussion on the mailing list).
- 主要语言
- 没有语言数据
- 星标
- 4
- 派生
- 6
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
boostorg/admin 的其他 Issue
相似的 Issue
-
needs-triage Platform(Default)
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
atlassian-labs/compiled#1960 ·
维护者通常 1 天内回复
-
Cached wheel reuse fails when the build and metadata fallback share an output directory可能已有人在做 @harbinresearcher 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
pypa/pyproject-hooks#240 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
enhancement
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 6 天内回复